WFS - Get Feature
を使用して、特定のコレクション内の機能の詳細を取得します。
Get Feature API は、特定のコレクション内の指定された機能の詳細を返す HTTP GET 要求です。
WFS API は 、Open Geospatial Consortium API standard for Features に従って データセットにクエリを実行します。
データセットは、複数の特徴コレクションで構成されます。 フィーチャー コレクションは、共通スキーマに基づく、同様の型の特徴のコレクションです。
機能の取得要求を送信する
GET https://{geography}.atlas.microsoft.com/wfs/datasets/{datasetId}/collections/{collectionId}/items/{featureId}?api-version=2.0URI パラメーター
| 名前 | / | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
collection
|
path | True |
string |
特定のコレクションの識別子 (名前) |
|
dataset
|
path | True |
string |
クエリの対象となるデータセットの識別子。 |
|
feature
|
path | True |
string |
特定の機能のローカル識別子 |
|
geography
|
path | True |
string |
このパラメーターは、Azure Maps Creator リソースの場所を指定します。 有効な値は、us と eu です。 |
|
api-version
|
query | True |
string |
Azure Maps API のバージョン番号。 |
応答
| 名前 | 型 | 説明 |
|---|---|---|
| 200 OK |
OK |
|
| Other Status Codes |
予期しないエラーが発生しました。 |
セキュリティ
AADToken
これらは OAuth 2.0 フロー Microsoft Entraです。 Azure ロールベースのアクセス制御と組み合わせて使用すると、Azure Maps REST API へのアクセスを制御できます。 Azure ロールベースのアクセス制御は、1 つ以上のAzure Mapsリソース アカウントまたはサブリソースへのアクセスを指定するために使用されます。 REST API をAzure Mapsするための 1 つ以上のアクセス許可で構成される組み込みロールまたはカスタム ロールを使用して、ユーザー、グループ、またはサービス プリンシパルにアクセス権を付与できます。
シナリオを実装するには、 認証の概念を表示することをお勧めします。 要約すると、このセキュリティ定義は、特定の API とスコープに対するアクセス制御が可能なオブジェクトを使用してアプリケーションをモデル化するためのソリューションを提供します。
メモ
- このセキュリティ定義では、 ヘッダーを使用して、
x-ms-client-idアプリケーションがアクセスを要求しているリソースAzure Maps示す必要があります。 これは、 Maps 管理 API から取得できます。
は Authorization URL 、Azure パブリック クラウド インスタンスに固有です。 ソブリン クラウドには、固有の承認 URL とMicrosoft Entra ID構成があります。
* Azure ロールベースのアクセス制御は、Azure portal、PowerShell、CLI、Azure SDK、または REST API を介して Azure 管理プレーンから構成されます。
* Azure Maps Web SDK を使用すると、複数のユース ケースに対してアプリケーションを構成ベースで設定できます。
- Microsoft ID プラットフォームの詳細については、「Microsoft ID プラットフォームの概要」を参照してください。
型:
oauth2
フロー:
implicit
Authorization URL (承認 URL):
https://login.microsoftonline.com/common/oauth2/authorize
スコープ
| 名前 | 説明 |
|---|---|
| https://atlas.microsoft.com/.default | https://atlas.microsoft.com/.default |
subscription-key
これは、Azure portalでAzure Maps アカウントを作成するとき、または PowerShell、CLI、Azure SDK、または REST API を使用してプロビジョニングされる共有キーです。
このキーを使用すると、すべてのアプリケーションですべての REST API にアクセスできます。 つまり、このキーは、発行先のアカウントのマスター キーとして使用できます。
公開されているアプリケーションの場合は、機密クライアント アプリケーション のアプローチを使用して、キーを安全に格納できるように、Azure Maps REST API にアクセスすることをお勧めします。
型:
apiKey
/:
query
SAS Token
これは、Azure portal、PowerShell、CLI、Azure SDK、または REST API を介して Azure 管理プレーンを介して、Azure Maps リソースの List SAS 操作から作成される共有アクセス署名トークンです。
このトークンを使用すると、すべてのアプリケーションが Azure ロールベースのアクセス制御を使用してアクセスし、特定のトークンに使用される有効期限、レート、およびリージョンに対するきめ細かい制御が許可されます。 言い換えると、SAS トークンを使用して、アプリケーションが共有キーよりもセキュリティで保護された方法でアクセスを制御できます。
公開されているアプリケーションの場合、 Map アカウント リソース で許可される配信元の特定のリストを構成して、レンダリングの不正使用を制限し、SAS トークンを定期的に更新することをお勧めします。
型:
apiKey
/:
header
例
GetFeature
要求のサンプル
GET https://us.atlas.microsoft.com/wfs/datasets/218fda98-e638-0edf-5ef7-28491ff3bed4/collections/unit/items/UNIT39?api-version=2.0
応答のサンプル
{
"ontology": "Facility-2.0",
"feature": {
"type": "Feature",
"geometry": {
"type": "Polygon",
"coordinates": [
[
[
139.6330405782921,
35.45768668610856
],
[
139.63296283234274,
35.45778390425868
],
[
139.63308672404617,
35.45785022906202
],
[
139.6331451691671,
35.45777714569986
],
[
139.6331274703629,
35.45776767074717
],
[
139.63314677109963,
35.45774353588138
],
[
139.6330405782921,
35.45768668610856
]
]
]
},
"properties": {
"originalId": "ddbbb583-4621-4e11-8859-299d1057e843",
"categoryId": "CTG10",
"isOpenArea": false,
"navigableBy": [
"pedestrian"
],
"isRoutable": false,
"routeThroughBehavior": "allowed",
"nonPublic": false,
"levelId": "LVL18",
"occupants": [],
"addressId": "DIR16",
"addressRoomNumber": "",
"name": "21N13",
"nameSubtitle": "",
"nameAlt": ""
},
"id": "UNIT39",
"featureType": ""
},
"links": [
{
"href": "https://us.atlas.microsoft.com/wfs/dataset/218fda98-e638-0edf-5ef7-28491ff3bed4/collections/unit/items/UNIT39?api-version=2.0",
"rel": "self"
},
{
"href": "https://us.atlas.microsoft.com/wfs/dataset/218fda98-e638-0edf-5ef7-28491ff3bed4/collections/unit?api-version=2.0",
"rel": "data"
}
]
}定義
| 名前 | 説明 |
|---|---|
|
Error |
リソース管理エラーの追加情報。 |
|
Error |
エラーの詳細。 |
|
Error |
エラー応答 |
|
Feature |
|
|
Geo |
有効な |
|
Geo |
有効な |
|
Geo |
有効な |
|
Geo |
有効な |
|
Geo |
有効な |
|
Geo |
有効な |
|
Geo |
有効な |
|
Geo |
種類を |
|
Geo |
有効な |
|
Geo |
有効な |
|
WFSEndpoint |
他の WFS エンドポイントへのリンク |
ErrorAdditionalInfo
リソース管理エラーの追加情報。
| 名前 | 型 | 説明 |
|---|---|---|
| info |
object |
追加情報。 |
| type |
string |
追加情報の種類。 |
ErrorDetail
エラーの詳細。
| 名前 | 型 | 説明 |
|---|---|---|
| additionalInfo |
エラーの追加情報。 |
|
| code |
string |
エラー コード。 |
| details |
エラーの詳細です。 |
|
| message |
string |
エラー メッセージ。 |
| target |
string |
エラーのターゲット。 |
ErrorResponse
エラー応答
| 名前 | 型 | 説明 |
|---|---|---|
| error |
error オブジェクト。 |
FeatureResult
| 名前 | 型 | 説明 |
|---|---|---|
| feature |
有効な |
|
| links |
他の WFS エンドポイントへのリンク。 |
|
| ontology |
string |
このデータセットのオントロジ バージョン。 |
GeoJsonFeature
有効な GeoJSON Feature オブジェクト型。 詳細については、 RFC 7946 を参照してください。
| 名前 | 型 | 説明 |
|---|---|---|
| featureType |
string |
機能の種類です。 この値は、現在の特徴が含まれるデータ モデルによって異なります。 一部のデータ モデルには空の値が含まれる場合があります。 |
| geometry | GeoJsonGeometry: |
有効な |
| id |
string |
機能の識別子。 |
| type |
string:
Feature |
型を指定します |
GeoJsonGeometry
有効な GeoJSON geometry オブジェクト。 この型は、Point、MultiPoint、LineString、MultiLineString、Polygon、MultiPolygon、GeometryCollection の 7 つの有効な GeoJSON ジオメトリ型のいずれかである必要があります。 詳細については、 RFC 7946 を参照してください。
| 名前 | 型 | 説明 |
|---|---|---|
| type |
型を指定します |
GeoJsonGeometryCollection
有効な GeoJSON GeometryCollection オブジェクト型。 詳細については、 RFC 7946 を参照してください。
| 名前 | 型 | 説明 |
|---|---|---|
| geometries | GeoJsonGeometry[]: |
有効な |
| type |
string:
Geometry |
型を指定します |
GeoJsonLineString
有効な GeoJSON LineString geometry 型。 詳細については、 RFC 7946 を参照してください。
| 名前 | 型 | 説明 |
|---|---|---|
| coordinates |
number[] |
ジオメトリの |
| type |
string:
Line |
型を指定します |
GeoJsonMultiLineString
有効な GeoJSON MultiLineString geometry 型。 詳細については、 RFC 7946 を参照してください。
| 名前 | 型 | 説明 |
|---|---|---|
| coordinates |
number[] |
ジオメトリの |
| type |
string:
Multi |
型を指定します |
GeoJsonMultiPoint
有効な GeoJSON MultiPoint geometry 型。 詳細については、 RFC 7946 を参照してください。
| 名前 | 型 | 説明 |
|---|---|---|
| coordinates |
number[] |
ジオメトリの |
| type |
string:
Multi |
型を指定します |
GeoJsonMultiPolygon
有効な GeoJSON MultiPolygon オブジェクト型。 詳細については、 RFC 7946 を参照してください。
| 名前 | 型 | 説明 |
|---|---|---|
| coordinates |
number[] |
有効な |
| type |
string:
Multi |
型を指定します |
GeoJsonObjectType
種類を GeoJSON 指定します: FeatureCollection。
| 名前 | 型 | 説明 |
|---|---|---|
| FeatureCollection |
string |
|
GeoJsonPoint
有効な GeoJSON Point geometry 型。 詳細については、 RFC 7946 を参照してください。
| 名前 | 型 | 説明 |
|---|---|---|
| coordinates |
number[] |
は |
| type |
string:
Point |
型を指定します |
GeoJsonPolygon
有効な GeoJSON Polygon geometry 型。 詳細については、 RFC 7946 を参照してください。
| 名前 | 型 | 説明 |
|---|---|---|
| coordinates |
number[] |
ジオメトリタイプの |
| type |
string:
Polygon |
型を指定します |
WFSEndpointLink
他の WFS エンドポイントへのリンク
| 名前 | 型 | 説明 |
|---|---|---|
| href |
string |
リンク 先。 |
| hreflang |
string |
リンクを逆参照した結果の言語を示すヒント。 |
| rel |
string |
関係の種類。 |
| title |
string |
リンクの宛先にラベルを付けるために使用され、Content-Language ヘッダー フィールド (存在する場合) によって示される言語で人間が判読できる識別子 (メニュー エントリなど) として使用できます。 |
| type |
string |
リンクを逆参照した結果のメディアの種類を示すヒント。 |