WFS - Get Feature

Référence

Service:: Maps Creator

Version d'API:: 2.0

Permet d’obtenir des détails d’une fonctionnalité dans une collection donnée.

Remarque

Mise hors service d’Azure Maps Creator

Le service de cartographie intérieure Azure Maps Creator est désormais déconseillé et sera mis hors service le 30/9/25. Pour plus d’informations, consultez Annonce de la fin de vie d’Azure Maps Creator.

L’API Get Feature est une requête http GET qui retourne les détails de la fonctionnalité spécifiée dans une collection donnée.

L’API WFS suit la norme 'API Open Geospatial Consortium pour les fonctionnalités pour interroger jeux de données.

Un jeu de données se compose de plusieurs collections de fonctionnalités. Une collection de fonctionnalités est une collection de fonctionnalités d’un type similaire, basée sur un schéma commun.

Envoyer une demande de fonctionnalité Get

GET https://{geography}.atlas.microsoft.com/wfs/datasets/{datasetId}/collections/{collectionId}/items/{featureId}?api-version=2.0

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
collectionId	path	True	string	Identificateur (nom) d’une collection spécifique
datasetId	path	True	string	Identificateur du jeu de données à partir duquel effectuer une requête.
featureId	path	True	string	Identificateur local d’une fonctionnalité spécifique
geography	path	True	string	Ce paramètre spécifie l’emplacement de la ressource Créateur Azure Maps. Les valeurs valides sont nous et eu.
api-version	query	True	string	Numéro de version de l’API Azure Maps.

Réponses

Nom	Type	Description
200 OK	FeatureResult	D’ACCORD
Other Status Codes	ErrorResponse	Une erreur inattendue s’est produite.

Sécurité

AADToken

Il s’agit des flux Microsoft Entra OAuth 2.0. Lorsqu’il est associé à 'accès en fonction du rôle Azure contrôle, il peut être utilisé pour contrôler l’accès aux API REST Azure Maps. Les contrôles d’accès en fonction du rôle Azure sont utilisés pour désigner l’accès à un ou plusieurs comptes de ressources Azure Maps ou sous-ressources. Tout utilisateur, groupe ou principal de service peut avoir accès via un rôle intégré ou un rôle personnalisé composé d’une ou plusieurs autorisations pour les API REST Azure Maps.

Pour implémenter des scénarios, nous vous recommandons d’afficher concepts d’authentification. En résumé, cette définition de sécurité fournit une solution pour la modélisation des applications via des objets capables de contrôler l’accès sur des API et des étendues spécifiques.

Remarques

Cette définition de sécurité nécessite l’utilisation de l’en-tête x-ms-client-id pour indiquer la ressource Azure Maps à laquelle l’application demande l’accès. Cela peut être acquis à partir de l’API de gestion Maps.

La Authorization URL est spécifique à l’instance de cloud public Azure. Les clouds souverains ont des URL d’autorisation uniques et des configurations d’ID Microsoft Entra. * Le contrôle d’accès en fonction du rôle Azure est configuré à partir de l'plan de gestion Azure via le portail Azure, PowerShell, l’interface CLI, les SDK Azure ou les API REST. * L’utilisation du kit de développement logiciel (SDK) web Azure Maps permet la configuration basée sur la configuration d’une application pour plusieurs cas d’usage.

Pour plus d’informations sur la plateforme d’identités Microsoft, consultez vue d’ensemble de la plateforme d’identités Microsoft.

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom	Description
https://atlas.microsoft.com/.default	https://atlas.microsoft.com/.default

subscription-key

Il s’agit d’une clé partagée provisionnée lorsque vous créer un compte Azure Maps dans le portail Azure ou à l’aide de PowerShell, CLI, sdk Azure ou API REST.

Avec cette clé, toute application peut accéder à toutes les API REST. En d’autres termes, cette clé peut être utilisée comme clé principale dans le compte dans lequel elles sont émises.

Pour les applications exposées publiquement, nous vous recommandons d’utiliser les applications clientes confidentielles approche permettant d’accéder aux API REST Azure Maps afin que votre clé puisse être stockée en toute sécurité.

Type: apiKey
Dans: query

SAS Token

Il s’agit d’un jeton de signature d’accès partagé créé à partir de l’opération List SAS sur la ressource Azure Maps via le plan de gestion Azure via le portail Azure, PowerShell, CLI, azure SDK ou LES API REST.

Avec ce jeton, toute application est autorisée à accéder avec des contrôles d’accès en fonction du rôle Azure et un contrôle précis à l’expiration, au taux et aux régions d’utilisation pour le jeton particulier. En d’autres termes, le jeton SAP peut être utilisé pour permettre aux applications de contrôler l’accès de manière plus sécurisée que la clé partagée.

Pour les applications exposées publiquement, nous vous recommandons de configurer une liste spécifique d’origines autorisées sur la ressource de compte mapper pour limiter l’abus de rendu et renouveler régulièrement le jeton SAP.

Type: apiKey
Dans: header

Exemples

GetFeature

Exemple de requête

HTTP

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

Exemple de réponse

Code d’état:: 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"
    }
  ]
}

Définitions

Nom	Description
ErrorAdditionalInfo	Informations supplémentaires sur l’erreur de gestion des ressources.
ErrorDetail	Détail de l’erreur.
ErrorResponse	Réponse d’erreur
FeatureResult
GeoJsonFeature	Type d’objet `GeoJSON Feature` valide. Pour plus d’informations, reportez-vous à RFC 7946.
GeoJsonGeometry	Objet geometry `GeoJSON` valide. Le type doit être l’un des sept types de géométrie GeoJSON valides : Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon et GeometryCollection. Pour plus d’informations, reportez-vous à RFC 7946.
GeoJsonGeometryCollection	Type d’objet `GeoJSON GeometryCollection` valide. Pour plus d’informations, reportez-vous à RFC 7946.
GeoJsonLineString	Type de géométrie `GeoJSON LineString` valide. Pour plus d’informations, reportez-vous à RFC 7946.
GeoJsonMultiLineString	Type de géométrie `GeoJSON MultiLineString` valide. Pour plus d’informations, reportez-vous à RFC 7946.
GeoJsonMultiPoint	Type de géométrie `GeoJSON MultiPoint` valide. Pour plus d’informations, reportez-vous à RFC 7946.
GeoJsonMultiPolygon	Type d’objet `GeoJSON MultiPolygon` valide. Pour plus d’informations, reportez-vous à RFC 7946.
GeoJsonObjectType	Spécifie le type `GeoJSON` : FeatureCollection.
GeoJsonPoint	Type de géométrie `GeoJSON Point` valide. Pour plus d’informations, reportez-vous à RFC 7946.
GeoJsonPolygon	Type de géométrie `GeoJSON Polygon` valide. Pour plus d’informations, reportez-vous à RFC 7946.
WFSEndpointLink	Liens vers d’autres points de terminaison WFS

ErrorAdditionalInfo

Object

Informations supplémentaires sur l’erreur de gestion des ressources.

Nom	Type	Description
info	object	Informations supplémentaires.
type	string	Type d’informations supplémentaire.

ErrorDetail

Object

Détail de l’erreur.

Nom	Type	Description
additionalInfo	ErrorAdditionalInfo[]	Informations supplémentaires sur l’erreur.
code	string	Code d’erreur.
details	ErrorDetail[]	Détails de l’erreur.
message	string	Message d’erreur.
target	string	Cible d’erreur.

ErrorResponse

Object

Réponse d’erreur

Nom	Type	Description
error	ErrorDetail	Objet d’erreur.

FeatureResult

Object

Nom	Type	Description
feature	GeoJsonFeature	Type d’objet `GeoJSON Feature` valide. Pour plus d’informations, reportez-vous à RFC 7946.
links	WFSEndpointLink[]	Liens vers d’autres points de terminaison WFS.
ontology	string	Version d’ontologie de ce jeu de données.

GeoJsonFeature

Object

Type d’objet GeoJSON Feature valide. Pour plus d’informations, reportez-vous à RFC 7946.

Nom	Type	Description
featureType	string	Type de la fonctionnalité. La valeur dépend du modèle de données dont fait partie la fonctionnalité actuelle. Certains modèles de données peuvent avoir une valeur vide.
geometry	GeoJsonGeometry: GeoJsonGeometryCollection GeoJsonLineString GeoJsonMultiLineString GeoJsonMultiPoint GeoJsonMultiPolygon GeoJsonPoint GeoJsonPolygon	Objet geometry `GeoJSON` valide. Le type doit être l’un des sept types de géométrie GeoJSON valides : Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon et GeometryCollection. Pour plus d’informations, reportez-vous à RFC 7946.
id	string	Identificateur de la fonctionnalité.
type	string: Feature	Spécifie le type `GeoJSON`. Doit être l’un des neuf types d’objets GeoJSON valides : Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature et FeatureCollection.

GeoJsonGeometry

Object

Objet geometry GeoJSON valide. Le type doit être l’un des sept types de géométrie GeoJSON valides : Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon et GeometryCollection. Pour plus d’informations, reportez-vous à RFC 7946.

Nom	Type	Description
type	GeoJsonObjectType	Spécifie le type `GeoJSON`. Doit être l’un des neuf types d’objets GeoJSON valides : Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature et FeatureCollection.

GeoJsonGeometryCollection

Object

Type d’objet GeoJSON GeometryCollection valide. Pour plus d’informations, reportez-vous à RFC 7946.

Nom	Type	Description
geometries	GeoJsonGeometry[]: GeoJsonGeometryCollection[] GeoJsonLineString[] GeoJsonMultiLineString[] GeoJsonMultiPoint[] GeoJsonMultiPolygon[] GeoJsonPoint[] GeoJsonPolygon[]	Contient une liste d’objets geometry `GeoJSON` valides. Remarque que les coordonnées dans GeoJSON sont dans l’ordre x, y (longitude, latitude).
type	string: GeometryCollection	Spécifie le type `GeoJSON`. Doit être l’un des neuf types d’objets GeoJSON valides : Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature et FeatureCollection.

GeoJsonLineString

Object

Type de géométrie GeoJSON LineString valide. Pour plus d’informations, reportez-vous à RFC 7946.

Nom	Type	Description
coordinates	number[] (double)	Coordonnées de la géométrie `GeoJson LineString`.
type	string: LineString	Spécifie le type `GeoJSON`. Doit être l’un des neuf types d’objets GeoJSON valides : Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature et FeatureCollection.

GeoJsonMultiLineString

Object

Type de géométrie GeoJSON MultiLineString valide. Pour plus d’informations, reportez-vous à RFC 7946.

Nom	Type	Description
coordinates	number[] (double)	Coordonnées de la géométrie `GeoJson MultiLineString`.
type	string: MultiLineString	Spécifie le type `GeoJSON`. Doit être l’un des neuf types d’objets GeoJSON valides : Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature et FeatureCollection.

GeoJsonMultiPoint

Object

Type de géométrie GeoJSON MultiPoint valide. Pour plus d’informations, reportez-vous à RFC 7946.

Nom	Type	Description
coordinates	number[] (double)	Coordonnées de la géométrie `GeoJson MultiPoint`.
type	string: MultiPoint	Spécifie le type `GeoJSON`. Doit être l’un des neuf types d’objets GeoJSON valides : Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature et FeatureCollection.

GeoJsonMultiPolygon

Object

Type d’objet GeoJSON MultiPolygon valide. Pour plus d’informations, reportez-vous à RFC 7946.

Nom	Type	Description
coordinates	number[] (double)	Contient une liste d’objets `GeoJSON Polygon` valides. Remarque que les coordonnées dans GeoJSON sont dans l’ordre x, y (longitude, latitude).
type	string: MultiPolygon	Spécifie le type `GeoJSON`. Doit être l’un des neuf types d’objets GeoJSON valides : Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature et FeatureCollection.

GeoJsonObjectType

Énumération

Spécifie le type GeoJSON : FeatureCollection.

Valeur	Description
FeatureCollection	Objet `GeoJSON FeatureCollection`.

GeoJsonPoint

Object

Type de géométrie GeoJSON Point valide. Pour plus d’informations, reportez-vous à RFC 7946.

Nom	Type	Description
coordinates	number[] (double)	Un `Position` est un tableau de nombres avec deux éléments ou plus. Les deux premiers éléments sont longitude et latitude, précisément dans cet ordre. altitude/élévation est un troisième élément facultatif. Pour plus d’informations, reportez-vous à RFC 7946.
type	string: Point	Spécifie le type `GeoJSON`. Doit être l’un des neuf types d’objets GeoJSON valides : Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature et FeatureCollection.

GeoJsonPolygon

Object

Type de géométrie GeoJSON Polygon valide. Pour plus d’informations, reportez-vous à RFC 7946.

Nom	Type	Description
coordinates	number[] (double)	Coordonnées pour le type de géométrie `GeoJson Polygon`.
type	string: Polygon	Spécifie le type `GeoJSON`. Doit être l’un des neuf types d’objets GeoJSON valides : Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature et FeatureCollection.

WFSEndpointLink

Object

Liens vers d’autres points de terminaison WFS

Nom	Type	Description
href	string	Cible du lien.
hreflang	string	Indicateur indiquant la langue du résultat de la déreferencation du lien.
rel	string	Type de relation.
title	string	Utilisé pour étiqueter la destination d’un lien de sorte qu’il puisse être utilisé comme identificateur lisible par l’homme (par exemple, une entrée de menu) dans la langue indiquée par le champ d’en-tête Content-Language (le cas échéant).
type	string	Indicateur indiquant le type de média du résultat de la déréférencement du lien.

Partager via

WFS - Get Feature

Envoyer une demande de fonctionnalité Get

Paramètres URI

Réponses

Sécurité

AADToken

Remarques

Étendues

subscription-key

SAS Token

Exemples

GetFeature

Exemple de requête

Exemple de réponse

Définitions

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

FeatureResult

GeoJsonFeature

GeoJsonGeometry

GeoJsonGeometryCollection

GeoJsonLineString

GeoJsonMultiLineString

GeoJsonMultiPoint

GeoJsonMultiPolygon

GeoJsonObjectType

GeoJsonPoint

GeoJsonPolygon

WFSEndpointLink

Ressources supplémentaires