Dodaj rysunek

Interfejs API automatyzacji rysowania umożliwia obecnie dodawanie w aplikacji ArcGIS Earth oznaczeń miejsc, ścieżek i poligonów. Rysunek może zawierać geometrię i symbol. Dodawanie rysunku do aplikacji ArcGIS Earth; zwracany jest identyfikator rysunku. Dodawane rysunki są zapisywane w folderze Moje rysunki w tabeli zawartości. W aplikacji ArcGIS Earth można nimi zarządzać i można je aktualizować.

Adres URL żądania

<baseUrl>/arcgisearth/Drawings(POST only)

Parametry żądania

Parametr	Opis
ID (opcjonalne)	Określa identyfikator rysunku. Typ: ciąg znakowy
visible (opcjonalne)	Wskazuje, czy rysunek jest widoczny w tabeli zawartości.
title (opcjonalne)	Tytuł rysunku.
geometry (wymagane)	Pozycja i typ geometrii rysunku. Definiuje formaty JSON geometrii i obiektów odniesień przestrzennych. Obsługa geometrii punktu, polilinii i poligonu. Parametry punktu: x Współrzędna X zmierzona wzdłuż osi wschód-zachód. Typ: podwójna precyzja y Współrzędna Y zmierzona wzdłuż osi północ-południe. Typ: podwójna precyzja spatialReference Odniesienie przestrzenne można określić za pomocą dobrze znanego identyfikatora (WKID). Lista właściwych wartości WKID znajduje się w temacie Układy współrzędnych i transformacje. Typ: ciąg znakowy Składnia JSON: {     "x": <x>,     "y": <y>,     "spatialReference": {         <spatialReference>     } } Parametry polilinii: paths Tablica ścieżek lub segmentów linii, które składają się na polilinię. Używane tylko w przypadku typu geometrii polilinii. Typ: liczba[][][] spatialReference Odniesienie przestrzenne można określić za pomocą dobrze znanego identyfikatora (WKID). Lista właściwych wartości WKID znajduje się w temacie Układy współrzędnych i transformacje. Typ: ciąg znakowy Składnia JSON: {   "paths": [[[<x11>, <y11>, <z11>],...,[<x1N>, <y1N>, <z1N>]], ,...,[[<xk1>, <yk1>, <zk1>] ,...,[<xkM>, <ykM>, <zkM>]]], "spatialReference":{  <spatialReference>  }  } Parametry poligonu: rings Tablica pierścieni. Typ: liczba[][][] spatialReference Odniesienie przestrzenne można określić za pomocą dobrze znanego identyfikatora (WKID). Lista właściwych wartości WKID znajduje się w temacie Układy współrzędnych i transformacje. Typ: ciąg znakowy Składnia JSON: {  "rings": [ [<x11>, <y11>, <z11>], ... [<x1N>, <y1N>, <z1N>] ], "spatialReference":{ <spatialReference> } }
symbol (opcjonalne)	Symbol rysunku. Wybór symbolu dla rysunku zależy od typu geometrii tego rysunku. type Typ symbolu. Możliwe wartości: „picture-marker”| „simple-line”| „simple-fill” Typ: ciąg znakowy url Służy do określania adresu URL lub ścieżki symbolu PictureMarkerSymbol. Używane tylko w przypadku symbolu PictureMarkerSymbol. Typ: ciąg znakowy size Szerokość symbolu obrazu w punktach. Używane tylko w przypadku symbolu PictureMarkerSymbol. Typ: liczba width Szerokość symbolu linii w punktach. Używane tylko w przypadku symboli SimpleLineSymbol i SimpleFillSymbol. Typ: liczba color Kolor symbolu. Typ: kolor outline Zarys symbolu SimpleFillSymbol. Typ: SimplelineSymbol
labelSymbol (opcjonalne)	Symbol tekstowy etykiety jest używany do dodawania etykiety do rysunku punktu. type Typ symbolu labelSymbol. Możliwe wartości: „text” Typ: ciąg znakowy color Kolor symbolu labelSymbol. Typ: kolor font Czcionka symbolu labelSymbol. Typ: czcionka Składnia JSON: { "type" : "text", "color" : <color>, "size" : <fontSize> }

Przykłady użycia

Poniżej przedstawiono przykładowe dane wejściowe służące do dodawania rysunku punktu:

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

Poniżej przedstawiono przykładowe dane wejściowe służące do dodawania rysunku linii:

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

Poniżej przedstawiono przykładowe dane wejściowe służące do dodawania rysunku poligonu:

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

Przykładowa odpowiedź JSON

Poniżej przedstawiono przykładową odpowiedź JSON dotyczącą dodawania rysunku:

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