Экспортировать кэш картографического сервиса (Сервер)—ArcGIS Pro

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

Экспортирует листы из кэша слоя изображения карты в качестве набора данных кэша или в виде пакета листов в папку на диске. Листы могут быть импортированы в другие кэши, или они могут быть доступны в ArcGIS Desktop, или с мобильных устройств как набор растровых данных, независимо от родительского сервиса.

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

Перед запуском инструмента создайте папку на диске, в которой будут храниться экспортированные листы.
Учетная запись ArcGIS Server должна иметь право на запись в целевую папку кэша. Если учетной записи ArcGIS Server не может быть предоставлен доступ на запись в целевую папку кэша, но у клиента ArcGIS Pro такой доступ есть, выберите параметр Копировать данные с сервера.
Параметр Перезаписать листы позволяет полностью перезаписать экспортируемыми листами листы в кэше назначения, вместо смешения изображений. Экспортируемые листы по-прежнему могут быть ограничены областью интереса.

Параметры

Подпись	Описание	Тип данных
Входной сервис	Слой изображения карты с полистным кэшем для экспорта. Его можно выбрать, указав нужный сервис на портале или перетащив веб-слой листов с вкладки Портал на панели Проект, чтобы задать этот параметр.	Image Service; Map Server
Путь целевого кэша	Папка, в которую будет экспортирован кэш. Эта папка не обязательно должна быть зарегистрированной директорией кэша сервера. Учетная запись ArcGIS Server должна иметь право на запись в целевую папку кэша. Если учетной записи сервера не может быть предоставлен доступ на запись в папку назначения, но у клиента ArcGIS Desktop или ArcGIS Pro такой доступ есть, то выберите параметр Копировать данные с сервера.	Folder
Экспортировать тип кэша	Определяет тип кэша, который будет экспортирован. Пакеты листов подходят для использования с ArcGIS Maps SDKs for Native Apps. Набор данных кэша—Будет экспортирован кэш картографического сервиса или сервиса изображений, созданный с применением ArcGIS Server Может использоваться в ArcGIS Desktop и сервисами карт и изображений ArcGIS Server. Это значение по умолчанию Пакет листов—Будет импортирован один сжатый файл, в котором набор данных кэша добавлен в виде слоя и объединен для совместного использования. Его можно использовать в ArcGIS Pro и с ArcGIS Maps SDKs for Native Apps.	String
Копировать данные с сервера	Определяет, как листы будут перемещены в целевую папку. Отметьте этот параметр, только если учетной записи ArcGIS Server не может быть предоставлен доступ на запись в целевую папку, а у клиента ArcGIS Desktop или ArcGIS Pro такой доступ есть. Программное обеспечение экспортирует листы в выходную директорию сервера, прежде чем переместить их в целевую папку. Отмечено – листы помещаются в выходную директорию сервера, а затем перемещаются в целевую папку. Клиент ArcGIS Desktop должен иметь право на запись в целевую папку. Не отмечено – листы экспортируются непосредственно в целевую папку. Учетная запись ArcGIS Server должна иметь право на запись в целевую папку.	Boolean
Тип формата хранения	Определяет формат хранения, который будет использоваться для экспортируемого кэша. Уплотнить—Листы группируются в пакетные файлы для экономии места на диске и ускорения копирования кэша. Если параметр Тип кэша экспорта задан как Пакет листов, это происходит по умолчанию. Уплотнить V2—Листы группируются только в пакетные файлы. Этот формат обеспечивает лучшую производительность в общих сетевых папках и каталогах облачных хранилищ. Если параметр Тип кэша экспорта задан как Пакет листов, то расширение пакета листов будет .tpkx, и оно поддерживается новыми версиями продуктов ArcGIS, такими как ArcGIS Online, ArcGIS Enterprise 11.4 и ArcGIS Maps SDKs for Native Apps 200.0 и позже и ArcGIS Runtime 100.5-100.15. Полистный—Каждый лист будет сохранен как отдельный файл.	String
Масштабы	Список уровней масштаба, на которых будут экспортированы листы.	Double
Число экземпляров кэшированного сервиса (Дополнительный)	Задает число экземпляров, использующихся для обновления или создания листов. Значение этого параметра установлено как – без ограничений (-1) и не может быть изменено.	Long
Область интереса (Дополнительный)	Область интереса, ограничивающая область экспорта листов из кэша. Этот параметр полезен, если вы хотите экспортировать области неправильной формы, т.к. инструмент обрезает набор данных кэша на пиксельном разрешении. Если область интереса не указана, экспортируется полный экстент карты.	Feature Set
Экстент экспорта (Дополнительный)	Прямоугольный экстент определяет листы, которые будут экспортированы. По умолчанию экстент соответствует полному экстенту картографического сервиса, в который вы производите импорт. Дополнительный параметр Область интереса позволяет импортировать альтернативно с помощью полигона. Рекомендуется не указывать значения обоих параметров. Если значения приведены для обоих параметров, параметр Область интереса имеет приоритет над этим параметром. Текущий экстент отображения - экстент будет основан на активной карте или сцене. Нарисовать экстент - экстент будет основан прямоугольнике, нарисованном на карте или сцене. Экстент слоя - экстент будет основан на активном слое карты. Выберите доступный слой или воспользуйтесь опцией Экстент данных во всех слоях. У каждого слоя карте есть следующие опции: Все объекты - экстент всех объектов. Выбранные объекты - экстент выбранных объектов. Отображаемые объекты - экстент отображаемых объектов. Обзор - экстент будет основан на наборе данных. Буфер обмена - экстент может быть скопирован в буфер обмена и из него. Копировать экстент - копирует экстент и систему координат в буфер обмена. Вставить экстент - вставляет экстент и систему координат из буфера обмена. Если буфер обмена не содержат систему координат, экстент будет использовать систему координат карты. Сбросить экстент - экстент будет сброшен до значения по умолчанию. Если координаты заданы вручную, они должны быть числовыми значениями в системе координат активной карты. На карте могут использоваться единицы отображения, отличные от введенных координат. Используйте знак отрицательного значения для координат юга и запада.	Extent
Перезаписать листы (Дополнительный)	Задает, будут ли изображения в кэше назначения объединены с листами из исходного кэша или они будут перезаписаны ими. Отмечено — все пиксели в области интереса будут заменены, что позволяет перезаписать кэш назначения листами из исходного кэша. Не отмечено – при экспорте листов прозрачные пикселы исходного кэша игнорируются. Это позволяет получить объединенное или смешанное изображение в кэше назначения. Это значение по умолчанию	Boolean

Производные выходные данные

Подпись	Описание	Тип данных
Путь к выходному кэшу	Папка, в которую был экспортирован кэш.	String

arcpy.server.ExportMapServerCache(input_service, target_cache_path, export_cache_type, copy_data_from_server, storage_format_type, scales, {num_of_caching_service_instances}, {area_of_interest}, {export_extent}, {overwrite})

Имя	Описание	Тип данных
input_service	Слой изображения карты с полистным кэшем для экспорта.	Image Service; Map Server
target_cache_path	Папка, в которую будет экспортирован кэш. Эта папка не обязательно должна быть зарегистрированной директорией кэша сервера. Учетная запись ArcGIS Server должна иметь право на запись в целевую папку кэша. Если учетной записи сервера не может быть предоставлен доступ на запись в папку назначения, но у клиента ArcGIS Desktop или ArcGIS Pro такой доступ есть, то выберите параметр Копировать данные с сервера.	Folder
export_cache_type	Определяет тип кэша, который будет экспортирован. Пакеты листов подходят для использования с ArcGIS Maps SDKs for Native Apps. CACHE_DATASET—Будет экспортирован кэш картографического сервиса или сервиса изображений, созданный с применением ArcGIS Server Может использоваться в ArcGIS Desktop и сервисами карт и изображений ArcGIS Server. Это значение по умолчанию TILE_PACKAGE—Будет импортирован один сжатый файл, в котором набор данных кэша добавлен в виде слоя и объединен для совместного использования. Его можно использовать в ArcGIS Pro и с ArcGIS Maps SDKs for Native Apps.	String
copy_data_from_server	Определяет, как листы будут перемещены в целевую папку. Установите для этого параметра значение COPY_DATA, если учетной записи ArcGIS Server не может быть предоставлен доступ на запись в целевую папку, а у клиента ArcGIS Desktop или ArcGIS Pro такой доступ есть. Программное обеспечение экспортирует листы в выходную директорию сервера, прежде чем переместить их в целевую папку. COPY_DATA—Листы помещаются в выходную директорию сервера, а затем перемещаются в целевую папку. Клиент ArcGIS Desktop или ArcGIS Pro должен иметь право на запись в целевую папку. DO_NOT_COPY—Листы экспортируются непосредственно в целевую папку. Учетная запись ArcGIS Server должна иметь право на запись в целевую папку. Это значение по умолчанию	Boolean
storage_format_type	Определяет формат хранения, который будет использоваться для экспортируемого кэша. COMPACT—Листы группируются в пакетные файлы для экономии места на диске и ускорения копирования кэша. Если параметр export_cache_type задан как TILE_PACKAGE, это выполняется по умолчанию. COMPACT_V2—Листы группируются только в пакетные файлы. Этот формат обеспечивает лучшую производительность в общих сетевых папках и каталогах облачных хранилищ. Если параметр export_cache_type задан как TILE_PACKAGE, то расширение пакета листов будет.tpkx, и оно поддерживается новыми версиями продуктов ArcGIS, такими как ArcGIS Online, ArcGIS Enterprise 11.4 и ArcGIS Maps SDKs for Native Apps 200.0 и позже и ArcGIS Runtime 100.5-100.15. EXPLODED—Каждый лист будет сохранен как отдельный файл.	String
scales [scales,...]	Список уровней масштаба, на которых будут экспортированы листы.	Double
num_of_caching_service_instances (Дополнительный)	Задает число экземпляров, использующихся для обновления или создания листов. Значение этого параметра установлено как – без ограничений (-1) и не может быть изменено.	Long
area_of_interest (Дополнительный)	Область интереса, ограничивающая область экспорта листов из кэша. Этот параметр полезен, если вы хотите экспортировать области неправильной формы, т.к. инструмент обрезает набор данных кэша на пиксельном разрешении. Если область интереса не указана, экспортируется полный экстент карты.	Feature Set
export_extent (Дополнительный)	Прямоугольный экстент определяет листы, которые будут экспортированы. По умолчанию экстент соответствует полному экстенту картографического сервиса, в который вы производите импорт. Дополнительный параметр Область интереса позволяет импортировать альтернативно с помощью полигона. Рекомендуется не указывать значения обоих параметров. Если значения приведены для обоих параметров, параметр Область интереса имеет приоритет над этим параметром. MAXOF – Будет использоваться максимальный экстент всех входных данных. MINOF – Будет использоваться минимальная область, которая является общей для всех входных данных. DISPLAY — Экстент равен видимому отображению. Имя слоя - будет использоваться тот же экстент, что и в указанном слое. Объект Extent — будет использоваться экстент указанного объекта. Строка координат, разделенных пробелами – будет использоваться экстент из заданной строки. Координаты должны быть выражены в таком порядке: x-min, y-min, x-max, y-max.	Extent
overwrite (Дополнительный)	Задает, будут ли изображения в кэше назначения объединены с листами из исходного кэша или они будут перезаписаны ими. OVERWRITE—Все пикселы области интереса будут заменены, что позволяет перезаписать кэш назначения листами из исходного кэша. MERGE—При импорте листов прозрачные пикселы исходного кэша игнорируются. Это позволяет получить объединенное или смешанное изображение в кэше назначения. Это значение по умолчанию	Boolean

Производные выходные данные

Имя	Описание	Тип данных
output_cache_path	Папка, в которую был экспортирован кэш.	String

Пример кода

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

Экспорт листов кэша для класса объектов при изменении формата хранения с EXPLODED на COMPACT.

# Name: ExportMapServerCache.py for ArcGIS Server
# Description: The following stand-alone script demonstrates how to export
# 		cache as CACHE_DATASET in COMPACT storage format and MERGE tiles
#               using an AREA_OF_INTEREST to TARGET_CACHE_PATH
#		which is accessible to server instances
# Requirements: os, sys, time and traceback modules

# Any line that begins with a pound sign is a comment and will not be executed
# Empty quotes take the default value.
# To accept arguments from the command line replace values of variables to
#                                                           "sys.argv[]"

# Import system modules
import arcpy
from arcpy import env
import os, sys, time, datetime, traceback, string

# Set environment settings
env.workspace = "C:/data"

# List of input variables for map service properties
connectionFile = r"C:\Users\<username>\AppData\Roaming\ESRI\Desktop10.1\ArcCatalog"
server 			= "arcgis on MyServer_6080 (publisher)"
serviceName 		= "Rainfall.MapServer"
inputService 		= connectionFile + "\\" + server + "\\" + serviceName
targetCachePath 	= "C:/data/temp"
exportCacheType 	= "CACHE_DATASET"
copyDataFromServer 	= "DO_NOT_COPY"
storageFormat 		= "COMPACT"
scales 			= [500000,250000,125000,64000]
numOfCachingServiceInstances = "2"
areaOfInterest 		= "C:/data/101/Portland/Metro.shp"
exportExtents 		= ""
overwriteTiles 		= "MERGE"

currentTime = datetime.datetime.now()
arg1 	= currentTime.strftime("%H-%M")
arg2 	= currentTime.strftime("%Y-%m-%d %H:%M")
file 	= 'C:/data/report_%s.txt' % arg1

# print results of the script to a report
report = open(file,'w')

# use "scaleValues[0]","scaleValues[-1]","scaleValues[0:3]"

# Enter rectangular custom extent values for the "exportExtents" variable to
# constrain the exporting cache along the rectangular extents

try:
    starttime = time.clock()
    result = arcpy.server.ExportMapServerCache(inputService, targetCachePath,
                                               exportCacheType,
                                               copyDataFromServer,
                                               storageFormat, scales,
                                               numOfCachingServiceInstances,
                                               areaOfInterest, exportExtents,
					       overwriteTiles)
    finishtime = time.clock()
    elapsedtime = finishtime - starttime

    #print messages to a file
    while result.status < 4:
        time.sleep(0.2)
    resultValue = result.getMessages()
    report.write ("completed " + str(resultValue))

    print("Exported cache successfully for mapservice " + serviceName + \
        " to " + targetCachePath + "\n using " + areaOfInterest + "\n in " + \
        str(elapsedtime) + " sec \n on " + arg2)

except Exception as e:
    # If an error occurred, print line number and error message
    tb = sys.exc_info()[2]
    report.write("Failed at \n" "Line %i" % tb.tb_lineno)
    report.write(str(e))

print("Exported Map server Cache  using area of Interest")

report.close()

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

Экспорт кэша в качестве TILE_PACKAGE, когда папка назначения недоступна для ArcGIS Server.

# Name: ExportMapServerCache.py
# Description: The following stand-alone script demonstrates how to export cache
#               as TILE_PACKAGE for default number of scales of a service, to a
#               TARGET_CACHE_PATH which is inaccessible to server instances using
#               COPY_DATA_FROM_SERVER
# Requirements: os, sys, time and traceback modules

# Any line that begins with a pound sign is a comment and will not be executed
# Empty quotes take the default value.
# To accept arguments from the command line replace values of variables to
#                                                           "sys.argv[]"

# Import system modules
import arcpy
from arcpy import env
import os, sys, time, datetime, traceback, string

# Set environment settings
env.workspace = "C:/data"

# List of input variables for map service properties
connectionFile = r"C:\Users\<username>\AppData\Roaming\ESRI\Desktop10.1\ArcCatalog"
server = "arcgis on MyServer_6080 (publisher)"
serviceName = "Rainfall.MapServer"
inputService = connectionFile + "\\" + server + "\\" + serviceName
targetCachePath = "C:/temp/usa"
exportCacheType = "TILE_PACKAGE"
copyDataFromServer = "COPY_DATA"
storageFormat = "COMPACT"
scaleValues = [500000,250000,125000,64000]
numOfCachingServiceInstances = "2"
exportExtents = ""
areaOfInterest = ""
overwriteTiles = "MERGE"

currentTime = datetime.datetime.now()
arg1 = currentTime.strftime("%H-%M")
arg2 = currentTime.strftime("%Y-%m-%d %H:%M")
file = 'C:/data/report_%s.txt' % arg1

# print results of the script to a report
report = open(file,'w')

# use "scaleValues[0]","scaleValues[-1]","scaleValues[0:3]"

try:
    starttime = time.clock()
    result = arcpy.server.ExportMapServerCache(inputService, targetCachePath,
                                               exportCacheType,
                                               copyDataFromServer,
                                               storageFormat, scales,
                                               numOfCachingServiceInstances,
                                               areaOfInterest,
                                               exportExtents, overwriteTiles)
    finishtime = time.clock()
    elapsedtime = finishtime - starttime

    #print messages to a file
    while result.status < 4:
        time.sleep(0.2)
    resultValue = result.getMessages()
    report.write ("completed " + str(resultValue))

    print("Exported cache successfully for mapservice " + serviceName + " to " + \
        targetCachePath + " in " + str(elapsedtime) + " sec \n on" + arg2)

except Exception as e:
    # If an error occurred, print line number and error message
    tb = sys.exc_info()[2]
    report.write("Failed at step 1 \n" "Line %i" % tb.tb_lineno)
    report.write(str(e))

print("Exported Map server Cache ")

report.close()

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

Этот инструмент не использует параметры среды геообработки

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

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

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

Отзыв по этому разделу?

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

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

Параметры

Производные выходные данные

Производные выходные данные

Пример кода

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

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

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

В этом разделе