Al intentar imprimir un mapa utilizando el servicio de geoprocesamiento PrintingTools incluido con ArcGIS Server, debe indicar una representación JSON (notación de objetos JavaScript) del mapa, incluida su información de capas y extensiones. La JSON debe estructurarse según la especificación ExportWebMap de Esri.
Cuando utilice las API Web de ArcGIS, no necesitará preocuparse por la construcción de la notación JSON; las API se ocupan de ello por usted. Sin embargo, este tema se incluye para referencia en caso alguna vez necesita construir la JSON usted mismo. Esto puede suceder si necesita llamar al servicio PrintingTools directamente o ejecutar la herramienta de geoprocesamiento de origen Exportar mapa Web desde otra aplicación.
Nota:
Para una mayor claridad y facilidad de lectura, los ejemplos de JSON de este tema presentan formato. Sin embargo, en la práctica debe entregar JSON sin formato a través de servicios de impresión.
Novedades de la versión 11.0
- Se ha implementado la compatibilidad con la activación o desactivación de la visibilidad de un elemento de flecha de norte en un diseño. Para ello, deberá utilizar elementOverrides dentro de layoutOptions.
Nota:
Puede utilizar una tarea GetLayoutTemplateInfos del servicio de impresión para averiguar si una plantilla de diseño tiene una flecha de norte.
El mapa Web está compuesto de cinco objetos de nivel superior:
{
"mapOptions": {},
"operationalLayers": [],
"baseMap": [],
"exportOptions": {},
"layoutOptions": {}
}
mapOptions
El objeto mapOptions es necesario y define las propiedades de visualización del mapa.
Sintaxis: | Ejemplo |
---|---|
|
|
Descripción | |
|
operationalLayers
La lista operationalLayers contiene todas las capas operacionales que se visualizarán en el mapa. El orden del conjunto define el orden de las capas en el mapa. El tipo de cada capa se define por la respuesta del recurso de la dirección URL. Si el recurso no se puede determinar en la dirección URL, la propiedad del tipo define el tipo. Por ejemplo, una capa WMS requiere que especifique "type": "wms". Hay algunas propiedades comunes para todos los tipos de capas operacionales, mientras que otras son específicas para cada tipo de capa operacional.
En caso de capas seguras, especifique el token en una definición de capa. El nombre de usuario y la contraseña no son compatibles como parte de la dirección URL.
Nota:
Para un servicio de mapas, servicio de entidades o un servicio de imágenes utilice una dirección URL señalando el extremo REST del servicio. Los extremos SOAP no son compatibles.
Sintaxis para las capas operacionales |
---|
|
Descripción |
Nota:Las propiedades que se describen a continuación son comunes para todos los tipos de capas operativas (por ejemplo, capa de servicio de mapas, gráficos de cliente, capa KML, etc.). Por lo tanto, puede que no estén incluidas en esta sección para cada tipo de capa de operación que figura más adelante.
|
Sintaxis para una capa de servicio de mapas | Ejemplo |
---|---|
|
|
Descripción | |
|
Sintaxis para una capa de entidades | Ejemplo |
---|---|
|
|
Descripción | |
|
Sintaxis para una capa de servicio de imágenes | Ejemplo |
---|---|
|
|
Descripción | |
Nota:Consulte la API REST de ArcGIS para obtener más información sobre las capas de servicio de imágenes. |
Sintaxis para una capa de servicio WMS | |
---|---|
| |
Descripción | |
|
Sintaxis para una capa KML | Ejemplo |
---|---|
|
|
Descripción | |
|
Sintaxis para una imagen del cliente | Ejemplo |
---|---|
|
|
Descripción | |
|
Sintaxis para gráficos de cliente | Ejemplo | |
---|---|---|
|
| |
Descripción | ||
|
Sintaxis de valores separados por coma (CSV), archivo de dirección URL | Ejemplo | |
---|---|---|
|
| |
Descripción | ||
|
Otras propiedades
Nota:
Consulte la API REST de ArcGIS para obtener más información sobre las propiedades siguientes:
- source
- renderer
- symbol
- textSymbol
- labelingInfo
- geometry
- geometryType
- spatialRel
- relationParam
Sintaxis para definir drawingInfo para un renderizador temporal | Ejemplo |
---|---|
Nota:El renderizador temporal no se admite en los Servicios de impresión publicados desde ArcGIS Pro.
|
|
Sintaxis para definir un symbolAger | |
| |
Sintaxis para definir un agerClassBreakInfo | |
| |
Descripción | |
|
Resultado de geoprocesamiento
Hay dos maneras en las que se puede incluir un resultado de geoprocesamiento:
- Cuando se devuelva un resultado de geoprocesamiento como un conjunto de entidades y se dibuja como gráficos en el lado del cliente, envíe el resultado como un conjunto de entidades.
- Cuando el resultado se dibuja mediante el servicio de mapas de resultado de un trabajo, debe agregar una nueva capa de servicio de mapas en operationalLayers y establecer la propiedad URL para señalar el extremo del resultado. Por ejemplo:
- Resultado de geoprocesamiento de la versión 10.1 o posterior: https://gisserver.domain.com:6080/arcgis/rest/services/GPJobMapServiceName/MapServer/jobs/job_id
- Resultado de geoprocesamiento de la versión 10.0 y anteriores: https://gisserver.domain.com/arcgis/rest/services/GPServiceName/GPServer/GPTaskName/jobs/job_id/results/out_param_name
Ejemplo: resultado de geoprocesamiento como capa operacional que se dibuja a partir de un servicio de mapas de resultado del trabajo
"operationalLayers": [
{
"url": "https://gisserver.domain.com:6080/arcgis/rest/services/Buffer/MapServer/jobs/j9aa6c36d59f44829a0daeadb2d0ff87b",
"title": "Geoprocessing Result"
}
]
baseMap
El mapa contiene una propiedad baseMap que tiene un título, y una propiedad baseMapLayers que contiene una lista ordenada de baseMapLayers. Cada baseMapLayer debe estar en la misma referencia espacial y esquema de ordenamiento en teselas. Cuando hay una propiedad baseMap, esta define la referencia espacial del mapa.
Sintaxis para baseMap | Ejemplo |
---|---|
|
|
Sintaxis para una capa de teselas vectoriales como baseMapLayer | Ejemplo |
---|---|
Nota:Las capas de teselas vectoriales no se admiten en los Servicios de impresión publicados desde ArcGIS Pro.
|
|
Sintaxis para Bing Maps como basemapLayer | Ejemplo |
---|---|
|
|
Sintaxis de OpenStreetMap como basemapLayer | Ejemplo |
---|---|
|
|
Descripción | |
|
Sintaxis de WebTiledLayer como basemapLayer | Ejemplo |
---|---|
|
|
Descripción | |
|
Sintaxis para WMTS como basemapLayer |
---|
|
exportOptions
Este objeto especifica la configuración del mapa de salida.
Sintaxis | Ejemplo |
---|---|
|
|
Descripción | |
|
layoutOptions
Esto define la configuración para diferentes elementos de diseño de página disponibles y es necesario solo cuando se elige una plantilla de diseño disponibles. Los elemento de diseño de página incluyen el título, el texto de copyright, la barra de escala, el nombre de autor y los elementos de texto personalizados.
Nota:
Esta opción reemplaza las propiedades de los elementos existentes solamente. Si un elemento no existe en la plantilla de diseño que se ha elegido, las propiedades relacionadas se ignoran. Por ejemplo, si una plantilla de diseño no tiene un elemento de texto de copyright, no se agrega al diseño ningún elemento de texto de copyright nuevo aunque se especifique el elemento copyrightText en layoutOptions.
Todas las propiedades de este objeto son opcionales. Cuando se especifica un valor de una propiedad, el valor del elemento de diseño de página correspondiente se sustituye; de lo contrario, el elemento existente se mantiene intacto.
Elemento de texto ExportWebMap | Texto dinámico correspondiente en ArcGIS Pro |
---|---|
titleText | <dyn type="layout" property="metadata" attribute="title" emptyStr=""/> |
authorText | <dyn type="layout" property="metadata" attribute="contactname" emptyStr=""/> |
copyrightText | <dyn type="layout" property="metadata" attribute="credits" emptyStr=""/> |
Nota:
Puede documentarse sobre dynamicText en la Ayuda de ArcGIS para obtener más información.
Sintaxis | Ejemplo |
---|---|
|
|
Descripción | |
|
Limitaciones
Los símbolos a nivel de entidad que se invalidan en las capas de notas no son compatibles cuando el tipo de renderizador es de cortes de clase o simple.