Ajouter un dessin

Avec l’API de dessin d’automatisation, vous pouvez ajouter des repères, des chemins et des polygones dans ArcGIS Earth. Le dessin peut contenir une géométrie et un symbole. Ajoutez un dessin à ArcGIS Earth qui retournera l’ID du dessin. Les dessins sont enregistrés dans le dossier My Drawings (Mes dessins) de la table des matières une fois que leur ajout a abouti, et vous pouvez les gérer et les mettre à jour dans ArcGIS Earth.

URL de la requête

<baseUrl>/arcgisearth/Drawings(POST only)

Paramètres de requête

Paramètre	Description
ID (facultatif)	Spécifie l’ID d’un dessin. Type : chaîne
visible (facultatif)	Indique si le dessin est visible dans la table des matières.
title (facultatif)	Titre du dessin.
geometry (obligatoire)	Position et type de géométrie d’un dessin. Définit les formats JSON des objets géométrie et référence spatiale. Prend en charge la géométrie de type point, polyligne et polygone. Paramètres de point : x Coordonnée X mesurée le long de l’axe est-ouest. Type : double y Coordonnée Y mesurée le long de l’axe nord-sud. Type : double spatialReference Vous pouvez définir la référence spatiale à l’aide d’un ID bien connu (WKID). Pour obtenir une liste de valeurs WKID valides, reportez-vous à la rubrique Coordinate systems and transformations. Type : chaîne Syntaxe JSON : {     "x": <x>,     "y": <y>,     "spatialReference": {         <spatialReference>     } } Paramètres de polyligne : paths Matrice de chemins, ou segments linéaires, constituant une polyligne. Concerne uniquement la géométrie de type polyligne. Type : number[][][] spatialReference Vous pouvez définir la référence spatiale à l’aide d’un ID bien connu (WKID). Pour obtenir une liste de valeurs WKID valides, reportez-vous à la rubrique Coordinate systems and transformations. Type : chaîne Syntaxe JSON : {   "paths": [[[<x11>, <y11>, <z11>],...,[<x1N>, <y1N>, <z1N>]], ,...,[[<xk1>, <yk1>, <zk1>] ,...,[<xkM>, <ykM>, <zkM>]]], "spatialReference":{  <spatialReference>  }  } Paramètres de polygone : rings Matrice d’anneaux. Type : number[][][] spatialReference Vous pouvez définir la référence spatiale à l’aide d’un ID bien connu (WKID). Pour obtenir une liste de valeurs WKID valides, reportez-vous à la rubrique Coordinate systems and transformations. Type : chaîne Syntaxe JSON : {  "rings": [ [<x11>, <y11>, <z11>], ... [<x1N>, <y1N>, <z1N>] ], "spatialReference":{ <spatialReference> } }
symbol (facultatif)	Symbole du dessin. Le choix d’un symbole pour un dessin dépend du type de géométrie du dessin. type Type de symbole. Valeurs possibles : « picture-marker »| « simple-line »| « simple-fill » Type : chaîne url Spécifie l’URL ou le chemin d’un PictureMarkerSymbol. Concerne uniquement PictureMarkerSymbol. Type : chaîne size Largeur du symbole d’image en points. Concerne uniquement PictureMarkerSymbol. Type : nombre width Largeur du symbole de ligne en points. Concerne uniquement SimpleLineSymbol et SimpleFillSymbol. Type : nombre color Couleur du symbole. Type : couleur outline Contour du SimpleFillSymbol. Type : SimplelineSymbol
labelSymbol (facultatif)	Le symbole textuel d’étiquette sert à ajouter une étiquette à un dessin de points. type Type labelSymbol. Valeurs possibles : « text » Type : chaîne color Couleur du labelSymbol. Type : couleur font Police du labelSymbol. Type : police Syntaxe JSON : { "type" : "text", "color" : <color>, "size" : <fontSize> }

Exemple d’utilisation

Voici un exemple d’entrée pour l’ajout d’un dessin de points :

{
  "id": "4b75ea4a-e10f-d676-307d-aa945e2a0712",
  "visible": true,
  "title": "addPoint",
  "geometry": {
      "x": -100,
      "y": 40,
      "spatialReference": {"wkid": 4326}
      },
   "symbol": {
       "type": "picture-marker",
       "url":"https://static.arcgis.com/images/Symbols/Shapes/BlackStarLargeB.png",
       "size": "64px"
      },
   "labelSymbol":{
        "type":"text",
        "color": [76,115,0,255],
        "size":12
    }
}

Voici un exemple d’entrée pour l’ajout d’un dessin linéaire :

{
  "id": "4b75ea4a-e10f-d676-307d-aa945e2a071922",
  "visible": true,
  "title": "addLine",
  "geometry": {
         "paths": [
             [
                -118,
                34
              ],
             [
                -100,
                40
              ],
             [
                -82,
                34
              ]
          ],
        "spatialReference": {"wkid": 4326}
       },
  "symbol": {
         "type": "simple-line",
         "color": "#33cc33",
         "width": "2px"
        }
 }

Voici un exemple d’entrée pour l’ajout d’un dessin surfacique :

{
  "id": " 4b75ea4a-e10f-d676-307d-aa945e2a0719", 
  "visible": true,
  "title": "addPolygon",
  "geometry": {  
       "rings": [[ 
           [-96.06138,32.837], 
	          [-97.06133,34.836], 
	          [-98.06124,34.834], 
         	 [-97.06127,32.832], 
	          [-97.06138,32.837] 
       ]], 
       "spatialReference": {"wkid": 4326} 
    }, 
  "symbol": { 
        "type": "simple-fill", 
        "color": [76,115,0,255], 
        "outline": { 
	  "color": [110,110,110,255], 
	  "width": 1 
         } 
     } 
}

Exemple de réponse JSON

Voici un exemple de réponse JSON pour l’ajout d’un dessin :

{
  "id": "4b75ea4a-e10f-d676-307d-aa945e2a0712",
  "result": "Success"
}