Crear paquete de teselas de mapa (Administración de datos)

Resumen

Genera teselas desde un mapa y empaqueta las teselas para crear un único archivo .tpk comprimido.

Uso

  • El mapa de entrada debe tener una descripción y etiquetas para que se ejecute la herramienta. Para agregar la descripción y las etiquetas, haga clic con el botón derecho en el nombre del mapa en el panel Contenido, seleccione Propiedades e introduzca una descripción y etiquetas en la pestaña Descripción.

  • Al elegir PNG para el parámetro Formato de ordenamiento en teselas, la herramienta seleccionará automáticamente el formato correcto (PNG8, PNG24 o PNG32) en base al Nivel de visualización especificado.

  • Esta herramienta respeta el entorno Factor de procesamiento en paralelo. Si el entorno no está configurado (predeterminado) o está configurado con el valor 100, se permitirá el procesamiento en paralelo completo y la herramienta intentará distribuir el trabajo entre todos los núcleos lógicos del equipo. Configurar el entorno a 0 desactiva el procesamiento en paralelo. Especificar un factor entre 1 y 99 hará que la herramienta determine el porcentaje de núcleos lógicos que debe usar aplicando la siguiente fórmula, redondeada al entero más próximo:

    Parallel Processing Factor / 100 * Logical Cores
    .

    Si el resultado de la fórmula es 0 o 1, no se habilitará el procesamiento en paralelo.

Sintaxis

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})
ParámetroExplicaciónTipo 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.

  • EXISTINGSe utilizará un esquema de ordenamiento en teselas a partir de un servicio de mapas existente. Debe especificar un servicio de mapas en el parámetro service_file.Elija esta opción si su organización ha creado un esquema de ordenamiento en teselas para un servicio existente en el servidor y desea que coincida. Si los esquemas de ordenamiento en teselas coinciden, se asegurará de que las teselas se superpondrán correctamente en la aplicación de ArcGIS Runtime.Si elige esta opción, utilice el mismo sistema de coordenadas para su de mapa de origen que el mapa con el esquema de ordenamiento en teselas que esté importando.
  • ONLINESe utilizará el esquema de ordenamiento en teselas de ArcGIS Online/Bing Maps/Google Maps. Esta es la opción predeterminada.El esquema de ordenamiento en teselas de ArcGIS Online/Bing Maps/Google Maps permite superponer las teselas de la caché con las teselas de estos servicios de representación cartográfica en línea. ArcGIS Desktop incluye este esquema de ordenamiento en teselas como una opción integrada al cargar un esquema de ordenamiento en teselas. Cuando se elige este esquema de ordenamiento en teselas, el mapa de origen debe utilizar el sistema de coordenadas proyectadas WGS 1984 Web Mercator (Auxiliary Sphere).Se requiere el esquema de ordenamiento en teselas de ArcGIS Online/Bing Maps/Google Maps si va a superponer el paquete con ArcGIS Online, Bing Maps o Google Maps. Una ventaja del esquema de ordenamiento en teselas de ArcGIS Online/Bing Maps/Google Maps es que es ampliamente conocido en el mundo de la representación cartográfica en la red, de modo que las teselas coincidirán con aquellas de otras organizaciones que han utilizado este esquema de ordenamiento en teselas. Aun si no desea superponer ninguno de estos servicios de mapas conocidos, puede elegir el esquema de ordenamiento en teselas para su potencial de interoperabilidad.El esquema de ordenamiento en teselas de ArcGIS Online/Bing Maps/Google Maps puede incluir escalas a las que se les podría haber hecho demasiado zoom de acercamiento como para ser útiles para el mapa. Empaquetar a gran escala puede llevar mucho tiempo y ocupar mucho espacio de almacenamiento en disco. Por ejemplo, la mayor escala del esquema de ordenamiento en teselas es de aproximadamente 1:1.000. El empaquetado de todo el territorio continental de Estados Unidos a esta escala puede tardar semanas, y requiere centenares de gigabytes de capacidad de almacenamiento. Si no está preparado para empaquetar a este nivel de escala, suprima este nivel de escala a la hora de crear el paquete de teselas.
Boolean
output_file

El paquete de teselas de mapas de salida.

File
format_type

Especifica el formato de las teselas generadas.

  • PNGUtilice PNG para seleccionar automáticamente el formato correcto (PNG 8, PNG 24 o PNG 32) según el Nivel de detalle especificado. Esta es la opción predeterminada.
  • PNG8Utilice PNG 8 para superponer servicios que necesiten tener un fondo transparente, como carreteras y límites. PNG 8 crea teselas de tamaño muy pequeño en disco sin pérdida de información. No utilice PNG 8 si su mapa contiene más de 256 colores. Las imágenes, los sombreados, los rellenos de gradiente, la transparencia y el antialiasing pueden hacer que su mapa supere los 256 colores. Incluso símbolos, como las señales de autopista, pueden tener un antialiasing sutil alrededor de los bordes que agrega inesperadamente colores a su mapa.
  • PNG24Utilice PNG 24 para servicios de superposición, tales como carreteras y límites, que tengan más de 256 colores (si hay menos de 256 colores, utilice PNG 8).
  • PNG32Utilice PNG 32 para superponer servicios, como carreteras y límites, que tengan más de 256 colores. PNG 32 es una buena elección, especialmente para servicios de superposición que tengan habilitado el antialiasing en líneas o texto. PNG 32 crea teselas más grandes en el disco que PNG 24.
  • JPEGUtilice este formato para los servicios de mapa base que tengan una variación grande de color y no necesiten tener un fondo transparente. Por ejemplo, las imágenes ráster y los mapas base de vector muy detallados tienden a funcionar bien con JPEG. JPEG es un formato de imagen con pérdida de información. Intenta quitar datos de forma selectiva sin que afecte a la apariencia de la imagen. Esto puede generar tamaños de tesela muy pequeños en disco, pero si el mapa contiene tareas de línea o etiquetas de vector, puede producir demasiado ruido o un área borrosa alrededor de las líneas. Si este fuera el caso, puede intentar elevar el valor de compresión predeterminado de 75. Un valor más alto, como 90, puede equilibrar una calidad aceptable del trabajo de las líneas con la ventaja del tamaño de tesela pequeña del JPEG.Usted decide qué calidad de imagen considera aceptable. Si está dispuesto a aceptar una cantidad pequeña de ruido en las imágenes, puede ahorrar grandes cantidades de espacio de disco al elegir JPEG. Un tamaño de tesela menor significa que el aplicación puede descargar las teselas a más velocidad.
  • MIXEDUn paquete mixto utiliza JPEG en el centro del paquete y PNG 32 en el borde del paquete. Utilice el modo mixto cuando desee superponer correctamente paquetes ráster en otras capas.Cuando se crea un paquete mixto, las teselas PNG 32 se crean en cualquier ubicación en la que se detecta transparencia (en otras palabras, en cualquier ubicación en la que el fondo del del marco de datos es visible). El resto de las teselas se construyen utilizando JPEG. Así, el tamaño de archivo promedio se mantiene bajo y al mismo tiempo proporciona una superposición limpia por encima de los otros paquetes. Si no utiliza el paquete de modo mixto en este escenario, verá una información marginal no transparente alrededor de la periferia de la imagen donde superpone al otro paquete.
String
level_of_detail

La escala máxima a la que se generarán teselas para el paquete. El valor predeterminado es 1. Los posibles valores son de 1 a 24.

Los valores más altos reflejan mayores escalas que muestran un mayor nivel de detalle, pero ocupan más espacio de almacenamiento, mientras que los valores más bajos reflejan escalas menores que muestra un menor nivel de detalle y ocupan menos espacio de almacenamiento.

Este valor debe ser mayor o igual que min_level_of_detail.

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 es EXISTING.

MapServer; File
summary
(Opcional)

Agrega información de resumen a las propiedades del paquete.

String
tags
(Opcional)

Agrega información de las etiquetas 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.

  • MAXOF: se utilizará la extensión máxima de todas las entradas.
  • MINOF: se utilizará el área mínima en común de todas las entradas.
  • DISPLAY: la extensión es igual a la visualización actual.
  • Nombre de capa: se utilizará la extensión de la capa especificada.
  • Objeto de Extent: se utilizará la extensión del objeto especificado.
  • Cadena de coordenadas delimitada por espacios: se utilizará la extensión de la cadena especificada. Las coordenadas se expresan como x-min, y-min, x-max, y-max.
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 el formato JPEG y MIXED. La elección de un valor superior resultará en un tamaño de archivo más grande con una imagen de calidad más alta. La elección de 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á.

  • tpkLas teselas se almacenan con el formato de almacenamiento Compact. Se admite en toda la plataforma ArcGIS.
  • tpkxLas teselas se almacenan con el formato de almacenamiento CompactV2, que proporciona un mejor rendimiento en las redes compartidas y en los directorios de almacén en la nube. Este tipo de estructura de paquete mejorado y simplificado se admite en las versiones más recientes de los productos ArcGIS, tales como ArcGIS Online 7. 1, ArcGIS Enterprise 10. 7 y ArcGIS Runtime 100. 5. Esta es la opción predeterminada.
String
min_level_of_detail
(Opcional)

La escala mínima a la que se generarán teselas para el paquete. El valor predeterminado es 1. Los posibles valores son de 1 a 24.

Los valores más altos reflejan mayores escalas que muestran un mayor nivel de detalle, pero ocupan más espacio de almacenamiento, mientras que los valores más bajos reflejan escalas menores que muestra un menor nivel de detalle y ocupan menos espacio de almacenamiento.

Este valor debe ser menor o igual que level_of_detail.

Long

Muestra de código

Ejemplo 1 de CreateMapTilePackage (ventana de Python)

El siguiente script de Python muestra cómo utilizar la herramienta CreateMapTilePackage desde la ventana de Python.

import arcpy
arcpy.env.workspace = "C:/TilePackageExample" 
arcpy.CreateMapTilePackage_management("World Soils", "ONLINE", "Example.tpk", "PNG8", "10")
Ejemplo 2 de CreateMapTilePackage (script independiente)

Buscar y crear paquetes de teselas de mapas para todos los mapas de un proyecto.

# 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.CreateMapTilePackage_management(m, "ONLINE", "{}.tpk".format(m.name), 
                                          "PNG8", "10")

Información de licenciamiento

  • Basic: Sí
  • Standard: Sí
  • Advanced: Sí

Temas relacionados