拡張された 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 データの詳細について学習します。
Azure Maps と位置情報インテリジェンス アプリケーションに関連する一般的な技術用語の用語集を確認します。