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

Краткая информация

Создает листы из карты и упаковывает их в один пакет листов или несколько небольших пакетов листов.

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

Этот инструмент учитывает переменную среды Коэффициент параллельной обработки. Если параметр Создать несколько пакетов включен, параллельная обработка будет создавать содержание кэша при помощи нескольких процессов, чтобы использовать доступный ЦПУ и создавать пакеты листов по достижении порогового значения по умолчанию (ограничение размера 1 ГБ).
Используйте параметр Создать несколько пакетов, когда вы работаете с большими объемами данных. Если параметр отмечен, вместо одного большого пакета будет создано несколько небольших пакетов листов. Это позволяет создавать содержание листа больше 500 Гб в одном задании и публиковать его или выгружать и публиковать в ArcGIS Online как размещенный слой листов. Используя этот подход, вы можете сгенерировать содержимое больших листов в небольшие пакеты листов для публикации без разделения экстентов и уровней кэша на несколько заданий.

Если этот параметр включен, необходимо указать путь к пустой папке в файловой системе в параметре Выходная папка, чтобы сохранить выходные пакеты. Несколько пакетов можно создать, только если параметр Тип пакета задан как tpkx и переменная среды Коэффициент параллельной обработки не равна 0.
Если параметр Формат листов задан как PNG, инструмент автоматически применит допустимый формат (PNG8, PNG24 или PNG32) на основании значения, указанного для параметра Максимальный уровень детальности.
Для запуска инструмента входная карта должна включать описание и теги. Чтобы добавить описание и теги, щелкните правой кнопкой имя карты на панели Содержание и выберите Свойства. В диалоговом окне Свойства карты на вкладке Метаданные заполните текстовые поля Теги и Описание.

Подпись	Объяснение	Тип данных
Входная карта	Карта, на основе которой выполняется создание и упаковка листов.	Map
Пакет для ArcGIS Online \| Bing Maps \| Google Maps	Определяет, будет ли схема разбиения на листы создаваться из существующего картографического сервиса, или листы карты будут созданы для ArcGIS Online, Bing Maps и Google Maps. Отмечено–Будет использоваться схема разбиения на листы ArcGIS Online/Bing Maps/Google Maps. Это значение по умолчанию. Схема разбиения на листы ArcGIS Online/Bing Maps/Google Maps позволяет накладывать листы кэша на листы этих картографических онлайн-сервисов. ArcGIS Desktop содержит эту схему листов в виде встроенной возможности при загрузке схемы разбиения на листы. При выборе этой схемы листов исходная карта должна находиться в системе координат проекции WGS84 Web Mercator (Auxiliary Sphere). Использование схемы листов 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:1000. Для пакетирования всей континентальной части США в этом масштабе потребуется несколько недель и сотни гигабайт памяти. Если вы не готовы к упаковке на этом уровне масштаба, следует удалить этот уровень масштаба перед созданием пакета. Не отмечено–Используется схема листов из кэша существующего картографического сервиса. Необходимо задать картографический сервис в параметре Сервис. Выберите этот вариант, если ваша организация создала схему листов для существующего сервиса на сервере, и вы хотите сопоставить ее. Соответствие схем листов гарантирует, что наложение листов в вашем приложении Maps SDKs будет выполнено корректно. Если вы выберете эту опцию, используйте ту же систему координат для исходной карты, что и карта с импортируемой схемой листов.	Boolean
Выходной файл	Выходной путь и имя файла для пакета листов карты. Если параметр Создать несколько пакетов включен, этот параметр будет заменен параметром Выходная папка, чтобы указать, где будут создаваться пакеты листов.	File
Формат разбиения на листы	Указывает формат, который будет использоваться для созданных листов. PNG–Допустимый формат (PNG 8, PNG 24 или PNG 32) будет применен на основании указанного значения параметра Максимальный уровень детальности. Используется по умолчанию. PNG – 8 битовый–Будет использоваться формат PNG8. Используйте этот формат в тех сервисах, где требуется наложение с прозрачным фоном, например дороги и границы. Листы формата PNG8 занимают крайне мало пространства на диске без потери информации. Если на карте больше 256 цветов, не рекомендуется использовать PNG8. Снимки, отмывка, градиентная заливка, прозрачность и сглаживание могут использовать более 256 цветов на карте. Символы, в частности дорожные знаки, также могут иметь легкое сглаживание по краям, что увеличивает количество цветов карты. PNG – 24 битовый–Будет использоваться формат PNG24. Используйте этот формат для сервисов наложения, таких как дороги и границы, которые имеют более 256 цветов (если меньше 256 цветов, используйте PNG8). PNG – 32 битовый–Будет использоваться формат PNG32. Используйте этот формат для сервисов наложений, таких как отображение дорог и границ, в которых количество цветов превышает 256. PNG32 особенно хорошо использовать в сервисах наложения, где включено сглаживание линий или текста. PNG32 создает на диске файлы большего размера, чем PNG24. JPEG–Будет использоваться формат JPEG. Используйте этот формат для сервисов базовых карт с большим разбросом цветового диапазона, для которых не требуется прозрачного фона. Например, растровые изображения и подробные векторные базовые карты, как правило, хорошо работают с JPEG. Формат JPEG использует сжатие с потерями. При сжатии изображений, теряется та часть данных, которая не сказывается на общем виде изображения. Это может привести к очень маленьким размерам листов на диске, но если карта содержит векторные линии или надписи, это может привести к слишком большому шуму или размытым областям вокруг линий. Если это так, вы можете повысить значение сжатия, по умолчанию равное 75. Более высокое значение, такое как 90, может сбалансировать приемлемое качество линий и преимущества небольшого размера листов JPEG. Если вы готовы допустить незначительное количество шума на изображениях, вы можете сэкономить большой объем дискового пространства, используя JPEG. Меньший размер листов также сказывается на скорости загрузки листов в приложении. Смешанные–Формат JPEG будет использоваться в центре пакета, а формат PNG 32 по краям. Выбор смешанного режима оптимален в случае, когда требуется точное наложение растрового пакета на другие слои. При создании смешанного пакета листы формата PNG32 создаются там, где есть прозрачность (иными словами, там, где виден фон карты). Остальные листы создаются в формате JPEG. Это помогает уменьшить размер файлов в среднем, и, вместе с тем, обеспечить точное наложение на другие пакеты. Если в этом случае не использовать смешанный пакет, вокруг изображения будет виден непрозрачный "ободок" в местах перекрытия с другими пакетами.	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
Тип пакета (Дополнительный)	Задает тип создаваемого пакета листов. tpk–Будет создан `.tpk` файл. Листы будут храниться в формате Компактного хранилища. Этот формат поддерживается по всей платформе ArcGIS. tpkx–Будет создан файл `.tpkx`. Листы будут храниться в формате CompactV2, который обеспечивает лучшую производительность в сетевой и облачной среде. Используется по умолчанию.	String
Минимальный уровень детальности (Дополнительный)	Целочисленное представление, соответствующее количеству масштабов, используемых для определения схемы листов кэша. Это значение масштаба определяет уровень, при котором листы кэша становятся доступными и создаются в пакете листов. Возможные значения от 0 до 23. По умолчанию значение равно 0. Минимальное значение уровня детальности должно быть меньше или равно максимальному значению уровня детальности.	Long
Область интереса (Дополнительный)	Набор объектов, который ограничивает область создания листов. Используйте область интереса для создания листов для областей неправильной формы или составных объектов. Области, находящиеся за пределами прямоугольника, ограничивающего объекты области интереса, не будут кэшироваться. Если для этого параметра не задано значение, область интереса будет представлять собой полный экстент входной карты.	Feature Set
Создать несколько пакетов (Дополнительный)	Указывает, что будет создано: один большой пакет листов или несколько небольших пакетов листов. Этот параметр недоступен, если значение параметра среды Коэффициент параллельной обработки задано как 0, или если параметр Тип пакета задан как tpk. Отмечено–Будет создано несколько пакетов листов (размер каждого приблизительно 1 Гб) в местоположении, указанном в параметре Выходная папка. Не отмечено–Будет создан один пакет листов в местоположении, заданном в параметре Выходной файл. Используется по умолчанию.	Boolean
Выходная папка	Местоположение, в котором будет создано несколько пакетов листов. Если выходная папка не пуста, в выходной папке будет создана подпапка для хранения листов. В качестве имени папки будет использоваться автоматически созданный GUID. Если параметр Создать несколько пакетов не отмечен, этот параметр будет заменен параметром Выходной файл, позволяющим указать имя единственного создаваемого пакета листов.	Folder

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. `ONLINE`–Будет использоваться схема разбиения на листы ArcGIS Online/Bing Maps/Google Maps. Это значение по умолчанию. Схема разбиения на листы ArcGIS Online/Bing Maps/Google Maps позволяет накладывать листы кэша на листы этих картографических онлайн-сервисов. ArcGIS Desktop содержит эту схему листов в виде встроенной возможности при загрузке схемы разбиения на листы. При выборе этой схемы листов исходная карта должна находиться в системе координат проекции WGS84 Web Mercator (Auxiliary Sphere). Использование схемы листов 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:1000. Для пакетирования всей континентальной части США в этом масштабе потребуется несколько недель и сотни гигабайт памяти. Если вы не готовы к упаковке на этом уровне масштаба, следует удалить этот уровень масштаба перед созданием пакета. `EXISTING`–Используется схема листов из кэша существующего картографического сервиса. Необходимо задать картографический сервис в параметре `service_file`. Выберите этот вариант, если ваша организация создала схему листов для существующего сервиса на сервере, и вы хотите сопоставить ее. Соответствие схем листов гарантирует, что наложение листов в вашем приложении Maps SDKs будет выполнено корректно. Если вы выберете эту опцию, используйте ту же систему координат для исходной карты, что и карта с импортируемой схемой листов.	Boolean
output_file	Выходной путь и имя файла для пакета листов карты.	File
format_type	Указывает формат, который будет использоваться для созданных листов. `PNG`–Допустимый формат (PNG 8, PNG 24 или PNG 32) будет применен на основании указанного значения параметра Максимальный уровень детальности. Используется по умолчанию. `PNG8`–Будет использоваться формат PNG8. Используйте этот формат в тех сервисах, где требуется наложение с прозрачным фоном, например дороги и границы. Листы формата PNG8 занимают крайне мало пространства на диске без потери информации. Если на карте больше 256 цветов, не рекомендуется использовать PNG8. Снимки, отмывка, градиентная заливка, прозрачность и сглаживание могут использовать более 256 цветов на карте. Символы, в частности дорожные знаки, также могут иметь легкое сглаживание по краям, что увеличивает количество цветов карты. `PNG24`–Будет использоваться формат PNG24. Используйте этот формат для сервисов наложения, таких как дороги и границы, которые имеют более 256 цветов (если меньше 256 цветов, используйте PNG8). `PNG32`–Будет использоваться формат PNG32. Используйте этот формат для сервисов наложений, таких как отображение дорог и границ, в которых количество цветов превышает 256. PNG32 особенно хорошо использовать в сервисах наложения, где включено сглаживание линий или текста. PNG32 создает на диске файлы большего размера, чем PNG24. `JPEG`–Будет использоваться формат JPEG. Используйте этот формат для сервисов базовых карт с большим разбросом цветового диапазона, для которых не требуется прозрачного фона. Например, растровые изображения и подробные векторные базовые карты, как правило, хорошо работают с JPEG. Формат JPEG использует сжатие с потерями. При сжатии изображений, теряется та часть данных, которая не сказывается на общем виде изображения. Это может привести к очень маленьким размерам листов на диске, но если карта содержит векторные линии или надписи, это может привести к слишком большому шуму или размытым областям вокруг линий. Если это так, вы можете повысить значение сжатия, по умолчанию равное 75. Более высокое значение, такое как 90, может сбалансировать приемлемое качество линий и преимущества небольшого размера листов JPEG. Если вы готовы допустить незначительное количество шума на изображениях, вы можете сэкономить большой объем дискового пространства, используя JPEG. Меньший размер листов также сказывается на скорости загрузки листов в приложении. `MIXED`–Формат JPEG будет использоваться в центре пакета, а формат PNG 32 по краям. Выбор смешанного режима оптимален в случае, когда требуется точное наложение растрового пакета на другие слои. При создании смешанного пакета листы формата PNG32 создаются там, где есть прозрачность (иными словами, там, где виден фон карты). Остальные листы создаются в формате JPEG. Это помогает уменьшить размер файлов в среднем, и, вместе с тем, обеспечить точное наложение на другие пакеты. Если в этом случае не использовать смешанный пакет, вокруг изображения будет виден непрозрачный "ободок" в местах перекрытия с другими пакетами.	String
level_of_detail	Целочисленное представление, соответствующее количеству масштабов, используемых для определения схемы листов кэша. Это значение масштаба определяет максимальный уровень, до которого будут создаваться листы кэша в пакете листов. Большие значения соответствуют более крупным масштабам, которые показывают данные более детально, но требуют больше места для хранения. Меньшие значения соответствуют меньшим масштабам, которые менее детальны, но требуют незначительных объемов для хранения. Возможные значения от 1 до 23. Значение по умолчанию равно 1. Максимальное значение уровня детализации должно быть больше минимального значения уровня детализации.	Long
service_file (Дополнительный)	Имя картографического сервиса или файлов `.xml`, которые будут использоваться для схемы листов. Этот параметр требуется, только если для параметра `service_type` задано `EXISTING`.	Map Server; File
summary (Дополнительный)	Краткая информация, которая будет добавлена в свойства пакета.	String
tags (Дополнительный)	Информация тегов, которая будет добавлена в свойства пакета. Можно добавить несколько тегов с разделением запятой или точкой с запятой.	String
extent (Дополнительный)	Указывает экстент, который будет использован для выбора или вырезания объектов. `MAXOF` – Будет использоваться максимальный экстент всех входных данных. `MINOF` – Будет использоваться минимальная область, которая является общей для всех входных данных. `DISPLAY` — Экстент равен видимому отображению. Имя слоя — Будет использоваться экстент указанного слоя. `Extent` Объект — будет использоваться экстент указанного объекта. Строка координат, разделенная пробелами – Будет использоваться экстент указанной строки. Координаты выражаются в порядке x-мин, y-мин, x-макс, y-макс.	Extent
compression_quality (Дополнительный)	Значение качества сжатия JPEG в диапазоне от 1 до 100. Значение по умолчанию составляет 75 для формата листов JPEG плитки и ноль для других форматов. Сжатие поддерживается только для JPEG и смешанных форматов. Более высокое значение приведет к увеличению размера файла и более высокому качеству изображения. Более низкое значение приведет к уменьшению размера файла и низкому качеству изображения.	Long
package_type (Дополнительный)	Задает тип создаваемого пакета листов. `tpk`–Будет создан `.tpk` файл. Листы будут храниться в формате Компактного хранилища. Этот формат поддерживается по всей платформе ArcGIS. `tpkx`–Будет создан файл `.tpkx`. Листы будут храниться в формате CompactV2, который обеспечивает лучшую производительность в сетевой и облачной среде. Используется по умолчанию.	String
min_level_of_detail (Дополнительный)	Целочисленное представление, соответствующее количеству масштабов, используемых для определения схемы листов кэша. Это значение масштаба определяет уровень, при котором листы кэша становятся доступными и создаются в пакете листов. Возможные значения от 0 до 23. По умолчанию значение равно 0. Минимальное значение уровня детальности должно быть меньше или равно максимальному значению уровня детальности.	Long
area_of_interest (Дополнительный)	Набор объектов, который ограничивает область создания листов. Используйте область интереса для создания листов для областей неправильной формы или составных объектов. Области, находящиеся за пределами прямоугольника, ограничивающего объекты области интереса, не будут кэшироваться. Если для этого параметра не задано значение, область интереса будет представлять собой полный экстент входной карты.	Feature Set
create_multiple_packages (Дополнительный)	Указывает, что будет создано: один большой пакет листов или несколько небольших пакетов листов. Этот параметр недоступен, если значение параметра среды Коэффициент параллельной обработки задано как 0, или если параметр `package_type` задан как `tpk`. `CREATE_MULTIPLE_PACKAGES`–Будет создано несколько пакетов листов (размер каждого приблизительно 1 Гб) в местоположении, указанном в параметре `output_folder`. `CREATE_SINGLE_PACKAGE`–Будет создан один пакет листов в местоположении, заданном в параметре `output_file`. Используется по умолчанию.	Boolean
output_folder	Выходная папка, где будет создано несколько пакетов листов. Если выходная папка не пуста, в выходной папке будет создана подпапка для хранения листов. В качестве имени папки будет использоваться автоматически созданный GUID.	Folder

Пример кода

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

В следующем скрипте 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")

CreateMapTilePackage, пример 2 (автономный скрипт)

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

# 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)

CreateMapTilePackage, пример 3 (автономный скрипт)

Создает несколько пакетов листов для карты.

# 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 )

Параметры среды

Текущая рабочая область, Коэффициент параллельной обработки

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