Agregar dibujo

Con la API de dibujo de Automatización, puede agregar marcadores de posición, rutas y polígonos a ArcGIS Earth. El dibujo puede contener geometría y un símbolo. Agregue a ArcGIS Earth un dibujo que devolverá el Id. de dibujo. Los dibujos se guardarán en la carpeta Mis dibujos de la tabla de contenido una vez se hayan agregado correctamente, y puede administrarlos y actualizarlos en ArcGIS Earth.

Dirección URL de solicitud

<baseUrl>/arcgisearth/Drawings(POST only)

Parámetros de solicitud

ParámetroDescripción

ID

(opcional)

Especifica el Id. de un dibujo.

Tipo: cadena de caracteres

visible

(opcional)

Indica si el dibujo está visible en la tabla de contenido.

title

(opcional)

El título del dibujo.

geometry

(necesario)

La posición y el tipo de geometría de un dibujo. Define los formatos JSON de los objetos de geometría y de referencia espacial. Admite geometría de punto, polilínea y polígono.

Parámetros de punto:

  • x
    • Coordenada x medida a lo largo del eje este-oeste.
    • Tipo: doble
  • y
    • Coordenada y medida a lo largo del eje norte-sur.
    • Tipo: doble
  • spatialReference

Sintaxis JSON:

{ 
    "x": <x>, 
    "y": <y>, 
    "spatialReference": { 
        <spatialReference> 
    } 
}

Parámetros de polilínea:

  • paths
    • Un conjunto de rutas, o segmentos de línea, que conforman la polilínea. Solo para la geometría de tipo polilínea.
    • Tipo: number[][][]
  • spatialReference

Sintaxis JSON:

{ 
 "paths": [[[<x11>, <y11>, <z11>],...,[<x1N>,
<y1N>, <z1N>]],
,...,[[<xk1>, <yk1>, <zk1>]
,...,[<xkM>, <ykM>, <zkM>]]],                               
"spatialReference":{ 
<spatialReference> 
} 
}

Parámetros de polígono:

  • rings
    • Una matriz de anillos.
    • Tipo: number[][][]
  • spatialReference

Sintaxis JSON:

{ 
   "rings": [ 
        [<x11>, <y11>, <z11>], 
        ...
        [<x1N>, <y1N>, <z1N>] 
     ], 
    "spatialReference":{
        <spatialReference> 
    } 
}

symbol

(opcional)

El símbolo del dibujo. La elección de un símbolo para un dibujo depende del tipo de geometría del dibujo.

  • type
    • El tipo de símbolo.
    • Valores posibles: "picture-marker"| "simple-line"| "simple-fill"
    • Tipo: cadena de caracteres
  • url
    • Especifica la URL o la ruta de un PictureMarkerSymbol. Solo para PictureMarkerSymbol.
    • Tipo: cadena de caracteres
  • size
    • El ancho del símbolo de imagen en puntos. Solo para PictureMarkerSymbol.
    • Tipo: número
  • width
    • El ancho del símbolo de línea en puntos. Solo para SimpleLineSymbol y SimpleFillSymbol.
    • Tipo: número
  • color
    • El color del símbolo.
    • Tipo: color
  • outline
    • El contorno de SimpleFillSymbol.
    • Tipo: SimplelineSymbol

labelSymbol

(opcional)

El símbolo de texto de etiqueta se utiliza para agregar una etiqueta a un dibujo de puntos.

  • type
    • El tipo labelSymbol.
    • Valores posibles: "text"
    • Tipo: cadena de caracteres
  • color
    • El color de labelSymbol.
    • Tipo: color
  • font
    • La fuente de labelSymbol.
    • Tipo: fuente

Sintaxis JSON:

{ 
 "type" : "text", 
  "color" : <color>, 
  "size" : <fontSize> 
}

Uso de ejemplo

Lo que sigue es una entrada de muestra para agregar un dibujo de puntos:

{
  "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
    }
}

Lo que sigue es una entrada de muestra para agregar un dibujo de líneas:

{
  "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"
        }
 }

Lo que sigue es una entrada de muestra para agregar un dibujo de polígonos:

{
  "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 
         } 
     } 
}

Ejemplo de respuesta JSON

Lo que sigue es un ejemplo de respuesta JSON para agregar un dibujo:

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