Dodaj grafikę

Grafika to wektorowa reprezentacja zjawisk geograficznych świata rzeczywistego. Może ona obejmować geometrię i symbol. Dodaj grafikę do aplikacji ArcGIS Earth i zwróć identyfikator grafiki oraz informacje o niej.

Adres URL żądania

<baseUrl>/arcgisearth/graphics(POST only)

Parametry żądania

ParametrOpis

ID

(opcjonalne)

Określa identyfikator grafiki.

Typ: ciąg znakowy

geometry

(wymagane)

Pozycja i typ geometrii grafiki. Definiuje formaty JSON geometrii i obiektów odniesień przestrzennych. Obsługa geometrii punktu, polilinii i poligonu.

Parametry punktu:

  • type
    • Typ geometrii.
    • Możliwe wartości: „point”
    • Typ: ciąg znakowy
  • 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
  • latitude
    • Szerokość geograficzna punktu.
    • Typ: podwójna precyzja
  • longitude
    • Długość geograficzna punktu.
    • 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:

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

Parametry polilinii:

  • type
    • Typ geometrii.
    • Możliwe wartości: „polyline”
    • Typ: ciąg znakowy
  • paths
    • Tablica ścieżek lub segmentów linii, które składają się na polilinię. 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:

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

Parametry poligonu:

  • type
    • Typ geometrii. Pierwszy wierzchołek każdego pierścienia powinien być zawsze taki sam jak jego ostatni wierzchołek.
    • Możliwe wartości: „polygon”
    • Typ: ciąg znakowy
  • 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:

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

symbol

(opcjonalne)

Symbol grafiki. Wybór symbolu grafiki zależy od typu geometrii tej grafiki.

Typ: podwójna precyzja

  • 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. Tylko w przypadku symbolu PictureMarkerSymbol.
    • Typ: ciąg znakowy
  • width
    • Szerokość symbolu linii.
    • Typ: liczba
  • height
    • Wysokość symbolu w punktach. Tylko w przypadku symbolu PictureMarkerSymbol.
    • Typ: liczba
  • angle
    • Kąt znacznika względem ekranu (w stopniach). Tylko w przypadku symbolu PictureMarkerSymbol.
    • Typ: liczba
  • xoffset
    • Przesunięcie na osi x w punktach. Tylko w przypadku symbolu PictureMarkerSymbol.
    • Typ: liczba
  • color
    • Kolor symbolu.
    • Typ: kolor
  • outline
    • Zarys poligonu.
    • Typ: SimplelineSymbol

Przykłady użycia

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

{
  "id": " 4b75ea4a-e10f-d676-307d-aa945e2a0719", 
  "geometry": { 
		   "type": "polygon", 
     "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 
	   		} 
   } 
}

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

{
  "id": "polyline-simple-line-graphic",
  "geometry": {
         "type": "polyline",
         "paths": [
             [
                -118,
                34
              ],
             [
                -100,
                40
              ],
             [
                -82,
                34
              ]
          ]
       },
        "symbol": {
           "type": "simple-line",
           "color": "#33cc33",
           "width": "2px"
        }
 }

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

{
  "id": " 4b75ea4a-e10f-d676-307d-aa945e2a0719", 
  "geometry": { 
					"type": "polygon", 
                 "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ą grafiki punktowej:

{
    "id": "point-picture-marker-graphic",
    "geometry": {
        "x": -100,
        "y": 40,
        "type": "point"
    },
    "symbol": {
        "angle": 0,
        "height": 48,
        "type": "picture-marker",
        "url": "https://static.arcgis.com/images/Symbols/Shapes/BlackStarLargeB.png",
        "width": 48,
        "xoffset": 7.5,
        "yoffset": 7.5
    }
}

Poniżej przedstawiono przykładową odpowiedź JSON dotyczącą grafiki liniowej:

{
    "id": "polyline-simple-line-graphic",
    "geometry": {
        "paths": [
            [
                [
                    -118,
                    34
                ],
                [
                    -100,
                    40
                ],
                [
                    -82,
                    34
                ]
            ]
        ],
        "type": "polyline"
    },
    "symbol": {
        "color": [
            51,
            204,
            51,
            255
        ],
        "type": "simple-line",
        "width": 1.5
    }
}

Poniżej przedstawiono przykładową odpowiedź JSON dotyczącą grafiki poligonowej:

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

}