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

Resumen

Genera teselas desde un mapa y empaqueta las teselas para crear un único paquete de teselas comprimido (archivo .tpkx).

Uso

  • El mapa de entrada debe incluir 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 y proporcione 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 función del valor especificado para Nivel de visualización.

  • 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:

    Factor de procesamiento en paralelo / 100 * núcleos lógicos

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

Parámetros

EtiquetaExplicaciónTipo 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.

  • Activado: se 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 le permite superponer las teselas de la caché con 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 las de otras organizaciones que hayan 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 contener escalas que podrían haberse acercado demasiado como para ser de utilidad para su 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.

  • Desactivado: se utilizará un esquema de ordenamiento en teselas a partir de un servicio de mapas existente.

    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. Los esquemas de ordenamiento en teselas coincidentes garantizan que las teselas se superpongan correctamente en la aplicación ArcGIS Runtime.

    Si elige esta opción, utilice el mismo sistema de coordenadas para el mapa de origen que el mapa con el esquema de ordenamiento en teselas que esté importando.

Boolean
Archivo de salida

El paquete de teselas de mapas de salida.

File
Formato de ordenamiento en teselas

Especifica el formato que se utilizará para las teselas generadas.

  • PNGEl formato correcto (PNG 8, PNG 24 o PNG 32) se utilizará según el valor especificado para Nivel de detalle. Esta es la opción predeterminada.
  • PNG de 8 bitsSe utilizará el formato PNG8. Utilice este formato 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 utilizar fácilmente más de 256 colores en un mapa. Incluso símbolos, como las señales de autopista, pueden tener un antialiasing sutil alrededor de los bordes que agrega inesperadamente colores a un mapa.
  • PNG de 24 bitsSe utilizará el formato PNG24. Utilice este formato 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).
  • PNG de 32 bitsSe utilizará el formato PNG32. Utilice este formato para superponer servicios, como por ejemplo carreteras y límites, que tengan más de 256 colores. PNG 32 es una buena elección 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.
  • JPEGSe utilizará el formato JPEG. Utilice este formato para los servicios de mapa base que tengan una gran variación de color y no necesiten un fondo transparente. Por ejemplo, las imágenes ráster y los mapas base vectoriales 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 áreas borrosas alrededor de las líneas. Si este fuera el caso, puede aumentar el valor de compresión desde el valor 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.Si está dispuesto a aceptar una cantidad pequeña de ruido en las imágenes, puede ahorrar grandes cantidades de espacio en disco con JPEG. Un tamaño de tesela menor significa que la aplicación puede descargar las teselas a más velocidad.
  • MixtoEl formato JPEG se utilizará en el centro del paquete y PNG 32 se utilizará 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 donde se detecta transparencia (en otras palabras, donde el fondo del mapa esté 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 se superpone al otro paquete.
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)

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

String
Etiquetas
(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
Extensión
(Opcional)

Especifica la extensión que se utilizará para seleccionar o recortar entidades.

  • Valor predeterminado: la extensión se basará en la extensión máxima de todas las entradas participantes. Esta es la opción predeterminada.
  • Combinación de entradas: la extensión se basará en la extensión máxima de todas las entradas.
  • Intersección de entradas: la extensión se basará en el área mínima en común de todas las entradas.
  • Extensión de visualización actual: la extensión es igual a la visualización actual. La opción no está disponible cuando no hay ningún mapa activo.
  • Como se especifica en la parte inferior: la extensión se basará en los valores mínimo y máximo de extensión que se especifiquen.
  • Examinar: la extensión se basará en un dataset existente.
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. 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
Tipo de paquete
(Opcional)

Especifica el tipo de paquete de teselas que se creará.

  • tpkLas teselas se almacenarán con el formato de almacenamiento Compact. Este formato se admite en toda la plataforma ArcGIS.
  • tpkxLas teselas se almacenarán 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 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
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 crean 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

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})
NombreExplicació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. Los esquemas de ordenamiento en teselas coincidentes garantizan que las teselas se superpongan correctamente en la aplicación ArcGIS Runtime.Si elige esta opción, utilice el mismo sistema de coordenadas para el 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 le permite superponer las teselas de la caché con 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 las de otras organizaciones que hayan 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 contener escalas que podrían haberse acercado demasiado como para ser de utilidad para su 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 que se utilizará para las teselas generadas.

  • PNGEl formato correcto (PNG 8, PNG 24 o PNG 32) se utilizará según el valor especificado para Nivel de detalle. Esta es la opción predeterminada.
  • PNG8Se utilizará el formato PNG8. Utilice este formato 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 utilizar fácilmente más de 256 colores en un mapa. Incluso símbolos, como las señales de autopista, pueden tener un antialiasing sutil alrededor de los bordes que agrega inesperadamente colores a un mapa.
  • PNG24Se utilizará el formato PNG24. Utilice este formato 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).
  • PNG32Se utilizará el formato PNG32. Utilice este formato para superponer servicios, como por ejemplo carreteras y límites, que tengan más de 256 colores. PNG 32 es una buena elección 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.
  • JPEGSe utilizará el formato JPEG. Utilice este formato para los servicios de mapa base que tengan una gran variación de color y no necesiten un fondo transparente. Por ejemplo, las imágenes ráster y los mapas base vectoriales 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 áreas borrosas alrededor de las líneas. Si este fuera el caso, puede aumentar el valor de compresión desde el valor 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.Si está dispuesto a aceptar una cantidad pequeña de ruido en las imágenes, puede ahorrar grandes cantidades de espacio en disco con JPEG. Un tamaño de tesela menor significa que la aplicación puede descargar las teselas a más velocidad.
  • MIXEDEl formato JPEG se utilizará en el centro del paquete y PNG 32 se utilizará 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 donde se detecta transparencia (en otras palabras, donde el fondo del mapa esté 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 se superpone al otro paquete.
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)

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 los formatos 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 almacenarán con el formato de almacenamiento Compact. Este formato se admite en toda la plataforma ArcGIS.
  • tpkxLas teselas se almacenarán 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 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 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 crean 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

Muestra de código

Ejemplo 1 de CreateMapTilePackage (ventana de Python)

El siguiente script de Python demuestra cómo utilizar la función CreateMapTilePackage desde la ventana de Python.

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

Información de licenciamiento

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

Temas relacionados