Lorsque vous tentez d’imprimer une carte à l’aide du service de géotraitement PrintingTools inclus avec ArcGIS Server, vous devez fournir une représentation JavaScript Object Notation (JSON) de la carte comportant les informations liées à la couche et à l’étendue. La représentation JSON doit être structurée conformément à la spécification Esri ExportWebMap.
Lorsque vous utilisez les API Web ArcGIS vous n'avez pas besoin de vous préoccuper de la création de la JSON, car les API s'en chargent. Cette rubrique est néanmoins fournie à titre de référence, au cas où vous auriez besoin de créer la JSON vous-même. Cela peut être le cas si vous avez besoin d’appeler le service PrintingTools directement ou d’exécuter son outil de géotraitement source Exporter la carte Web à partir d’une autre application.
Remarque :
Pour des raisons de clarté et de lecture, les exemples de JSON de cette rubrique sont formatés. Cependant, en pratique, vous devez transmettre la JSON non formatée via les services d’impression.
Nouveautés dans la version 11.0
- Prise en charge permettant d’activer ou de désactiver la visibilité d’un élément de flèche d’orientation vers le nord dans une mise en page. Pour cela, vous devez utiliser elementOverrides dans layoutOptions.
Remarque :
Vous pouvez utiliser une tâche GetLayoutTemplateInfos d’impression de service pour savoir si un modèle de mise en page comporte une flèche d’orientation vers le nord.
La carte Web est constituée de cinq objets de niveau supérieur :
{
"mapOptions": {},
"operationalLayers": [],
"baseMap": [],
"exportOptions": {},
"layoutOptions": {}
}
mapOptions
L’objet mapOptions, obligatoire, définit les propriétés d’affichage cartographique.
Syntaxe : | Exemple |
---|---|
|
|
Description | |
|
operationalLayers
La liste operationalLayers contient toutes les couches opérationnelles à afficher sur la carte. L'ordre du tableau définit l'ordre des couches sur la carte. Le type de chaque couche est défini par la réponse de la ressource URL. S'il est impossible de déterminer la ressource à partir de l'URL, la propriété type définit le type. Par exemple, avec une couche WMS, vous devez spécifier "type": "wms" Certaines propriétés sont communes à tous les types de couches opérationnelles, alors que d'autres sont spécifiques à chaque type de couche opérationnelle.
Dans le cas de couches sécurisées, précisez le jeton dans une définition de couches. Le nom d'utilisateur et le mot de passe ne sont pas pris en charge en tant que partie de l'URL.
Remarque :
Pour un service de carte, un service d'entités ou un service d'imagerie, utilisez une URL pointant vers le point de terminaison REST du service. Les points de terminaison SOAP ne sont pas pris en charge.
Syntaxe des couches opérationnelles |
---|
|
Description |
Remarque :Les propriétés décrites ci-dessous sont communes à tous les types de couches opérationnelles (par exemple, les couches de service de carte, les graphiques côté client, les couches KML, etc.). Ainsi, il est possible qu'elles ne soient pas incluses dans cette section pour chaque type de couche opérationnelle.
|
Syntaxe d'une couche de service de carte | Exemple |
---|---|
|
|
Description | |
|
Syntaxe d'une couche d'entités | Exemple |
---|---|
|
|
Description | |
|
Syntaxe d'une couche de service d'imagerie | Exemple |
---|---|
|
|
Description | |
Remarque :Reportez-vous à la rubrique API REST d'ArcGIS pour obtenir plus d'informations sur les couches de service d'imagerie. |
Syntaxe d'une couche de service WMS | |
---|---|
| |
Description | |
|
Syntaxe d'une couche KML | Exemple |
---|---|
|
|
Description | |
|
Syntaxe d'une image côté client | Exemple |
---|---|
|
|
Description | |
|
Syntaxe des graphiques côté client | Exemple | |
---|---|---|
|
| |
Description | ||
|
Syntaxe du fichier CSV (valeurs séparées par des virgules) par URL | Exemple | |
---|---|---|
|
| |
Description | ||
|
Autres propriétés
Remarque :
Reportez-vous à la rubrique ArcGIS REST API pour plus d’informations sur les propriétés suivantes.
- source
- renderer
- symbol
- textSymbol
- labelingInfo
- geometry
- geometryType
- spatialRel
- relationParam
Syntaxe de définition de drawingInfo pour un moteur de rendu temporel | Exemple |
---|---|
Remarque :Le moteur de rendu temporel n’est pas pris en charge par les services d’impression publiés depuis ArcGIS Pro.
|
|
Syntaxe de définition d’une propriété symbolAger | |
| |
Syntaxe de définition d’une propriété agerClassBreakInfo | |
| |
Description | |
|
Résultat du géotraitement
Il existe deux façons d'inclure un résultat de géotraitement :
- Lorsque le résultat d'un géotraitement revient sous la forme d'un jeu d'entités et qu'il s'affiche sous la forme de graphiques côté client, envoyez le résultat en tant que collection d'entités.
- Lorsque le résultat est affiché par le service de carte de résultat d’une tâche, ajoutez une nouvelle couche de service de carte dans operationalLayers et définissez la propriété URL de manière à ce qu’elle pointe sur le point de terminaison du résultat. Par exemple :
- Résultat du géotraitement du serveur 10.1 ou version ultérieure : https://gisserver.domain.com:6080/arcgis/rest/services/GPJobMapServiceName/MapServer/jobs/job_id
- Résultat du géotraitement du serveur 10.0 et versions antérieures : https://gisserver.domain.com/arcgis/rest/services/GPServiceName/GPServer/GPTaskName/jobs/job_id/results/out_param_name
Exemple : Résultat du géotraitement en tant que couche opérationnelle affichée par un service de carte de résultat de tâche.
"operationalLayers": [
{
"url": "https://gisserver.domain.com:6080/arcgis/rest/services/Buffer/MapServer/jobs/j9aa6c36d59f44829a0daeadb2d0ff87b",
"title": "Geoprocessing Result"
}
]
baseMap
La carte contient une propriété baseMap, dotée d’un titre, et une propriété baseMapLayers qui contient une liste triée de baseMapLayers. Chaque propriété baseMapLayer doit être exprimée dans la même référence spatiale et la même structure de tuilage. Lorsqu’une propriété baseMap est présente, elle définit la référence spatiale de la carte.
Syntaxe de baseMap | Exemple |
---|---|
|
|
Syntaxe pour couche de tuiles vectorielles en tant que baseMapLayer | Exemple |
---|---|
Remarque :Les couches de tuiles vectorielles fonctionnent uniquement avec les services d’impression publiés depuis ArcGIS Pro.
|
|
Syntaxe pour Bing Maps en tant que basemapLayer | Exemple |
---|---|
|
|
Syntaxe pour OpenStreetMap en tant que basemapLayer | Exemple |
---|---|
|
|
Description | |
|
Syntaxe pour WebTiledLayer en tant que basemapLayer | Exemple |
---|---|
|
|
Description | |
|
Syntaxe pour WMTS en tant que basemapLayer |
---|
|
exportOptions
Cet objet spécifie les paramètres pour la carte en sortie.
Syntaxe | Exemple |
---|---|
|
|
Description | |
|
layoutOptions
Cette propriété définit les paramètres des différents éléments de mise en page disponibles. Elle est nécessaire uniquement lorsqu'un modèle de mise en page disponible est choisi. Ces éléments de mise en page sont notamment le titre, le texte de droit d'auteur, la barre d'échelle, le nom de l'auteur et les éléments de texte personnalisés.
Remarque :
Cette option remplace les propriétés d'éléments existants uniquement. Si un élément n'existe pas dans le modèle de mise en page choisi, les propriétés associées sont ignorées. Par exemple, si un modèle de mise en page ne possède pas d’élément de texte de droit d’auteur, aucun nouvel élément de texte de droit d’auteur n’est ajouté, même si l’élément copyrightText est spécifié dans la propriété layoutOptions.
Toutes les propriétés de cet objet sont facultatives. Quand la valeur d'une propriété est spécifiée, la valeur de l'élément de mise en page correspondante est remplacée. Dans le cas contraire, l'élément existant reste tel quel.
Elément de texte ExportWebMap | Texte dynamique correspondant dans 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=""/> |
Remarque :
Pour plus d’informations, consultez la rubrique concernant dynamicText dans l’aide ArcGIS.
Syntaxe | Exemple |
---|---|
|
|
Description | |
|
Limitations
Les symboles de niveau d'entités dans les couches de notes ne sont pas pris en charge lorsque le type de moteur de rendu est interruptions de classe ou simple.
Vous avez un commentaire à formuler concernant cette rubrique ?