WFS - Get Feature

リファレンス

サービス:: Maps Creator

API バージョン:: 2.0

特定のコレクション内の機能の詳細を取得するために使用します。

注

Azure Maps Creator の提供終了

Azure Maps Creator のフロアガイドサービスは現在非推奨となっており、2025 年 9 月 30 日付けで提供が終了します。詳細については、Azure Maps Creator のサポート終了のお知らせを参照してください。

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.0

URI パラメーター

名前	/	必須	型	説明
collectionId	path	True	string	特定のコレクションの識別子 (名前)
datasetId	path	True	string	クエリの対象となるデータセットの識別子。
featureId	path	True	string	特定の機能のローカル識別子
geography	path	True	string	このパラメーターは、Azure Maps Creator リソースが配置されている場所を指定します。有効な値は us と eu です。
api-version	query	True	string	Azure Maps API のバージョン番号。

応答

名前	型	説明
200 OK	FeatureResult	わかりました
Other Status Codes	ErrorResponse	予期しないエラーが発生しました。

セキュリティ

AADToken

これらは、Microsoft Entra OAuth 2.0 フローです。 Azure ロールベースアクセス制御と組み合わせて使用すると、Azure Maps REST API へのアクセスを制御できます。 Azure ロールベースのアクセス制御は、1 つ以上の Azure Maps リソースアカウントまたはサブリソースへのアクセスを指定するために使用されます。 Azure Maps REST API に対する 1 つ以上のアクセス許可で構成される組み込みロールまたはカスタムロールを使用して、任意のユーザー、グループ、またはサービスプリンシパルにアクセス権を付与できます。

シナリオを実装するには、認証の概念表示することをお勧めします。要約すると、このセキュリティ定義は、特定の API とスコープに対するアクセス制御が可能なオブジェクトを介してアプリケーションをモデル化するためのソリューションを提供します。

注記

このセキュリティ定義使用して、アプリケーションがアクセスを要求している 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

例

GetFeature

要求のサンプル

HTTP

GET https://us.atlas.microsoft.com/wfs/datasets/218fda98-e638-0edf-5ef7-28491ff3bed4/collections/unit/items/UNIT39?api-version=2.0

応答のサンプル

状態コード:: 200

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

定義

名前	説明
ErrorAdditionalInfo	リソース管理エラーの追加情報。
ErrorDetail	エラーの詳細。
ErrorResponse	エラー応答
FeatureResult
GeoJsonFeature	有効な `GeoJSON Feature` オブジェクト型。詳細については、RFC 7946 を参照してください。
GeoJsonGeometry	有効な `GeoJSON` geometry オブジェクト。この型は、Point、MultiPoint、LineString、MultiLineString、Polygon、MultiPolygon、GeometryCollection の 7 つの有効な GeoJSON ジオメトリ型のいずれかである必要があります。詳細については、RFC 7946 を参照してください。
GeoJsonGeometryCollection	有効な `GeoJSON GeometryCollection` オブジェクト型。詳細については、RFC 7946 を参照してください。
GeoJsonLineString	有効な `GeoJSON LineString` geometry 型。詳細については、RFC 7946 を参照してください。
GeoJsonMultiLineString	有効な `GeoJSON MultiLineString` geometry 型。詳細については、RFC 7946 を参照してください。
GeoJsonMultiPoint	有効な `GeoJSON MultiPoint` geometry 型。詳細については、RFC 7946 を参照してください。
GeoJsonMultiPolygon	有効な `GeoJSON MultiPolygon` オブジェクト型。詳細については、RFC 7946 を参照してください。
GeoJsonObjectType	`GeoJSON` タイプ FeatureCollection を指定します。
GeoJsonPoint	有効な `GeoJSON Point` geometry 型。詳細については、RFC 7946 を参照してください。
GeoJsonPolygon	有効な `GeoJSON Polygon` geometry 型。詳細については、RFC 7946 を参照してください。
WFSEndpointLink	他の WFS エンドポイントへのリンク

ErrorAdditionalInfo

Object

リソース管理エラーの追加情報。

名前	型	説明
info	object	追加情報。
type	string	追加情報の種類。

ErrorDetail

Object

エラーの詳細。

名前	型	説明
additionalInfo	ErrorAdditionalInfo[]	エラーの追加情報。
code	string	エラーコード。
details	ErrorDetail[]	エラーの詳細。
message	string	エラーメッセージ。
target	string	エラーターゲット。

ErrorResponse

Object

エラー応答

名前	型	説明
error	ErrorDetail	エラーオブジェクト。

FeatureResult

Object

名前	型	説明
feature	GeoJsonFeature	有効な `GeoJSON Feature` オブジェクト型。詳細については、RFC 7946 を参照してください。
links	WFSEndpointLink[]	他の WFS エンドポイントへのリンク。
ontology	string	このデータセットのオントロジバージョン。

GeoJsonFeature

Object

有効な GeoJSON Feature オブジェクト型。詳細については、RFC 7946 を参照してください。

名前	型	説明
featureType	string	フィーチャーの種類。値は、現在の特徴が含まれるデータモデルによって異なります。一部のデータモデルには空の値が含まれる場合があります。
geometry	GeoJsonGeometry: GeoJsonGeometryCollection GeoJsonLineString GeoJsonMultiLineString GeoJsonMultiPoint GeoJsonMultiPolygon GeoJsonPoint GeoJsonPolygon	有効な `GeoJSON` geometry オブジェクト。この型は、Point、MultiPoint、LineString、MultiLineString、Polygon、MultiPolygon、GeometryCollection の 7 つの有効な GeoJSON ジオメトリ型のいずれかである必要があります。詳細については、RFC 7946 を参照してください。
id	string	機能の識別子。
type	string: Feature	`GeoJSON` 型を指定します。 Point、MultiPoint、LineString、MultiLineString、Polygon、MultiPolygon、GeometryCollection、Feature、FeatureCollection の 9 つの有効な GeoJSON オブジェクトタイプのいずれかである必要があります。

GeoJsonGeometry

Object

有効な GeoJSON geometry オブジェクト。この型は、Point、MultiPoint、LineString、MultiLineString、Polygon、MultiPolygon、GeometryCollection の 7 つの有効な GeoJSON ジオメトリ型のいずれかである必要があります。詳細については、RFC 7946 を参照してください。

名前	型	説明
type	GeoJsonObjectType	`GeoJSON` 型を指定します。 Point、MultiPoint、LineString、MultiLineString、Polygon、MultiPolygon、GeometryCollection、Feature、FeatureCollection の 9 つの有効な GeoJSON オブジェクトタイプのいずれかである必要があります。

GeoJsonGeometryCollection

Object

有効な GeoJSON GeometryCollection オブジェクト型。詳細については、RFC 7946 を参照してください。

名前	型	説明
geometries	GeoJsonGeometry[]: GeoJsonGeometryCollection[] GeoJsonLineString[] GeoJsonMultiLineString[] GeoJsonMultiPoint[] GeoJsonMultiPolygon[] GeoJsonPoint[] GeoJsonPolygon[]	有効な `GeoJSON` ジオメトリオブジェクトの一覧が含まれています。 GeoJSON の座標が x、y の順序 (経度、緯度) であるに注意してください。
type	string: GeometryCollection	`GeoJSON` 型を指定します。 Point、MultiPoint、LineString、MultiLineString、Polygon、MultiPolygon、GeometryCollection、Feature、FeatureCollection の 9 つの有効な GeoJSON オブジェクトタイプのいずれかである必要があります。

GeoJsonLineString

Object

有効な GeoJSON LineString geometry 型。詳細については、RFC 7946 を参照してください。

名前	型	説明
coordinates	number[] (double)	`GeoJson LineString` ジオメトリの座標。
type	string: LineString	`GeoJSON` 型を指定します。 Point、MultiPoint、LineString、MultiLineString、Polygon、MultiPolygon、GeometryCollection、Feature、FeatureCollection の 9 つの有効な GeoJSON オブジェクトタイプのいずれかである必要があります。

GeoJsonMultiLineString

Object

有効な GeoJSON MultiLineString geometry 型。詳細については、RFC 7946 を参照してください。

名前	型	説明
coordinates	number[] (double)	`GeoJson MultiLineString` ジオメトリの座標。
type	string: MultiLineString	`GeoJSON` 型を指定します。 Point、MultiPoint、LineString、MultiLineString、Polygon、MultiPolygon、GeometryCollection、Feature、FeatureCollection の 9 つの有効な GeoJSON オブジェクトタイプのいずれかである必要があります。

GeoJsonMultiPoint

Object

有効な GeoJSON MultiPoint geometry 型。詳細については、RFC 7946 を参照してください。

名前	型	説明
coordinates	number[] (double)	`GeoJson MultiPoint` ジオメトリの座標。
type	string: MultiPoint	`GeoJSON` 型を指定します。 Point、MultiPoint、LineString、MultiLineString、Polygon、MultiPolygon、GeometryCollection、Feature、FeatureCollection の 9 つの有効な GeoJSON オブジェクトタイプのいずれかである必要があります。

GeoJsonMultiPolygon

Object

有効な GeoJSON MultiPolygon オブジェクト型。詳細については、RFC 7946 を参照してください。

名前	型	説明
coordinates	number[] (double)	有効な `GeoJSON Polygon` オブジェクトの一覧を格納します。 GeoJSON の座標が x、y の順序 (経度、緯度) であるに注意してください。
type	string: MultiPolygon	`GeoJSON` 型を指定します。 Point、MultiPoint、LineString、MultiLineString、Polygon、MultiPolygon、GeometryCollection、Feature、FeatureCollection の 9 つの有効な GeoJSON オブジェクトタイプのいずれかである必要があります。

GeoJsonObjectType

列挙

GeoJSON タイプ FeatureCollection を指定します。

値	説明
FeatureCollection	`GeoJSON FeatureCollection` オブジェクト。

GeoJsonPoint

Object

有効な GeoJSON Point geometry 型。詳細については、RFC 7946 を参照してください。

名前	型	説明
coordinates	number[] (double)	`Position` は、2 つ以上の要素を持つ数値の配列です。最初の 2 つの要素は、経度、緯度正確にその順序で示されます。高度/標高は、オプションの 3 番目の要素です。詳細については、RFC 7946 を参照してください。
type	string: Point	`GeoJSON` 型を指定します。 Point、MultiPoint、LineString、MultiLineString、Polygon、MultiPolygon、GeometryCollection、Feature、FeatureCollection の 9 つの有効な GeoJSON オブジェクトタイプのいずれかである必要があります。

GeoJsonPolygon

Object

有効な GeoJSON Polygon geometry 型。詳細については、RFC 7946 を参照してください。

名前	型	説明
coordinates	number[] (double)	`GeoJson Polygon` geometry タイプの座標。
type	string: Polygon	`GeoJSON` 型を指定します。 Point、MultiPoint、LineString、MultiLineString、Polygon、MultiPolygon、GeometryCollection、Feature、FeatureCollection の 9 つの有効な GeoJSON オブジェクトタイプのいずれかである必要があります。

WFSEndpointLink

Object

他の WFS エンドポイントへのリンク

名前	型	説明
href	string	リンク先。
hreflang	string	リンクを逆参照した結果の言語を示すヒント。
rel	string	リレーションシップの種類。
title	string	リンクの宛先にラベルを付けるために使用され、コンテンツ言語ヘッダーフィールド (存在する場合) によって示される言語で、人間が判読できる識別子 (メニューエントリなど) として使用できます。
type	string	リンクを逆参照した結果のメディアの種類を示すヒント。

次の方法で共有

WFS - Get Feature

機能の取得要求を送信する

URI パラメーター

応答

セキュリティ

AADToken

注記

スコープ

subscription-key

SAS Token

例

GetFeature

要求のサンプル

応答のサンプル

定義

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

FeatureResult

GeoJsonFeature

GeoJsonGeometry

GeoJsonGeometryCollection

GeoJsonLineString

GeoJsonMultiLineString

GeoJsonMultiPoint

GeoJsonMultiPolygon

GeoJsonObjectType

GeoJsonPoint

GeoJsonPolygon

WFSEndpointLink

その他のリソース