WFS - Get Features
コレクションの機能の詳細な一覧を取得するために使用します。
手記
Azure Maps Creator の提供終了 を
Azure Maps Creator の屋内マップ サービスは非推奨となり、9/30/25 に廃止されます。 詳細については、「azure Maps Creatorの
Get Features API は、指定したコレクション内の機能の詳細な一覧を返す HTTP GET 要求です。
WFS API は、Open Geospatial Consortium API standard for Features に従って、データセットにクエリを実行します。
データセットは、複数の機能コレクションで構成されます。 フィーチャー コレクションは、共通スキーマに基づく、同様の種類の特徴のコレクションです。
機能の取得要求を送信する
GET https://{geography}.atlas.microsoft.com/wfs/datasets/{datasetId}/collections/{collectionId}/items?api-version=2.0GET https://{geography}.atlas.microsoft.com/wfs/datasets/{datasetId}/collections/{collectionId}/items?api-version=2.0&limit={limit}&bbox={bbox}&filter={filter}URI パラメーター
| 名前 | / | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
collection
|
path | True |
string |
特定のコレクションの識別子 (名前) |
|
dataset
|
path | True |
string |
クエリの対象となるデータセットの識別子。 |
|
geography
|
path | True |
string |
このパラメーターは、Azure Maps Creator リソースが配置されている場所を指定します。 有効な値は us と eu です。 |
|
api-version
|
query | True |
string |
Azure Maps API のバージョン番号。 |
|
bbox
|
query |
number[] |
指定された境界ボックスと交差するジオメトリを持つフィーチャのみが選択されます。
|
|
|
filter
|
query |
string |
式をフィルター処理して、特定のコレクション内の特定のプロパティ値を持つ特徴を検索します。 スカラー型と等号演算子の特徴プロパティのみがサポートされています。 これは、パラメーター名が大文字と小文字を区別するプロパティ名である特殊なパラメーターです。 このパラメーターのスキームは {property name}={property value} です。 "filter" がコレクション内のプロパティ名の 1 つである場合を除き、パラメーター名として "filter" を使用しないでください。 "name" プロパティ値 "21N13" の特徴を検索するには、"name=21N13" を使用します。 複数のフィルターがサポートされており、複数のクエリ パラメーターとして表す必要があります。 例: =&= 文字列値では大文字と小文字が区別されます。 |
|
|
limit
|
query |
integer minimum: 1maximum: 500 |
省略可能な制限パラメーターは、応答ドキュメントに表示される機能の数を制限します。 応答ドキュメント内のコレクションの最初のレベルにある機能のみがカウントされます。 明示的に要求された機能に含まれる入れ子になったオブジェクトはカウントされません。
|
要求ヘッダー
| 名前 | 必須 | 型 | 説明 |
|---|---|---|---|
| x-ms-client-id |
string |
Microsoft Entra ID セキュリティ モデルと組み合わせて使用するアカウントを指定します。 これは Azure Maps アカウントの一意の ID を表し、Azure Maps 管理プレーン アカウント API から取得できます。 Azure Maps で Microsoft Entra ID セキュリティを使用するには、ガイダンス 次の |
応答
| 名前 | 型 | 説明 |
|---|---|---|
| 200 OK |
わかりました |
|
| Other Status Codes |
予期しないエラーが発生しました。 |
セキュリティ
AADToken
これらは、Microsoft Entra OAuth 2.0 フロー
シナリオを実装するには、認証の概念表示することをお勧めします。 要約すると、このセキュリティ定義は、特定の 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 で、または PowerShell、CLI、Azure SDK、または REST API を使用して Azure Maps アカウント を作成
このキーを使用すると、すべてのアプリケーションがすべての REST API にアクセスできます。 つまり、このキーは、発行されたアカウントのマスター キーとして使用できます。
パブリックに公開されているアプリケーションの場合は、キーを安全に格納できるように、機密クライアント アプリケーション アプローチを使用して Azure Maps REST API にアクセスすることをお勧めします。
型:
apiKey
/:
query
SAS Token
これは、Azure portal、PowerShell、CLI、Azure SDK、または REST API を介して Azure 管理プレーンを介して、Azure Maps リソース のリスト SAS 操作から作成される Shared Access Signature トークンです。
このトークンを使用すると、すべてのアプリケーションは、Azure ロールベースのアクセス制御と、特定のトークンに対する使用の有効期限、レート、およびリージョンに対するきめ細かな制御を使用してアクセスすることが承認されます。 つまり、SAS トークンを使用して、アプリケーションが共有キーよりもセキュリティで保護された方法でアクセスを制御できるようにします。
パブリックに公開されているアプリケーションの場合は、Map アカウント リソースの許可された配信元の特定の一覧を構成し、レンダリングの不正使用を制限し、SAS トークンを定期的に更新するように することをお勧めします。
型:
apiKey
/:
header
例
GetFeatures
要求のサンプル
GET https://us.atlas.microsoft.com/wfs/datasets/018fda98-e638-0edf-5ef7-28491ff3bed4/collections/unit/items?api-version=2.0&limit=1&bbox=-122,47,-120,46
応答のサンプル
{
"type": "FeatureCollection",
"ontology": "Facility-2.0",
"features": [
{
"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": ""
}
],
"numberReturned": 1,
"links": [
{
"href": "https://us.atlas.microsoft.com/wfs/dataset/218fda98-e638-0edf-5ef7-28491ff3bed4/collections/unit/items?api-version=2.0&limit=1",
"rel": "self"
},
{
"href": "https://us.atlas.microsoft.com/wfs/dataset/218fda98-e638-0edf-5ef7-28491ff3bed4/collections/unit?api-version=2.0",
"rel": "data"
},
{
"href": "https://us.atlas.microsoft.com/wfs/dataset/218fda98-e638-0edf-5ef7-28491ff3bed4/collections/unit/items?n=PMRG4ZLYOQRDUMJMEJYHEZLWEI5C2ML5&api-version=2.0&limit=1",
"rel": "next"
}
]
}定義
| 名前 | 説明 |
|---|---|
|
Error |
リソース管理エラーの追加情報。 |
|
Error |
エラーの詳細。 |
|
Error |
エラー応答 |
|
Extended |
numberReturned および links 配列で拡張された有効な |
|
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 |
エラー オブジェクト。 |
ExtendedGeoJsonFeatureCollection
numberReturned および links 配列で拡張された有効な GeoJSON FeatureCollection オブジェクト型。 詳細については、RFC 7946 を参照してください。
| 名前 | 型 | 説明 |
|---|---|---|
| features |
有効な |
|
| links |
他の WFS エンドポイントへのリンク。 |
|
| numberReturned |
integer |
返される特徴の数。 |
| ontology |
string |
このデータセットのオントロジ バージョン。 |
| type |
|
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[] (double) |
|
| type |
string:
Line |
|
GeoJsonMultiLineString
有効な GeoJSON MultiLineString geometry 型。 詳細については、RFC 7946 を参照してください。
| 名前 | 型 | 説明 |
|---|---|---|
| coordinates |
number[] (double) |
|
| type |
string:
Multi |
|
GeoJsonMultiPoint
有効な GeoJSON MultiPoint geometry 型。 詳細については、RFC 7946 を参照してください。
| 名前 | 型 | 説明 |
|---|---|---|
| coordinates |
number[] (double) |
|
| type |
string:
Multi |
|
GeoJsonMultiPolygon
有効な GeoJSON MultiPolygon オブジェクト型。 詳細については、RFC 7946 を参照してください。
| 名前 | 型 | 説明 |
|---|---|---|
| coordinates |
number[] (double) |
有効な |
| type |
string:
Multi |
|
GeoJsonObjectType
GeoJSON タイプ FeatureCollection を指定します。
| 値 | 説明 |
|---|---|
| FeatureCollection |
|
GeoJsonPoint
有効な GeoJSON Point geometry 型。 詳細については、RFC 7946 を参照してください。
| 名前 | 型 | 説明 |
|---|---|---|
| coordinates |
number[] (double) |
|
| type |
string:
Point |
|
GeoJsonPolygon
有効な GeoJSON Polygon geometry 型。 詳細については、RFC 7946 を参照してください。
| 名前 | 型 | 説明 |
|---|---|---|
| coordinates |
number[] (double) |
|
| type |
string:
Polygon |
|
WFSEndpointLink
他の WFS エンドポイントへのリンク
| 名前 | 型 | 説明 |
|---|---|---|
| href |
string |
リンク 先。 |
| hreflang |
string |
リンクを逆参照した結果の言語を示すヒント。 |
| rel |
string |
リレーションシップの種類。 |
| title |
string |
リンクの宛先にラベルを付けるために使用され、コンテンツ言語ヘッダー フィールド (存在する場合) によって示される言語で、人間が判読できる識別子 (メニュー エントリなど) として使用できます。 |
| type |
string |
リンクを逆参照した結果のメディアの種類を示すヒント。 |