Создать пакет листов карты (Управление данными)

Сводка

Создает листы из карты или базовой карты и упаковывает их для создания одного сжатого файла .tpk.

Использование

  • Входная карта должна содержать описание и теги, чтобы инструмент сработал. Чтобы добавить теги и описание, щелкните правой кнопкой на имени карты на панели Содержание и выберите Свойства, затем перейдите на вкладку Описание.

  • Если для параметра Формат листов выбрано значение PNG, инструмент автоматически выбирает корректный формат (PNG8, PNG24 или PNG32) в зависимости от заданного Уровня отображения.

  • Инструмент учитывает параметр среды Коэффициент параллельной обработки. Если параметры среды не заданы (по умолчанию), или задано значение, равное 100, полная параллельная обработка будет включена, и инструмент будет пытаться распространить выполнение на все логические ядра компьютера. Установка параметры среды равным 0 отключит параллельную обработку. Присвоение коэффициенту значения от 1 до 99 приведет к тому, что инструмент определит процент логических ядер для использования по формуле, округлив результат до ближайшего целого значения.

    Parallel Processing Factor / 100 * Logical Cores
    .

    Если результат равен 0 или 1, параллельная обработка не будет включена.

Синтаксис

arcpy.management.CreateMapTilePackage(in_map, service_type, output_file, format_type, level_of_detail, {service_file}, {summary}, {tags}, {extent}, {compression_quality}, {package_type}, {min_level_of_detail})
ParameterОбъяснениеТип данных
in_map

Карта, на основе которой выполняется создание и упаковка листов.

Map
service_type

Определяет, будет ли схема разбиения на листы создаваться из существующего картографического сервиса, или листы карты будут созданы для ArcGIS Online, Bing Maps и Google Maps.

  • EXISTINGИспользуется схема листов из кэша существующего картографического сервиса. Необходимо задать картографический сервис в параметре service_file.Данная опция позволяет привести схему листов в соответствие с уже существующей схемой листов на другом сервисе сервера. Соответствие схем листов гарантирует, что наложение листов в веб-приложениях в приложении ArcGIS Runtime другими способами будут производиться корректно.Если вы выберете этот параметр, используйте ту же систему координат для исходного карты, что и для карты со схемой листов, которую вы импортируете.
  • ONLINEБудет использоваться схема разбиения на листы ArcGIS Online/Bing Maps/Google Maps. Это значение по умолчанию.Схема листов ArcGIS Online/Bing Maps/Google Maps позволяет производить наложение ваших листов кэша на листы этих картографических онлайн-сервисов. ArcGIS Desktop содержит эту схему листов в виде встроенного параметра при загрузке схемы разбиения на листы. При выборе этой схемы листов для исходной карты должна использоваться система координат проекции WGS 1984 Web Mercator.Использование схемы листов ArcGIS Online/Bing Maps/Google Maps обязательно, если планируется наложение пакетов вместе с картами ArcGIS Online, Bing Maps или Google Maps. Одним из преимуществ выбора схемы листов ArcGIS Online/Bing Maps/Google Maps является то, что она широко известна в кругах веб-картографирования. Поэтому такие листы будут соответствовать листам других организаций, использующих эту схему. Даже если вы не планируете наложение любого из этих картографических сервисов, данная схема листов будет хорошим выбором за счет своей потенциальной совместимости.Однако схема листов ArcGIS Online/Google Maps/Bing Maps может содержать слишком крупные масштабы, которые для некоторых карт будут лишними. Упаковка крупных масштабов может занять много времени и большой объем памяти диска. Например, пусть самый крупный масштаб схемы листов равен 1:1 000. Для создания пакета данных по всей континентальной части США в этом масштабе потребуется несколько недель и сотни гигабайт памяти. Если пакетирование в таких масштабах невыгодно, следует удалить этот уровень масштаба перед созданием пакета.
Boolean
output_file

Выходной пакет листов карты.

File
format_type

Задает формат созданных листов.

  • PNGДля автоматического выбора корректного формата (PNG 8, PNG 24 или PNG 32) в зависимости от заданного параметра Уровень детализации, используйте значение PNG. Это значение по умолчанию.
  • PNG8Используйте PNG 8 в тех сервисах, где требуется наложение с прозрачным фоном, например дороги и границы. Листы формата PNG8 занимают крайне мало пространства на диске без потери информации. Не используйте PNG 8, если карта содержит более 256 цветов. Наличие изображений, отмывки, градиентной заливки, прозрачности и сглаживания легко могут поднять количество цветов карты выше 256. Символы, в частности дорожные знаки, также могут иметь легкое сглаживание по краям, что увеличивает количество цветов карты.
  • PNG24Используйте PNG 24 в тех сервисах, где требуется наложение с прозрачным фоном (дороги, границы) и где количество цветов карты превышает 256 (если цветов меньше 256, выберите PNG 8).
  • PNG32Используйте PNG 32 для сервисов наложения, например, границ и дорог, где количество цветов превышает 256. Формат PNG32 особенно хорошо использовать в тех сервисах, где включено сглаживание линий или текста. PNG 32 создает листы большего размера на диске, чем PNG 24.
  • JPEGИспользуйте этот формат для сервисов базовых карт с большим разбросом цветового диапазона, для которых не требуется прозрачного фона. Например, JPEG, скорее всего, будет хорошим выбором для растровых изображений или очень подробных векторных базовых карт. Формат JPEG использует сжатие с потерями. При сжатии изображений, теряется та часть данных, которая не сказывается на общем виде изображения. Таким образом, размер листов на диске может быть очень мал, но при наличии на карте векторных линий или подписей такое сжатие может вызвать помехи изображения и размытие контуров линий. Если это так, попробуйте повысить значение сжатия, по умолчанию равное 75. Более высокое значение, такое как 90, может сбалансировать приемлемое качество линий и преимуществами небольшого размера листов JPEG.Решение о том, какое качество изображения считать приемлемым, остается за пользователем. Формат JPEG может сэкономить большой объем дискового пространства, если пользователь готов считаться с небольшими помехами в изображениях. Меньший размер листов также сказывается на скорости загрузки листов в приложении.
  • MIXEDСмешанный пакет использует формат JPEG в центре пакета и формат PNG 32 по краям. Выбор смешанного режима оптимален в случае, когда требуется точное наложение растрового пакета на другие слои.При создании смешанного пакета листы формата PNG32 создаются там, где присутствует прозрачность (иными словами, там, где виден фон карты). Остальные листы создаются в формате JPEG. Это помогает уменьшить размер файлов в среднем, и, вместе с тем, обеспечить точное наложение на другие пакеты. Если в этом случае обойтись без смешанного пакета, то вокруг изображения будет виден непрозрачный "ободок" в местах перекрытия с другими пакетами.
String
level_of_detail

Максимальный масштаб, в котором будут созданы листы для пакета. Значение по умолчанию равно 1. Возможные значения: 1 – 24.

Большие значения соответствуют более крупным масштабам, которые показывают больше деталей, но требуют больше свободного места для их хранения, а меньшие - мелким масштабам, менее детальным, но требующим незначительных объемов для хранения.

Это значение должно быть больше или равно min_level_of_detail.

Long
service_file
(Дополнительный)

Задает имя картографического сервиса или XML-файлов, которые будут использоваться в схеме разбиения на листы. Этот параметр требуется, только если указано для параметра service_type указано EXISTING.

MapServer; File
summary
(Дополнительный)

Добавление краткого описания в свойства пакета.

String
tags
(Дополнительный)

Добавление информации о тегах в свойства пакета. Можно добавить несколько тегов с разделением запятой или точкой с запятой.

String
extent
(Дополнительный)

Указывает экстент, который будет использован для выбора или вырезания объектов.

  • MAXOF - будет использоваться максимальный экстент всех входных данных.
  • MINOF - будет использоваться минимальная область, общая для всех входных данных.
  • DISPLAY– экстент будет равен видимому отображению.
  • Имя слоя - будет использоваться тот же экстент, что и в указанном слое.
  • Объект Extent - будет использоваться тот же экстент, что и в указанном объекте.
  • Строка координат, разделенных пробелами – будет использоваться экстент из заданной строки. Координаты должны быть выражены в таком порядке: x-min, y-min, x-max, y-max.
Extent
compression_quality
(Дополнительный)

Значение от 1 до 100 для качества сжатия JPEG. Значение по умолчанию – 75 для формата листов JPEG и 0 для других форматов.

Сжатие поддерживается только для формата JPEG и MIXED. Если вы выбираете высокое значение, это приведет к увеличению размера файла и более высокому качеству изображения. Если вы выбираете низкое значение, это приведет к уменьшению размера файла и низкому качеству изображения.

Long
package_type
(Дополнительный)

Задает тип создаваемого пакета листов.

  • tpkЛисты хранятся в формате Компактное хранение. Он поддерживается по всей платформе ArcGIS.
  • tpkxЛисты хранятся в формате CompactV2, который обеспечивает лучшую производительность в сетевой и облачной среде. Это улучшает и упрощает структуру пакета, поддерживаемого новыми версиями ПО ArcGIS, такими как ArcGIS Online 7.1, ArcGIS Enterprise 10.7 и ArcGIS Runtime 100.5. Это значение по умолчанию.
String
min_level_of_detail
(Дополнительный)

Минимальный масштаб, в котором будут созданы листы для пакета. Значение по умолчанию равно 1. Возможные значения: 1 – 24.

Большие значения соответствуют более крупным масштабам, которые показывают больше деталей, но требуют больше свободного места для их хранения, а меньшие - мелким масштабам, менее детальным, но требующим незначительных объемов для хранения.

Это значение должно быть меньше или равно level_of_detail.

Long

Пример кода

CreateMapTilePackage, пример 1 (окно Python)

Пример скрипта Python для использования инструмента CreateMapTilePackage в окне Python.

import arcpy
arcpy.env.workspace = "C:/TilePackageExample" 
arcpy.CreateMapTilePackage_management("World Soils", "ONLINE", "Example.tpk", "PNG8", "10")
CreateMapTilePackage, пример 2 (автономный скрипт)

Находит и создает пакеты листов карты для всех документов карты, которые находятся в указанной папке.

# Name: CreateMapTilePackage.py
# Description: Find all the maps in the project and
#   create a map tile package for each map
# import system modules
import os
import arcpy
# Set environment settings
arcpy.env.overwriteOutput = True
arcpy.env.workspace = "C:/Tilepackages" 
# Loop through the project, find all the maps, and
#   create a map tile package for each map,
#   using the same name as the map
p = arcpy.mp.ArcGISProject("c:\\temp\\myproject.aprx")
for m in p.listMaps():
    print("Packaging " + m.name)
    arcpy.CreateMapTilePackage_management(m, "ONLINE", "{}.tpk".format(m.name), 
                                          "PNG8", "10")

Информация о лицензиях

  • Basic: Да
  • Standard: Да
  • Advanced: Да

Связанные разделы