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

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

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

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

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

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

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

    Коэффициент параллельной обработки / 100 * логических ядер

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

Параметры

ПодписьОписаниеТип данных
Входная карта

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

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 содержит эту схему листов в виде встроенного параметра при загрузке схемы разбиения на листы. При выборе этой схемы листов исходная карта должна находиться в системе координат проекции WGS 1984 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. Для создания пакета данных по всей континентальной части США в этом масштабе потребуется несколько недель и сотни гигабайт памяти. Если вы не готовы к упаковке на этом уровне масштаба, следует удалить этот уровень масштаба перед созданием пакета.

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

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

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

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

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

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

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

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

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

Long
Область интереса
(Дополнительный)

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

Feature Set

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})
ИмяОписаниеТип данных
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 (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 занимают крайне мало пространства на диске без потери информации.Не используйте PNG 8, если карта содержит более 256 цветов. Изображение, отмывка, градиентная заливка, прозрачность и сглаживание могут легко использовать более 256 цветов на карте. Символы, в частности дорожные знаки, также могут иметь легкое сглаживание по краям, что увеличивает количество цветов карты.
  • PNG24Будет использоваться формат PNG24. Используйте этот формат в тех сервисах, где требуется наложение с прозрачным фоном (дороги, границы) и где количество цветов карты превышает 256 (если цветов меньше 256, выберите PNG 8).
  • PNG32Будет использоваться формат PNG32. Используйте этот формат для сервисов наложений, таких как отображение дорог и границ, в которых количество цветов превышает 256. Формат PNG32 хорошо использовать в тех сервисах, где включено сглаживание линий или текста. PNG 32 создает листы большего размера на диске, чем PNG 24.
  • 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-min, y-min, x-max, y-max.
Extent
compression_quality
(Дополнительный)

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

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

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
(Дополнительный)

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

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

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

Feature Set

Пример кода

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

В следующем скрипте Python показано применение функции CreateMapTilePackage в окне Python.

import arcpy
arcpy.env.workspace = "C:/TilePackageExample" 
arcpy.management.CreateMapTilePackage("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.management.CreateMapTilePackage(m, "ONLINE", "{}.tpk".format(m.name), 
                                          "PNG8", "10")

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

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

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