Подпись | Описание | Тип данных |
Входная карта | Карта, на основе которой выполняется создание и упаковка листов. | Map |
Пакет для ArcGIS Online | Bing Maps | Google Maps | Определяет, будет ли схема разбиения на листы создаваться из существующего картографического сервиса, или листы карты будут созданы для ArcGIS Online, Bing Maps и Google Maps.
| Boolean |
Выходной файл | Выходной путь и имя файла для пакета листов карты. Если параметр Создать несколько пакетов включен, этот параметр будет заменен параметром Выходная папка, чтобы указать, где будут создаваться пакеты листов. | File |
Формат разбиения на листы | Указывает формат, который будет использоваться для созданных листов.
| String |
Максимальный уровень детальности | Целочисленное представление, соответствующее количеству масштабов, используемых для определения схемы листов кэша. Это значение масштаба определяет максимальный уровень, до которого будут создаваться листы кэша в пакете листов. Большие значения соответствуют более крупным масштабам, которые показывают данные более детально, но требуют больше места для хранения. Меньшие значения соответствуют меньшим масштабам, которые менее детальны, но требуют незначительных объемов для хранения. Возможные значения от 1 до 23. Значение по умолчанию равно 1. Максимальное значение уровня детализации должно быть больше минимального значения уровня детализации. | Long |
Сервис (Дополнительный) | Имя картографического сервиса или файлов .xml, которые будут использоваться для схемы листов. Этот параметр является обязательным только в том случае, если параметр Пакет ArcGIS Online | Bing Maps | Google Maps отключен. | Map Server; File |
Краткая информация (Дополнительный) | Краткая информация, которая будет добавлена в свойства пакета. | String |
Теги (Дополнительный) | Информация тегов, которая будет добавлена в свойства пакета. Можно добавить несколько тегов с разделением запятой или точкой с запятой. | String |
Экстент (Дополнительный) | Указывает экстент, который будет использован для выбора или вырезания объектов.
| Extent |
Качество сжатия (Дополнительный) | Значение качества сжатия JPEG в диапазоне от 1 до 100. Значение по умолчанию составляет 75 для формата листов JPEG плитки и ноль для других форматов. Сжатие поддерживается только для JPEG и смешанных форматов. Если вы выбираете высокое значение, это приведет к увеличению размера файла и более высокому качеству изображения. Если вы выбираете низкое значение, это приведет к уменьшению размера файла и низкому качеству изображения. | Long |
Тип пакета (Дополнительный) | Задает тип создаваемого пакета листов.
| String |
Минимальный уровень детальности (Дополнительный) | Целочисленное представление, соответствующее количеству масштабов, используемых для определения схемы листов кэша. Это значение масштаба определяет уровень, при котором листы кэша становятся доступными и создаются в пакете листов. Возможные значения от 0 до 23. По умолчанию значение равно 0. Минимальное значение уровня детализации должно быть меньше или равно максимальному значению уровня детализации. | Long |
Область интереса (Дополнительный) | Набор объектов, который ограничивает область создания листов. Используйте область интереса для создания листов для областей неправильной формы или составных объектов. Области, находящиеся за пределами прямоугольника, ограничивающего объекты области интереса, не будут кэшироваться. Если для этого параметра не задано значение, область интереса будет представлять собой полный экстент входной карты. | Feature Set |
Создать несколько пакетов (Дополнительный) | Указывает, что будет создано: один большой пакет листов или несколько небольших пакетов листов. Этот параметр недоступен, если переменная среды Коэффициент параллельной обработки задана как 0, или если параметр Тип пакета задан как tpk.
| Boolean |
Выходная папка | Местоположение, где будет создано несколько пакетов листов. Если выходная папка не пуста, в выходной папке будет создана подпапка для хранения листов. В качестве имени папки будет использоваться автоматически созданный GUID. Если параметр Создать несколько пакетов не отмечен, этот параметр будет заменен параметром Выходной файл, чтобы указать имя единственного создаваемого пакета листов. | Folder |
Краткая информация
Создает листы из карты и упаковывает их в один пакет листов или несколько небольших пакетов листов.
Использование
Этот инструмент учитывает переменную среды Коэффициент параллельной обработки. Если параметр Создать несколько пакетов включен, параллельная обработка будет создавать содержание кэша при помощи нескольких процессов, чтобы использовать доступный ЦПУ и создавать пакеты листов по достижении порогового значения по умолчанию (ограничение размера 1 ГБ).
Используйте параметр Создать несколько пакетов, когда вы работаете с большими объемами данных. Если параметр отмечен, вместо одного большого пакета будет создано несколько небольших пакетов листов. Это позволяет создавать содержание листа больше 500 Гб в одном задании и публиковать его или выгружать и публиковать на ArcGIS Online как размещенный слой листов. Используя этот подход, вы можете сгенерировать содержимое больших листов в небольшие пакеты листов для публикации без разделения экстентов и уровней кэша на несколько заданий.
Если этот параметр включен, необходимо указать путь к пустой папке в файловой системе в параметре Выходная папка, чтобы сохранить выходные пакеты. Несколько пакетов можно создать, только если параметр Тип пакета задан как tpkx и переменная среды Коэффициент параллельной обработки не установлена как 0.
Если параметр Формат листов задан как PNG, инструмент автоматически применит допустимый формат (PNG8, PNG24 или PNG32) на основании значения, указанного для параметра Максимальный уровень детальности.
Для запуска инструмента входная карта должна включать описание и теги. Чтобы добавить описание и теги, щелкните правой кнопкой имя карты на панели Содержание и выберите Свойства. В диалоговом окне Свойства карты на вкладке Метаданные заполните текстовые поля Теги и Описание.
Параметры
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}, {area_of_interest}, {create_multiple_packages}, output_folder)
Имя | Описание | Тип данных |
in_map | Карта, на основе которой выполняется создание и упаковка листов. | Map |
service_type | Определяет, будет ли схема разбиения на листы создаваться из существующего картографического сервиса, или листы карты будут созданы для ArcGIS Online, Bing Maps и Google Maps.
| Boolean |
output_file | Выходной путь и имя файла для пакета листов карты. | File |
format_type | Указывает формат, который будет использоваться для созданных листов.
| String |
level_of_detail | Целочисленное представление, соответствующее количеству масштабов, используемых для определения схемы листов кэша. Это значение масштаба определяет максимальный уровень, до которого будут создаваться листы кэша в пакете листов. Большие значения соответствуют более крупным масштабам, которые показывают данные более детально, но требуют больше места для хранения. Меньшие значения соответствуют меньшим масштабам, которые менее детальны, но требуют незначительных объемов для хранения. Возможные значения от 1 до 23. Значение по умолчанию равно 1. Максимальное значение уровня детализации должно быть больше минимального значения уровня детализации. | Long |
service_file (Дополнительный) | Имя картографического сервиса или файлов .xml, которые будут использоваться для схемы листов. Этот параметр требуется, только если для параметра service_type задано EXISTING. | Map Server; File |
summary (Дополнительный) | Краткая информация, которая будет добавлена в свойства пакета. | String |
tags (Дополнительный) | Информация тегов, которая будет добавлена в свойства пакета. Можно добавить несколько тегов с разделением запятой или точкой с запятой. | String |
extent (Дополнительный) | Указывает экстент, который будет использован для выбора или вырезания объектов.
| Extent |
compression_quality (Дополнительный) | Значение качества сжатия JPEG в диапазоне от 1 до 100. Значение по умолчанию составляет 75 для формата листов JPEG плитки и ноль для других форматов. Сжатие поддерживается только для JPEG и смешанных форматов. Если вы выбираете высокое значение, это приведет к увеличению размера файла и более высокому качеству изображения. Если вы выбираете низкое значение, это приведет к уменьшению размера файла и низкому качеству изображения. | Long |
package_type (Дополнительный) | Задает тип создаваемого пакета листов.
| String |
min_level_of_detail (Дополнительный) | Целочисленное представление, соответствующее количеству масштабов, используемых для определения схемы листов кэша. Это значение масштаба определяет уровень, при котором листы кэша становятся доступными и создаются в пакете листов. Возможные значения от 0 до 23. По умолчанию значение равно 0. Минимальное значение уровня детализации должно быть меньше или равно максимальному значению уровня детализации. | Long |
area_of_interest (Дополнительный) | Набор объектов, который ограничивает область создания листов. Используйте область интереса для создания листов для областей неправильной формы или составных объектов. Области, находящиеся за пределами прямоугольника, ограничивающего объекты области интереса, не будут кэшироваться. Если для этого параметра не задано значение, область интереса будет представлять собой полный экстент входной карты. | Feature Set |
create_multiple_packages (Дополнительный) | Указывает, что будет создано: один большой пакет листов или несколько небольших пакетов листов. Этот параметр недоступен, если переменная среды parallelProcessingFactor задана как 0, или если параметр package_type задан как tpk.
| Boolean |
output_folder | Выходная папка, где будет создано несколько пакетов листов. Если выходная папка не пуста, в выходной папке будет создана подпапка для хранения листов. В качестве имени папки будет использоваться автоматически созданный GUID. | Folder |
Пример кода
В следующем скрипте Python показано применение функции CreateMapTilePackage в окне Python.
import arcpy
arcpy.env.workspace = r"C:\Data\MinMaxLOD\states73K"
aprx = arcpy.mp.ArcGISProject(r"C:\Data\MinMaxLOD\states73K\states73K_1.aprx")
map1 = aprx.listMaps()[0]
arcpy.management.CreateMapTilePackage(map1, "ONLINE", "Example.tpkx", "PNG", "5")
Находит все карты в проекте и создает отдельный пакет листов карты для каждой из карт.
# Name: CreateMapTilePackage.py
# Description: Find all the maps in the project and
# create a single map tile package for each map
# import system modules
import os
import arcpy
# Set environment settings
arcpy.env.overwriteOutput = True
arcpy.env.workspace = r"C:\Data\MinMaxLOD\states73K"
# Loop through the project, find all the maps, and
# create a single map tile package for each map,
# using the same name as the map
p = arcpy.mp.ArcGISProject("c:\\temp\\myproject.aprx")
extent = ""
aoi = ""
for m in p.listMaps():
print("Packaging " + m.name)
arcpy.management.CreateMapTilePackage(m, "ONLINE", "{}.tpkx".format(m.name),
"PNG", 9, None, "MapSummary", "MapTag", extent, "", "tpkx", 5, aoi)
Создает несколько пакетов листов карты для заданной карты.
# Name: CreateMapTilePackage.py
# Description: Create multiple map tile packages for a given map
# import system modules
import os
import arcpy
# Set environment settings
arcpy.env.overwriteOutput = True
arcpy.env.workspace = r"C:\Data\MinMaxLOD\states73K"
# Create multiple map tile packages for given map,
aprx = arcpy.mp.ArcGISProject("c:\\temp\\myproject.aprx")
map1 = aprx.listMaps()[0]
extent = ""
aoi = ""
createMultiplePackages = "create_multiple_packages"
outputFolder = r"C:\11\multi"
arcpy.management.CreateMapTilePackage(map1, "ONLINE", "", "PNG", 9, None, "MapSummary", "MapTag",
extent, "", "tpkx", 5, aoi,createMultiplePackages, outputFolder )