描画の追加

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
    • Well Known ID (WKID) を使用して空間参照を定義できます。 有効な WKID 値のリストは、「座標系と変換」をご参照ください。
    • タイプ: string

JSON 構文:

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

ポリライン パラメーター:

  • paths
    • ポリラインを構成するパスの配列またはライン セグメント。 ポリライン タイプのジオメトリにのみ適用されます。
    • タイプ: 数値[][][]
  • spatialReference
    • Well Known ID (WKID) を使用して空間参照を定義できます。 有効な WKID 値のリストは、「座標系と変換」をご参照ください。
    • タイプ: string

JSON 構文:

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

ポリゴン パラメーター:

  • rings
    • リングの配列。
    • タイプ: 数値[][][]
  • spatialReference
    • Well Known ID (WKID) を使用して空間参照を定義できます。 有効な WKID 値のリストは、「座標系と変換」をご参照ください。
    • タイプ: string

JSON 構文:

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

symbol

(オプション)

描画のシンボル。 描画のシンボルの選択は、描画のシンボル タイプによって異なります。

  • type
    • シンボル タイプ。
    • 指定可能な値: "ピクチャ マーカー"| "シンプル ライン"| "シンプル塗りつぶし"
    • タイプ: string
  • url
    • PictureMarkerSymbol の URL またはパスを指定します。 PictureMarkerSymbol にのみ適用されます。
    • タイプ: string
  • size
    • ピクチャ シンボルの幅 (ポイント単位)。 PictureMarkerSymbol にのみ適用されます。
    • タイプ: 数値
  • width
    • ライン シンボルの幅 (ポイント単位)。 SimpleLineSymbol と SimpleFillSymbol にのみ適用されます。
    • タイプ: 数値
  • color
    • シンボルの色。
    • タイプ: 色
  • outline
    • SimpleFillSymbol のアウトライン。
    • タイプ: SimplelineSymbol

labelSymbol

(オプション)

ラベル テキスト シンボルは、ポイント描画にラベルを追加するために使用します。

  • type
    • labelSymbol のタイプ。
    • 指定可能な値: "text"
    • タイプ: string
  • color
    • labelSymbol の色。
    • タイプ: 色
  • font
    • labelSymbol のフォント。
    • タイプ: フォント

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