Partager via


WFS - Get Feature

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.

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

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

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

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

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

Réponse d’erreur

Nom Type Description
error

ErrorDetail

Objet d’erreur.

FeatureResult

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

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:

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

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

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

Nom Type Description
geometries GeoJsonGeometry[]:

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

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

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

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

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

Spécifie le type GeoJSON : FeatureCollection.

Valeur Description
FeatureCollection

Objet GeoJSON FeatureCollection.

GeoJsonPoint

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

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.

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.