拡張された GeoJSON ジオメトリ

  • [アーティクル]

Azure Maps は、地理機能内で、または地理機能を併用して検索に役立つ API のリストを提供します。 これらの API は、地理的機能を表すための標準 GeoJSON 仕様 に準拠しています。

GeoJSON 仕様では、次のジオメトリのみがサポートされています。

  • GeometryCollection
  • LineString
  • MultiLineString
  • MultiPoint
  • MultiPolygon
  • ポイント
  • 多角形

一部の Azure Maps API は、GeoJSON specの一部ではないジオメトリを受け入れます。たとえば、Geometry API 内の検索では、円と多角形が受け入れられます。

この記事では、特定のジオメトリを表すために、Azure Maps が GeoJSON 仕様をどのように拡張するかについて詳細に説明します。

Circle

GeoJSON 仕様で Circle ジオメトリはサポートされていません。 GeoJSON Point Feature オブジェクトは、円を表すために使用されます。

GeoJSON Featureオブジェクトを使用して表されるCircleジオメトリには、次の座標とプロパティが含まれている必要があります。

座標 プロパティ
Center 円の中心は GeoJSON Point オブジェクトを使用して表します。
Radius 円の radius は GeoJSON Feature のプロパティを使用して表します。 半径値は、メートル 単位で、double 型である必要があります。
SubType 円ジオメトリには、subType プロパティも含める必要があります。 このプロパティは、GeoJSON Feature のプロパティに含まれ、その値は Circle である必要があります。

円の例

GeoJSON Feature オブジェクトを使用して円を表す方法は次のとおりです。 円の中心を緯度:47.639754 と経度 :-122.126986 に設定し、100メートルに等しい半径を割り当てます。

{
    "type": "Feature",
    "geometry": {
        "type": "Point",
        "coordinates": [-122.126986, 47.639754]
    },
    "properties": {
        "subType": "Circle",
        "radius": 100
    }
}

Rectangle

GeoJSON 仕様で Rectangle ジオメトリはサポートされていません。 GeoJSON Polygon Feature オブジェクトは、四角形を表すために使用されます。 四角形の拡張機能は、主に Web SDK の描画ツール モジュールによって使用されます。

GeoJSON Polygon Featureオブジェクトを使用して表されるRectangleジオメトリには、次の座標とプロパティが含まれている必要があります。

座標 プロパティ
Corners 四角形の角は、GeoJSON Polygon オブジェクトの座標を使用して表されます。 コーナーごとに1つずつ、5つの座標を指定する必要があります。 とは、最初の座標と同じ5番目の座標です。多角形リングを閉じます。 これらの座標が整合しており、開発者が必要に応じてそれらを回転できることが想定されます。
SubType 四角形ジオメトリには、subType プロパティも含める必要があります。 このプロパティは GeoJSON Feature のプロパティの一部である必要があり、その値は "四角形" である必要があります。

四角形の例

{
    "type": "Feature",
    "geometry": {
        "type": "Polygon",
        "coordinates": [[[5,25],[14,25],[14,29],[5,29],[5,25]]]
    },
    "properties": {
        "subType": "Rectangle"
    }
}

次のステップ

Azure Maps の GeoJSON データの詳細について学習します。

ジオフェンスの GeoJSON 形式

Azure Maps と位置情報インテリジェンス アプリケーションに関連する一般的な技術用語の用語集を確認します。

Azure Maps の用語集