Zeichnung hinzufügen

Mit der Automatisierungs-API für Zeichnungen können Sie Ortsmarken, Pfade und Polygone in ArcGIS Earth hinzufügen. Die Zeichnung kann Geometrie und ein Symbol enthalten. Fügen Sie eine Zeichnung zu ArcGIS Earth hinzu, deren Zeichnungs-ID zurückgegeben wird. Zeichnungen werden im Ordner Eigene Zeichnungen im Inhaltsverzeichnis gespeichert, sobald dieses erfolgreich hinzugefügt wurde. Sie können die Zeichnungen in ArcGIS Earth verwalten und aktualisieren.

Anforderungs-URL

<baseUrl>/arcgisearth/Drawings(POST only)

Anforderungsparameter

ParameterBeschreibung

ID

(optional)

Gibt die ID einer Zeichnung an.

Typ: String

visible

(optional)

Gibt an, ob die Zeichnung im Inhaltsverzeichnis sichtbar ist.

title

(optional)

Titel für die Zeichnung.

geometry

(erforderlich)

Position und Geometrietyp einer Zeichnung. Damit werden die JSON-Formate der Geometrie und Raumbezugsobjekte definiert. Unterstützt Punkt-, Polylinien- und Polygon-Geometrie.

Punktparameter:

  • x
    • X-Koordinate, gemessen entlang der Ost-West-Achse.
    • Typ: Double
  • y
    • Y-Koordinate, gemessen entlang der Nord-Süd-Achse.
    • Typ: Double
  • spatialReference

JSON-Syntax:

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

Polylinienparameter:

  • paths
    • Eine Gruppe von Pfaden oder Liniensegmenten, aus denen die Polylinie besteht. Nur für den Geometrietyp Polylinie.
    • Typ: Number[][][]
  • spatialReference

JSON-Syntax:

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

Polygonparameter:

  • rings
    • Array von Ringen.
    • Typ: Number[][][]
  • spatialReference

JSON-Syntax:

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

symbol

(optional)

Symbol für die Zeichnung. Die Auswahl eines Symbols für eine Zeichnung hängt vom Geometrietyp der Zeichnung ab.

  • type
    • Symboltyp.
    • Mögliche Werte: "picture-marker"| "simple-line"| "simple-fill"
    • Typ: String
  • url
    • Gibt die URL oder den Pfad eines PictureMarkerSymbol-Features an. Nur für PictureMarkerSymbol.
    • Typ: String
  • size
    • Breite des Bildsymbols in Punkt. Nur für PictureMarkerSymbol.
    • Typ: Number
  • width
    • Breite des Liniensymbols in Punkt. Nur für SimpleLineSymbol und SimpleFillSymbol.
    • Typ: Number
  • color
    • Farbe des Symbols.
    • Typ: Color
  • outline
    • Umriss von SimpleFillSymbol.
    • Typ: SimplelineSymbol

labelSymbol

(optional)

Das Symbol für den Beschriftungstext wird zum Hinzufügen einer Beschriftung zu einer Punktzeichnung verwendet.

  • type
    • labelSymbol-Typ.
    • Mögliche Werte: "text"
    • Typ: String
  • color
    • Farbe von labelSymbol.
    • Typ: Color
  • font
    • Schriftart von labelSymbol.
    • Typ: Font

JSON-Syntax:

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

Beispiel für die Verwendung

Im Folgenden ist ein Beispiel für eine Eingabe zum Hinzufügen einer Punktzeichnung dargestellt:

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

Im Folgenden ist ein Beispiel für eine Eingabe zum Hinzufügen einer Linienzeichnung dargestellt:

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

Im Folgenden ist ein Beispiel für eine Eingabe zum Hinzufügen einer Polygonzeichnung dargestellt:

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

Beispiel für eine JSON-Antwort

Im Folgenden ist ein Beispiel für eine JSON-Antwort zum Hinzufügen einer Zeichnung dargestellt:

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