Generar esquema de ordenamiento en teselas de caché de servidor de mapas (Herramientas del Servidor)

Resumen

Genera un archivo de esquema de ordenamiento en teselas personalizado que define los niveles de escala, las dimensiones de teselas y otras propiedades para una capa de teselas web.

Un esquema de ordenamiento en teselas describe cómo los clientes deben hacer referencia a las teselas en una caché y es una representación cartográfica entre la referencia espacial del documento de mapa fuente y la cuadrícula de ordenamiento en teselas. La cuadrícula de ordenamiento en teselas utiliza un esquema de referencia de nivel de detalle (escala), fila y columna. El esquema además define los niveles de escala (niveles de detalle) en los cuales la caché tiene teselas, el tamaño de las teselas en píxeles y la resolución de la pantalla donde las teselas de mostrarán con mayor frecuencia. Se necesita un esquema de ordenamiento en teselas para generar una caché de mapa.

Uso

Por defecto, el origen del ordenamiento en teselas comienza arriba a la izquierda del sistema de coordenadas que utiliza el documento de mapa fuente del servicio.
Cuando se activa el parámetro Formato listo para servir, el esquema de contenido de la caché se genera utilizando la especificación del paquete de teselas abierto.

Etiqueta	Explicación	Tipo de datos
Documento de mapa	El mapa actual o un archivo `.mxd` existente que se va a usar para el esquema de ordenamiento en teselas.	Map
Origen de ordenamiento en teselas en unidades de mapa	El origen (esquina superior izquierda) del esquema de ordenamiento en teselas en las coordenadas de la referencia espacial del marco de datos de origen.	Point
Esquema de ordenamiento en teselas de salida	La ruta y el nombre del archivo del esquema de ordenamiento en teselas que se creará.	File
Número de escalas	El número de niveles de escala que se incluirán en el esquema de ordenamiento en teselas.	Long
Escalas	Los niveles de escala que se incluirán en el esquema de ordenamiento en teselas. No se representan como fracciones. En cambio, utilice 500 para representar una escala de 1:500 y así sucesivamente.	Value Table
Puntos(Píxeles) por pulgada	Los puntos por pulgada (dpi) del dispositivo de salida deseado. Si se especifica un DPI que no coincide con la resolución del dispositivo de salida, la escala de la tesela de mapa aparecerá como incorrecta. El valor predeterminado es 96.	Long
Tamaño de tesela	Especifica en píxeles el ancho y la altura de las teselas en caché. Para un mejor equilibrio entre rendimiento y manejabilidad, evite desviarse de las dimensiones estándar de 256 por 256 o 512 por 512. 128 por 128 píxeles—La anchura y altura de las teselas de la caché será 128 × 128 píxeles. 256 por 256 píxeles—La anchura y altura de las teselas de la caché será de 256 × 256 píxeles. Esta es la opción predeterminada. 512 por 512 píxeles—La anchura y altura de las teselas de la caché será de 512 × 512 píxeles. 1024 por 1024 píxeles—La anchura y altura de las teselas de la caché será de 1024 × 1024 píxeles.	String
Formato listo para servir (Opcional)	Especifica el formato de archivo del esquema de caché que se utilizará y si se generará usando la especificación del paquete de teselas abierto. Activado—El esquema de la caché se generará en formato JSON utilizando la especificación del paquete de teselas abierto. Debe especificarse una carpeta de salida en el parámetro Carpeta de salida. Desactivado—El esquema de la caché se generará en formato XML. Esta es la opción predeterminada.	Boolean
Carpeta de salida (Opcional)	La ubicación de la carpeta donde se crearán el esquema de la caché y los archivos `iteminfo` en formato JSON.	Folder

arcpy.server.GenerateMapServerCacheTilingScheme(in_map, tile_origin, output_tiling_scheme, num_of_scales, scales, dots_per_inch, tile_size, {ready_to_serve_format}, {output_folder})

Nombre	Explicación	Tipo de datos
in_map	El mapa actual o un archivo `.mxd` existente que se va a usar para el esquema de ordenamiento en teselas.	Map
tile_origin	El origen (esquina superior izquierda) del esquema de ordenamiento en teselas en las coordenadas de la referencia espacial del marco de datos de origen.	Point
output_tiling_scheme	La ruta y el nombre del archivo del esquema de ordenamiento en teselas que se creará.	File
num_of_scales	El número de niveles de escala que se incluirán en el esquema de ordenamiento en teselas.	Long
scales [scales,...]	Los niveles de escala que se incluirán en el esquema de ordenamiento en teselas. No se representan como fracciones. En cambio, utilice 500 para representar una escala de 1:500 y así sucesivamente.	Value Table
dots_per_inch	Los puntos por pulgada (dpi) del dispositivo de salida deseado. Si se especifica un DPI que no coincide con la resolución del dispositivo de salida, la escala de la tesela de mapa aparecerá como incorrecta. El valor predeterminado es 96.	Long
tile_size	Especifica en píxeles el ancho y la altura de las teselas en caché. Para un mejor equilibrio entre rendimiento y manejabilidad, evite desviarse de las dimensiones estándar de 256 por 256 o 512 por 512. `128 x 128`—La anchura y altura de las teselas de la caché será 128 × 128 píxeles. `256 x 256`—La anchura y altura de las teselas de la caché será de 256 × 256 píxeles. Esta es la opción predeterminada. `512 x 512`—La anchura y altura de las teselas de la caché será de 512 × 512 píxeles. `1024 x 1024`—La anchura y altura de las teselas de la caché será de 1024 × 1024 píxeles.	String
ready_to_serve_format (Opcional)	Especifica el formato de archivo del esquema de caché que se utilizará y si se generará usando la especificación del paquete de teselas abierto. `READY_TO_SERVE_FORMAT`—El esquema de la caché se generará en formato JSON utilizando la especificación del paquete de teselas abierto. Debe especificarse una carpeta de salida en el parámetro `output_folder`. `NON_READY_TO_SERVE_FORMAT`—El esquema de la caché se generará en formato XML. Esta es la opción predeterminada.	Boolean
output_folder (Opcional)	La ubicación de la carpeta donde se crearán el esquema de la caché y los archivos `iteminfo` en formato JSON.	Folder

Muestra de código

Ejemplo 1 de GenerateMapServerCacheTilingScheme (formato XML)

El siguiente ejemplo crea un esquema de ordenamiento en teselas de la caché de mapa en formato XML.

# Name: GeneateMapServerCacheTilingScheme.py
# Description: The following stand-alone script demonstrates how to create map
#               server cache schema using a given map document at a given
#               "pathForOutputXml"
# Requirements: os, sys, time & traceback modules

# Any line that begins with a pound sign is a comment and will not be run
# 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 sys
import time

# Set environment settings
env.workspace = "E:/path/to/myfolder"

# List of input variables for map service properties

# Reference map to use for cache tiling sceheme generation
aprx = arcpy.mp.ArcGISProject(r"E:\Data\path\to\myAPRX.aprx")
mapDocument = aprx.listMaps("myMapName")[0]
outputTilingScheme = "E:/path/to/myschema.xml"
tileOrigin = ""
numOfScales = "4"
scales = "4000000,2000000,100000,50000"
tileSize = "256 x 256"
dotsPerInch = "96"

# print results of the script to a report

file = r'E:\path\to\myreport.txt'
report = open(file,'w')

try:
    #starttime = time.clock()
    result = arcpy.server.GenerateMapServerCacheTilingScheme(mapDocument,
                                                             tileOrigin, outputTilingScheme,
                                                             numOfScales, scales,
                                                             dotsPerInch, tileSize)

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

    print(" Created MapServer cache tiling schema successfully using" + \
        mapDocument + " at "+ outputTilingScheme )

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("Created Map server Cache Tiling schema ")

report.close()

Ejemplo 2 de GenerateMapServerCacheTilingScheme (formato JSON)

El siguiente ejemplo crea un esquema de ordenamiento en teselas de la caché de mapa en formato JSON.

# Name: GeneateMapServerCacheTilingScheme.py
# Description: The following stand-alone script demonstrates how to create map
#               server cache schema in ready to serve format using a given map document at a given
#               folder
# Requirements: os, sys, time & traceback modules

# Any line that begins with a pound sign is a comment and will not be run
# 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 sys
import time

# Set environment settings
env.workspace = "E:/path/to/myfolder"

# List of input variables for map service properties

# Reference map to use for cache tiling sceheme generation
aprx = arcpy.mp.ArcGISProject(r"E:\Data\path\to\myAPRX.aprx")
mapDocument = aprx.listMaps("myMapName")[0]
outputTilingScheme = "None"
tileOrigin = ""
numOfScales = "4"
scales = "4000000,2000000,100000,50000"
tileSize = "256 x 256"
dotsPerInch = "96"
ready_to_serve_format = "READY_TO_SERVE_FORMAT"
output_folder = "E:\\path\\to\\myfolder"

# print results of the script to a report

file = r'E:\path\to\myreport.txt'
report = open(file,'w')

try:
    #starttime = time.clock()
    result = arcpy.server.GenerateMapServerCacheTilingScheme(mapDocument,
                                                             tileOrigin, outputTilingScheme,
                                                             numOfScales, scales,
                                                             dotsPerInch, tileSize,
                                                             ready_to_serve_format,
                                                             output_folder)

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

    print(" Created MapServer cache tiling schema successfully using" + \
        mapDocument + " at "+ outputTilingScheme )

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("Created Map server Cache Tiling schema ")

report.close()

Entornos

Espacio de trabajo actual

Información de licenciamiento

Basic: Sí
Standard: Sí
Avanzado: Sí

Generar esquema de ordenamiento en teselas de caché de servidor de mapas (Herramientas del Servidor)

Resumen

Uso

Parámetros

Entornos

Información de licenciamiento

Temas relacionados