Добавить графику

Графика - это векторное представление географических явлений реального мира. Она может содержать геометрию и символ. Добавить графику в ArcGIS Earth и вернуть идентификатор графики и информацию о ней.

URL запроса

<baseUrl>/arcgisearth/graphics(POST only)

Параметры запроса

ПараметрОписание

ID

(дополнительно)

Задает ID графики.

Тип: string

geometry

(необходимо)

Положение и тип геометрии графики. Задает формат JSON геометрии и объекты пространственной привязки. Поддерживает точечную, линейную и полигональную геометриию.

Параметры точек:

  • type
    • Тип геометрии.
    • Возможные значения: "point"
    • Тип: string
  • x
    • Координата x измеряется по оси восток – запад.
    • Тип: double
  • y
    • Координата y измеряется по оси север – юг.
    • Тип: double
  • latitude
    • Широта точки.
    • Тип: double
  • longitude
    • Долгота точки.
    • Тип: double
  • spatialReference

Синтаксис JSON:

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

Параметры полилиний:

  • type
    • Тип геометрии.
    • Возможные значения: "polyline"
    • Тип: string
  • paths
    • Массив путей или участков линии, составляющих полилинию. Только для полилинейного типа геометрии.
    • Тип: number[][][]
  • spatialReference

Синтаксис JSON:

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

Параметры полигона:

  • type
    • Тип геометрии. Первая вершина каждого кольца должна совпадать с последней.
    • Возможные значения: "polygon"
    • Тип: string
  • rings
    • Массив колец.
    • Тип: number[][][]
  • spatialReference

Синтаксис JSON:

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

symbol

(дополнительно)

Символ для графики. Выбор символа графики зависит от типа геометрии графики.

Тип: double

  • type
    • Тип символа.
    • Возможные значения: "picture-marker"| "simple-line"| "simple-fill"
    • Тип: string
  • url
    • Задает URL или путь PictureMarkerSymbol. Только для PictureMarkerSymbol.
    • Тип: string
  • width
    • Ширина символа линии.
    • Тип: number
  • height
    • Высота символа в точках. Только для PictureMarkerSymbol.
    • Тип: number
  • angle
    • Угол маркера относительно экрана в градусах. Только для PictureMarkerSymbol.
    • Тип: number
  • xoffset
    • Смещение по оси x в точках. Только для PictureMarkerSymbol.
    • Тип: number
  • color
    • Цвет символа.
    • Тип: color
  • outline
    • Контур полигона.
    • Тип: SimplelineSymbol

Пример использования

Ниже приведен пример входных данных для добавления точечной графики:

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

Ниже приведен пример входных данных для добавления линейной графики:

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

Ниже приведен пример ввода для добавления полигональной графики:

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

Пример ответа JSON

Ниже приведен пример ответа JSON для добавления точечной графики:

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

Ниже приведен пример ответа JSON для добавления линейной графики:

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

Ниже приведен пример ответа JSON для добавления полигональной графики:

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

}