Generar esquema de ordenamiento en teselas de caché de servidor de mapas (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.

Parámetros

EtiquetaExplicaciónTipo 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íxelesLa anchura y la altura de las teselas de la caché serán de 128 por 128 píxeles.
  • 256 por 256 píxelesLa anchura y la altura de las teselas de la caché serán de 256 por 256 píxeles. Esta es la opción predeterminada.
  • 512 por 512 píxelesLa anchura y la altura de las teselas de la caché serán de 512 por 512 píxeles.
  • 1024 por 1024 píxelesLa anchura y la altura de las teselas de la caché serán de 1024 por 1024 píxeles.
String
Formato Listo para servir
(Opcional)

Especifica el formato de archivo del esquema de la caché que se utilizará y si se generará utilizando 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})
NombreExplicaciónTipo 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 128La anchura y la altura de las teselas de la caché serán de 128 por 128 píxeles.
  • 256 x 256La anchura y la altura de las teselas de la caché serán de 256 por 256 píxeles. Esta es la opción predeterminada.
  • 512 x 512La anchura y la altura de las teselas de la caché serán de 512 por 512 píxeles.
  • 1024 x 1024La anchura y la altura de las teselas de la caché serán de 1024 por 1024 píxeles.
String
ready_to_serve_format
(Opcional)

Especifica el formato de archivo del esquema de la caché que se utilizará y si se generará utilizando la especificación del paquete de teselas abierto.

  • READY_TO_SERVE_FORMATEl 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_FORMATEl 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 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 = "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 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 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 = "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()

Información de licenciamiento

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

Temas relacionados