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

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

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

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

  • Этот инструмент учитывает переменную среды Коэффициент параллельной обработки. Если параметр Создать несколько пакетов включен, параллельная обработка будет создавать содержание кэша при помощи нескольких процессов, чтобы использовать доступный ЦПУ и создавать пакеты листов по достижении порогового значения по умолчанию (ограничение размера 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:1 000. Для создания пакета данных по всей континентальной части США в этом масштабе потребуется несколько недель и сотни гигабайт памяти. Если вы не готовы к упаковке на этом уровне масштаба, следует удалить этот уровень масштаба перед созданием пакета.

  • Не отмечено – используется схема листов из кэша существующего картографического сервиса.

    Выберите этот вариант, если ваша организация создала схему листов для существующего сервиса на сервере, и вы хотите сопоставить ее. Соответствие схем листов гарантирует, что наложение листов в вашем приложении Maps SDKs будет производиться корректно.

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

Boolean
Выходной файл

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

File
Формат разбиения на листы

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

  • PNGДопустимый формат (PNG 8, PNG 24 или PNG 32) будет применен на основании указанного значения параметра Максимальный уровень детальности. Это значение по умолчанию
  • PNG – 8 битовыйБудет использоваться формат PNG8. Используйте этот формат в тех сервисах, где требуется наложение с прозрачным фоном, например дороги и границы. Листы формата PNG8 занимают крайне мало пространства на диске без потери информации.Не используйте PNG8, если карта содержит более 256 цветов. Снимки, отмывка, градиентная заливка, прозрачность и сглаживание могут использовать более 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, который обеспечивает лучшую производительность в сетевой и облачной среде. Этот тип структуры пакета поддерживается более новыми версиями продуктов ArcGIS, такими как ArcGIS Online 7.1, ArcGIS Enterprise 10.7 и ArcGIS Runtime 100.5. Это значение по умолчанию
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.

  • EXISTINGИспользуется схема листов из кэша существующего картографического сервиса. Необходимо задать картографический сервис в параметре service_file.Выберите этот вариант, если ваша организация создала схему листов для существующего сервиса на сервере, и вы хотите сопоставить ее. Соответствие схем листов гарантирует, что наложение листов в вашем приложении Maps SDKs будет производиться корректно.Если вы выберете эту опцию, используйте ту же систему координат для исходной карты, что и карта с импортируемой схемой листов.
  • 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:1 000. Для создания пакета данных по всей континентальной части США в этом масштабе потребуется несколько недель и сотни гигабайт памяти. Если вы не готовы к упаковке на этом уровне масштаба, следует удалить этот уровень масштаба перед созданием пакета.
Boolean
output_file

Выходной путь и имя файла для пакета листов карты.

File
format_type

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

  • PNGДопустимый формат (PNG 8, PNG 24 или PNG 32) будет применен на основании указанного значения параметра Максимальный уровень детальности. Это значение по умолчанию
  • PNG8Будет использоваться формат PNG8. Используйте этот формат в тех сервисах, где требуется наложение с прозрачным фоном, например дороги и границы. Листы формата PNG8 занимают крайне мало пространства на диске без потери информации.Не используйте PNG8, если карта содержит более 256 цветов. Снимки, отмывка, градиентная заливка, прозрачность и сглаживание могут использовать более 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, который обеспечивает лучшую производительность в сетевой и облачной среде. Этот тип структуры пакета поддерживается более новыми версиями продуктов ArcGIS, такими как ArcGIS Online 7.1, ArcGIS Enterprise 10.7 и ArcGIS Runtime 100.5. Это значение по умолчанию
String
min_level_of_detail
(Дополнительный)

Целочисленное представление, соответствующее количеству масштабов, используемых для определения схемы листов кэша. Это значение масштаба определяет уровень, при котором листы кэша становятся доступными и создаются в пакете листов. Возможные значения от 0 до 23. По умолчанию значение равно 0. Минимальное значение уровня детализации должно быть меньше или равно максимальному значению уровня детализации.

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

Набор объектов, который ограничивает область создания листов. Используйте область интереса для создания листов для областей неправильной формы или составных объектов. Области, находящиеся за пределами прямоугольника, ограничивающего объекты области интереса, не будут кэшироваться. Если для этого параметра не задано значение, область интереса будет представлять собой полный экстент входной карты.

Feature Set
create_multiple_packages
(Дополнительный)

Указывает, что будет создано: один большой пакет листов или несколько небольших пакетов листов. Этот параметр недоступен, если переменная среды parallelProcessingFactor задана как 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 )

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

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

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