Etiqueta | Explicación | Tipo de datos |
Mapa de entrada | Mapa desde el que se generarán y empaquetarán las teselas. | Map |
Paquete para ArcGIS Online | Bing Maps | Google Maps | Especifica si el esquema de ordenamiento en teselas se generará a partir de un servicio de mapas existente o si se generarán teselas de mapas para ArcGIS Online, Bing Maps y Google Maps.
| Boolean |
Archivo de salida | La ruta de salida y el nombre de archivo del paquete de teselas de mapa. Cuando el parámetro Crear varios paquetes está activado, este parámetro se sustituye por el parámetro Carpeta de salida para especificar dónde se generarán los paquetes de teselas. | File |
Formato de ordenamiento en teselas | Especifica el formato que se utilizará para las teselas generadas.
| String |
Nivel de detalle máximo | La representación entera correspondiente al número de escalas utilizadas para definir un esquema de ordenamiento en teselas de caché. Este valor de escala define el nivel máximo hasta el que se generarán las teselas de caché en el paquete de teselas. Los valores más altos reflejan mayores escalas que muestran un mayor nivel de detalle, pero requieren más espacio de almacenamiento. Los valores más bajos reflejan menores escalas que muestran un menor nivel de detalle y requieren menos espacio de almacenamiento. Los valores posibles van de 1 a 23. El valor predeterminado es 1. El valor de nivel de detalle máximo debe ser mayor que el valor de nivel de detalle mínimo. | Long |
Servicio (Opcional) | El nombre del servicio de mapas o los archivos .xml que se utilizarán para el esquema de ordenamiento en teselas. Este parámetro es necesario solo cuando está desactivado el parámetro Paquete para ArcGIS Online | Bing Maps | Google Maps. | Map Server; File |
Resumen (Opcional) | La información del resumen que se agregará a las propiedades del paquete. | String |
Etiquetas (Opcional) | La información de etiqueta que se agregará a las propiedades del paquete. Se pueden agregar varias etiquetas separadas por una coma o un punto y coma. | String |
Extent (Opcional) | Especifica la extensión que se utilizará para seleccionar o recortar entidades.
Cuando las coordenadas se proporcionan de forma manual, las coordenadas deben ser valores numéricos y encontrarse en el sistema de coordenadas del mapa activo. El mapa podría utilizar unidades de visualización distintas de las coordenadas proporcionadas. Utilice un valor de signo negativo para las coordenadas sur y oeste. | Extent |
Calidad de compresión (Opcional) | Un valor entre 1 y 100 para la calidad de compresión JPEG. El valor predeterminado es 75 para el formato de tesela JPEG y cero para otros formatos. La compresión solo es compatible con los formatos JPEG y MIXED. Un valor superior resultará en un tamaño de archivo más grande con una imagen de calidad más alta. Un valor inferior resultará en un tamaño de archivo más pequeño con una imagen de calidad más baja. | Long |
Tipo de paquete (Opcional) | Especifica el tipo de paquete de teselas que se creará.
| String |
Nivel de detalle mínimo (Opcional) | La representación entera correspondiente al número de escalas utilizadas para definir un esquema de ordenamiento en teselas de caché. Este valor de escala define el nivel en el que las teselas de caché comienzan a estar disponibles y se generan en el paquete de teselas. Los valores posibles van de 0 a 23. El valor predeterminado es 0. El valor de nivel de detalle mínimo debe ser menor o igual que el valor de nivel de detalle máximo. | Long |
Área de interés (Opcional) | Un conjunto de entidades que restringe dónde se crearán las teselas. Utilice un área de interés para crear teselas para áreas con formas irregulares o entidades multiparte. Las áreas fuera del cuadro de delimitación de las entidades del área de interés no se almacenarán en caché. Si no se proporciona ningún valor para este parámetro, el área de interés será la extensión completa del mapa de entrada. | Feature Set |
Crear varios paquetes (Opcional) | Especifica si se generará un único paquete de teselas grande o varios paquetes de teselas pequeños. Este parámetro no está disponible si la variable del entorno Factor de procesamiento en paralelo es 0 o si el parámetro Tipo de paquete se ha definido como tpk.
| Boolean |
Carpeta de salida | La ubicación en la que se generarán varios paquetes de teselas. Si la carpeta de salida no está vacía, se creará una subcarpeta en la carpeta de salida para almacenar las teselas. Se utilizará un GUID generado automáticamente como el nombre de la carpeta. Cuando el parámetro Crear varios paquetes está desactivado, este parámetro se sustituye por el parámetro Archivo de salida para especificar el nombre del único paquete de teselas que se generará. | Folder |
Resumen
Genera teselas a partir de un mapa y las empaqueta como un único paquete de teselas o varios paquetes de teselas más pequeños.
Uso
Esta herramienta respeta la variable del entorno Factor de procesamiento en paralelo. Cuando se activa el parámetro Crear varios paquetes, el procesamiento en paralelo generará el contenido de la caché en varios procesos para utilizar la CPU disponible y generar paquetes de teselas cuando se alcanza el umbral predeterminado (1 GB de límite de tamaño).
Utilice el parámetro Crear varios paquetes cuando trabaje con grandes volúmenes de datos. Con este parámetro activado, se crearán varios paquetes de teselas pequeños en lugar de uno grande. Así, puede generar contenido de teselas de más de 500 GB en un único trabajo y compartirlo o cargarlo y publicarlo en ArcGIS Online como una capa de teselas alojada. Con este enfoque, puede generar un contenido de teselas grande en paquetes de teselas pequeños para su uso compartido sin subdividir las extensiones y los niveles de la caché en varios trabajos.
Si este parámetro está activado, debe proporcionar una ruta a una carpeta vacía en el sistema de archivos en el parámetro Carpeta de salida para guardar los paquetes de salida. Solo puede crear paquetes multiparte cuando el parámetro Tipo de paquete se ha definido como tpkx y la variable del entorno Factor de procesamiento en paralelo no es 0.
Cuando el parámetro Formato de ordenamiento en teselas se establece en PNG, la herramienta utilizará automáticamente el formato correcto (PNG8, PNG24 o PNG32) en función del valor especificado para el parámetro Nivel de detalle máximo.
El mapa de entrada debe incluir una descripción y etiquetas para que se ejecute la herramienta. Para agregar una descripción y etiquetas, haga clic con el botón derecho en el nombre del mapa en el panel Contenido y seleccione Propiedades. En el cuadro de diálogo Propiedades del mapa, en la pestaña Metadatos, rellene los cuadros de texto Etiquetas y Descripción.
Parámetros
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)
Nombre | Explicación | Tipo de datos |
in_map | Mapa desde el que se generarán y empaquetarán las teselas. | Map |
service_type | Especifica si el esquema de ordenamiento en teselas se generará a partir de un servicio de mapas existente o si se generarán teselas de mapas para ArcGIS Online, Bing Maps y Google Maps.
| Boolean |
output_file | La ruta de salida y el nombre de archivo del paquete de teselas de mapa. | File |
format_type | Especifica el formato que se utilizará para las teselas generadas.
| String |
level_of_detail | La representación entera correspondiente al número de escalas utilizadas para definir un esquema de ordenamiento en teselas de caché. Este valor de escala define el nivel máximo hasta el que se generarán las teselas de caché en el paquete de teselas. Los valores más altos reflejan mayores escalas que muestran un mayor nivel de detalle, pero requieren más espacio de almacenamiento. Los valores más bajos reflejan menores escalas que muestran un menor nivel de detalle y requieren menos espacio de almacenamiento. Los valores posibles van de 1 a 23. El valor predeterminado es 1. El valor de nivel de detalle máximo debe ser mayor que el valor de nivel de detalle mínimo. | Long |
service_file (Opcional) | El nombre del servicio de mapas o los archivos .xml que se utilizarán para el esquema de ordenamiento en teselas. Este parámetro solo es necesario cuando el parámetro service_type está definido como EXISTING. | Map Server; File |
summary (Opcional) | La información del resumen que se agregará a las propiedades del paquete. | String |
tags (Opcional) | La información de etiqueta que se agregará a las propiedades del paquete. Se pueden agregar varias etiquetas separadas por una coma o un punto y coma. | String |
extent (Opcional) | Especifica la extensión que se utilizará para seleccionar o recortar entidades.
| Extent |
compression_quality (Opcional) | Un valor entre 1 y 100 para la calidad de compresión JPEG. El valor predeterminado es 75 para el formato de tesela JPEG y cero para otros formatos. La compresión solo es compatible con los formatos JPEG y MIXED. Un valor superior resultará en un tamaño de archivo más grande con una imagen de calidad más alta. Un valor inferior resultará en un tamaño de archivo más pequeño con una imagen de calidad más baja. | Long |
package_type (Opcional) | Especifica el tipo de paquete de teselas que se creará.
| String |
min_level_of_detail (Opcional) | La representación entera correspondiente al número de escalas utilizadas para definir un esquema de ordenamiento en teselas de caché. Este valor de escala define el nivel en el que las teselas de caché comienzan a estar disponibles y se generan en el paquete de teselas. Los valores posibles van de 0 a 23. El valor predeterminado es 0. El valor de nivel de detalle mínimo debe ser menor o igual que el valor de nivel de detalle máximo. | Long |
area_of_interest (Opcional) | Un conjunto de entidades que restringe dónde se crearán las teselas. Utilice un área de interés para crear teselas para áreas con formas irregulares o entidades multiparte. Las áreas fuera del cuadro de delimitación de las entidades del área de interés no se almacenarán en caché. Si no se proporciona ningún valor para este parámetro, el área de interés será la extensión completa del mapa de entrada. | Feature Set |
create_multiple_packages (Opcional) | Especifica si se generará un único paquete de teselas grande o varios paquetes de teselas pequeños. Este parámetro no está disponible si la variable de entorno parallelProcessingFactor es 0 o si el parámetro package_type se ha definido como tpk.
| Boolean |
output_folder | La carpeta de salida en la que se generarán varios paquetes de teselas. Si la carpeta de salida no está vacía, se creará una subcarpeta en la carpeta de salida para almacenar las teselas. Se utilizará un GUID generado automáticamente como el nombre de la carpeta. | Folder |
Muestra de código
El siguiente script de Python muestra cómo utilizar la función CreateMapTilePackage desde la ventana de 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")
Busque todos los mapas del proyecto y cree un único paquete de teselas de mapa para cada mapa.
# 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)
Crear varios paquetes de teselas de mapa para un mapa.
# 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 )
Información de licenciamiento
- Basic: Sí
- Standard: Sí
- Advanced: Sí