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

С помощью Automation API в ArcGIS Earth можно добавить отметку, путь или полигон. Графика может содержать геометрию и символ. Добавление графики в ArcGIS Earth, которое возвращает ID графики. После успешного добавления, графика сохраняется в папке Моя графика в таблице содержания, вы можете управлять и обновлять ее в ArcGIS Earth.

URL запроса

<baseUrl>/arcgisearth/Drawings(POST only)

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

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

ID

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

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

Тип: string

visible

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

Показывает, отображается ли графика в таблице содержания.

title

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

Название графики.

geometry

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

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

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

  • x
    • Координата x измеряется по оси восток – запад.
    • Тип: double
  • y
    • Координата y измеряется по оси север – юг.
    • Тип: double
  • spatialReference

Синтаксис JSON:

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

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

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

Синтаксис JSON:

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

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

  • rings
    • Массив колец.
    • Тип: number[][][]
  • spatialReference

Синтаксис JSON:

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

symbol

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

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

  • type
    • Тип символа.
    • Возможные значения: "picture-marker"| "simple-line"| "simple-fill"
    • Тип: string
  • url
    • Задает URL или путь PictureMarkerSymbol. Только для PictureMarkerSymbol.
    • Тип: string
  • size
    • Ширина картинки символа в точках. Только для PictureMarkerSymbol.
    • Тип: number
  • width
    • Ширина линейного символа в точках. Только для SimpleLineSymbol и SimpleFillSymbol.
    • Тип: number
  • color
    • Цвет символа.
    • Тип: color
  • outline
    • Рамка для SimpleFillSymbol.
    • Тип: SimplelineSymbol

labelSymbol

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

Символ текстовой надписи используется для добавления надписи к точечной графике.

  • type
    • Тип labelSymbol.
    • Возможные значения: "text"
    • Тип: string
  • color
    • Цвет для labelSymbol.
    • Тип: color
  • font
    • Шрифт для labelSymbol.
    • Тип: Font

Синтаксис JSON:

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

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

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

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

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

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

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

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

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

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

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