WFS - Get Features

Riferimento

Servizio:: Maps Creator

Versione API:: 2.0

Usare per ottenere un elenco dettagliato delle funzionalità di una raccolta.

L'API Get Features è una richiesta HTTP GET che restituisce un elenco dettagliato di funzionalità nella raccolta specificata.

L'API WFS segue lo standard dell'API Open Geospatial Consortium per le funzionalità per eseguire query sui set di dati.

Un set di dati è costituito da più raccolte di funzionalità. Una raccolta di funzionalità è una raccolta di funzionalità di un tipo simile, in base a uno schema comune.

Invia richiesta di funzionalità get

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

Con parametri facoltativi:

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
collectionId	path	True	string	Identificatore (nome) di una raccolta specifica
datasetId	path	True	string	Identificatore del set di dati da cui eseguire una query.
geography	path	True	string	Questo parametro specifica dove si trova la risorsa Mappe di Azure Creator. I valori validi sono noi ed eu.
api-version	query	True	string	Numero di versione dell'API Mappe di Azure.
bbox	query		number[]	Vengono selezionate solo le funzionalità con una geometria che interseca il riquadro di selezione fornito. Angolo inferiore sinistro, asse di coordinate 1 * Angolo inferiore sinistro, asse di coordinate 2 * Angolo superiore destro, asse di coordinate 1 * Angolo superiore destro, asse di coordinate 2 Il sistema di riferimento di coordinate dei valori è WGS84 longitudine/latitudine (http://www.opengis.net/def/crs/OGC/1.3/CRS84) a meno che non sia specificato un sistema di riferimento di coordinate diverso nel parametro `bbox-crs`. Per WGS84 longitudine/latitudine i valori sono nella maggior parte dei casi la sequenza di longitudine minima, latitudine minima, longitudine massima e latitudine massima. Tuttavia, nei casi in cui la casella si estende sull'antimeridiano il primo valore (bordo della maggior parte della casella occidentale) è maggiore del terzo valore (bordo casella orientale).
filter	query		string	Filtrare l'espressione per cercare le funzionalità con valori di proprietà specifici in una determinata raccolta. Sono supportate solo le proprietà delle funzionalità del tipo scalare e degli operatori uguali. Si tratta di un parametro speciale in cui il nome del parametro è un nome di proprietà di distinzione tra maiuscole e minuscole. Lo schema per questo parametro è {nome proprietà}={valore della proprietà}. A meno che "filter" non sia uno dei nomi delle proprietà nella raccolta, "filter" non deve essere usato come nome di parametro. Per cercare le funzionalità con il valore della proprietà "name" "21N13", usare "name=21N13". Più filtri sono supportati e devono essere rappresentati come più parametri di query. Ad esempio, =&= i valori stringa sono distinzione tra maiuscole e minuscole.
limit	query		integer	Il parametro limite facoltativo limita il numero di funzionalità presentate nel documento di risposta. Vengono conteggiate solo le funzionalità che si trovano al primo livello della raccolta nel documento di risposta. Gli oggetti annidati contenuti all'interno delle funzionalità richieste in modo esplicito non devono essere conteggiati. Minimo = 1 * Massimo = 500 * Default = 10

Intestazione della richiesta

Nome	Necessario	Tipo	Descrizione
x-ms-client-id		string	Specifica l'account destinato all'utilizzo in combinazione con il modello di sicurezza Microsoft Entra ID. Rappresenta un ID univoco per l'account Mappe di Azure e può essere recuperato dall'API account del piano di gestione Mappe di Azure. Per usare Microsoft Entra ID sicurezza in Mappe di Azure vedere gli articoli seguenti per indicazioni.

Risposte

Nome	Tipo	Descrizione
200 OK	ExtendedGeoJsonFeatureCollection	OK
Other Status Codes	ErrorResponse	Si è verificato un errore imprevisto.

Sicurezza

AADToken

Si tratta dei flussi OAuth 2.0 Microsoft Entra. Se abbinato al controllo degli accessi in base al ruolo di Azure, può essere usato per controllare l'accesso alle API REST Mappe di Azure. I controlli di accesso in base al ruolo di Azure vengono usati per designare l'accesso a uno o più Mappe di Azure account di risorse o sottorisorse. A qualsiasi utente, gruppo o entità servizio può essere concesso l'accesso tramite un ruolo predefinito o un ruolo personalizzato composto da una o più autorizzazioni per Mappe di Azure API REST.

Per implementare scenari, è consigliabile visualizzare i concetti di autenticazione. In sintesi, questa definizione di sicurezza offre una soluzione per la modellazione di applicazioni tramite oggetti in grado di controllare l'accesso su API e ambiti specifici.

Note

Questa definizione di sicurezza richiede l'uso dell'intestazione x-ms-client-id per indicare a quale Mappe di Azure risorsa a cui l'applicazione richiede l'accesso. Questa operazione può essere acquisita dall'API di gestione mappe.

è Authorization URL specifico dell'istanza del cloud pubblico di Azure. I cloud sovrani hanno URL di autorizzazione univoci e configurazioni Microsoft Entra ID. * Il controllo degli accessi in base al ruolo di Azure viene configurato dal piano di gestione di Azure tramite portale di Azure, PowerShell, interfaccia della riga di comando, SDK di Azure o API REST. * L'utilizzo dell'SDK Web Mappe di Azure consente la configurazione basata sulla configurazione di un'applicazione per più casi d'uso.

Per altre informazioni su Microsoft Identity Platform, vedere panoramica Microsoft Identity Platform.

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
https://atlas.microsoft.com/.default	https://atlas.microsoft.com/.default

subscription-key

Si tratta di una chiave condivisa di cui viene eseguito il provisioning quando si crea un account Mappe di Azure nell'portale di Azure o usando PowerShell, l'interfaccia della riga di comando, gli SDK di Azure o l'API REST.

Con questa chiave, qualsiasi applicazione può accedere a tutte le API REST. In altre parole, questa chiave può essere usata come chiave master nell'account in cui vengono rilasciati.

Per le applicazioni esposte pubblicamente, è consigliabile usare l'approccio delle applicazioni client riservate per accedere alle API REST Mappe di Azure in modo che la chiave possa essere archiviata in modo sicuro.

Tipo: apiKey
In: query

SAS Token

Si tratta di un token di firma di accesso condiviso creato dall'operazione Elenco firma di accesso condiviso nella risorsa Mappe di Azure tramite il piano di gestione di Azure tramite portale di Azure, PowerShell, interfaccia della riga di comando, SDK di Azure o API REST.

Con questo token, qualsiasi applicazione è autorizzata ad accedere con i controlli di accesso basati sul ruolo di Azure e il controllo granulare alla scadenza, alla frequenza e alle aree d'uso per il token specifico. In altre parole, il token di firma di accesso condiviso può essere usato per consentire alle applicazioni di controllare l'accesso in modo più protetto rispetto alla chiave condivisa.

Per le applicazioni esposte pubblicamente, è consigliabile configurare un elenco specifico di origini consentite nella risorsa account mappa per limitare l'abuso di rendering e rinnovare regolarmente il token di firma di accesso condiviso.

Tipo: apiKey
In: header

Esempio

GetFeatures

Esempio di richiesta

HTTP

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

Risposta di esempio

Codice di stato:: 200

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

Definizioni

Nome	Descrizione
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorDetail	Dettagli dell'errore.
ErrorResponse	Risposta di errore
ExtendedGeoJsonFeatureCollection	Tipo di oggetto valido `GeoJSON FeatureCollection` esteso con matrice numberReturned e links. Per informazioni dettagliate, vedere RFC 7946 .
GeoJsonFeature	Tipo di oggetto valido `GeoJSON Feature` . Per informazioni dettagliate, vedere RFC 7946 .
GeoJsonGeometry	Oggetto geometry valido `GeoJSON` . Il tipo deve essere uno dei sette tipi di geometria GeoJSON validi: Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon e GeometryCollection. Per informazioni dettagliate, vedere RFC 7946 .
GeoJsonGeometryCollection	Tipo di oggetto valido `GeoJSON GeometryCollection` . Per informazioni dettagliate, vedere RFC 7946 .
GeoJsonLineString	Tipo di geometria valido `GeoJSON LineString` . Per informazioni dettagliate, vedere RFC 7946 .
GeoJsonMultiLineString	Tipo di geometria valido `GeoJSON MultiLineString` . Per informazioni dettagliate, vedere RFC 7946 .
GeoJsonMultiPoint	Tipo di geometria valido `GeoJSON MultiPoint` . Per informazioni dettagliate, vedere RFC 7946 .
GeoJsonMultiPolygon	Tipo di oggetto valido `GeoJSON MultiPolygon` . Per informazioni dettagliate, vedere RFC 7946 .
GeoJsonObjectType	Specifica il `GeoJSON` tipo: FeatureCollection.
GeoJsonPoint	Tipo di geometria valido `GeoJSON Point` . Per informazioni dettagliate, vedere RFC 7946 .
GeoJsonPolygon	Tipo di geometria valido `GeoJSON Polygon` . Per informazioni dettagliate, vedere RFC 7946 .
WFSEndpointLink	Collegamenti ad altri endpoint WFS

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome	Tipo	Descrizione
info	object	Informazioni aggiuntive.
type	string	Tipo di informazioni aggiuntive.

ErrorDetail

Dettagli dell'errore.

Nome	Tipo	Descrizione
additionalInfo	ErrorAdditionalInfo[]	Informazioni aggiuntive sull'errore.
code	string	Codice di errore.
details	ErrorDetail[]	Dettagli dell'errore.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore.

ErrorResponse

Risposta di errore

Nome	Tipo	Descrizione
error	ErrorDetail	Oggetto error.

ExtendedGeoJsonFeatureCollection

Tipo di oggetto valido GeoJSON FeatureCollection esteso con matrice numberReturned e links. Per informazioni dettagliate, vedere RFC 7946 .

Nome	Tipo	Descrizione
features	GeoJsonFeature[]	Contiene un elenco di oggetti validi `GeoJSON Feature` .
links	WFSEndpointLink[]	Collegamenti ad altri endpoint WFS.
numberReturned	integer	Numero di funzionalità restituite.
ontology	string	Versione ontologia di questo set di dati.
type	GeoJsonObjectType	Specifica il `GeoJSON` tipo: FeatureCollection.

GeoJsonFeature

Tipo di oggetto valido GeoJSON Feature . Per informazioni dettagliate, vedere RFC 7946 .

Nome	Tipo	Descrizione
featureType	string	Tipo di funzionalità. Il valore dipende dal modello di dati di cui fa parte la funzionalità corrente. Alcuni modelli di dati possono avere un valore vuoto.
geometry	GeoJsonGeometry: GeoJsonGeometryCollection GeoJsonLineString GeoJsonMultiLineString GeoJsonMultiPoint GeoJsonMultiPolygon GeoJsonPoint GeoJsonPolygon	Oggetto geometry valido `GeoJSON` . Il tipo deve essere uno dei sette tipi di geometria GeoJSON validi: Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon e GeometryCollection. Per informazioni dettagliate, vedere RFC 7946 .
id	string	Identificatore della funzionalità.
type	string: Feature	Specifica il tipo di oggetto `GeoJSON`. Deve essere uno dei nove tipi di oggetto GeoJSON validi: Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature e FeatureCollection.

GeoJsonGeometry

Oggetto geometry valido GeoJSON . Il tipo deve essere uno dei sette tipi di geometria GeoJSON validi: Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon e GeometryCollection. Per informazioni dettagliate, vedere RFC 7946 .

Nome	Tipo	Descrizione
type	GeoJsonObjectType	Specifica il tipo di oggetto `GeoJSON`. Deve essere uno dei nove tipi di oggetto GeoJSON validi: Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature e FeatureCollection.

GeoJsonGeometryCollection

Tipo di oggetto valido GeoJSON GeometryCollection . Per informazioni dettagliate, vedere RFC 7946 .

Nome	Tipo	Descrizione
geometries	GeoJsonGeometry[]: GeoJsonGeometryCollection[] GeoJsonLineString[] GeoJsonMultiLineString[] GeoJsonMultiPoint[] GeoJsonMultiPolygon[] GeoJsonPoint[] GeoJsonPolygon[]	Contiene un elenco di oggetti geometry validi `GeoJSON` . Si noti che le coordinate in GeoJSON sono in ordine x, y (longitudine, latitudine).
type	string: GeometryCollection	Specifica il tipo di oggetto `GeoJSON`. Deve essere uno dei nove tipi di oggetto GeoJSON validi: Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature e FeatureCollection.

GeoJsonLineString

Tipo di geometria valido GeoJSON LineString . Per informazioni dettagliate, vedere RFC 7946 .

Nome	Tipo	Descrizione
coordinates	number[]	Coordinate per la `GeoJson LineString` geometria.
type	string: LineString	Specifica il tipo di oggetto `GeoJSON`. Deve essere uno dei nove tipi di oggetto GeoJSON validi: Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature e FeatureCollection.

GeoJsonMultiLineString

Tipo di geometria valido GeoJSON MultiLineString . Per informazioni dettagliate, vedere RFC 7946 .

Nome	Tipo	Descrizione
coordinates	number[]	Coordinate per la `GeoJson MultiLineString` geometria.
type	string: MultiLineString	Specifica il tipo di oggetto `GeoJSON`. Deve essere uno dei nove tipi di oggetto GeoJSON validi: Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature e FeatureCollection.

GeoJsonMultiPoint

Tipo di geometria valido GeoJSON MultiPoint . Per informazioni dettagliate, vedere RFC 7946 .

Nome	Tipo	Descrizione
coordinates	number[]	Coordinate per la `GeoJson MultiPoint` geometria.
type	string: MultiPoint	Specifica il tipo di oggetto `GeoJSON`. Deve essere uno dei nove tipi di oggetto GeoJSON validi: Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature e FeatureCollection.

GeoJsonMultiPolygon

Tipo di oggetto valido GeoJSON MultiPolygon . Per informazioni dettagliate, vedere RFC 7946 .

Nome	Tipo	Descrizione
coordinates	number[]	Contiene un elenco di oggetti validi `GeoJSON Polygon` . Si noti che le coordinate in GeoJSON sono in ordine x, y (longitudine, latitudine).
type	string: MultiPolygon	Specifica il tipo di oggetto `GeoJSON`. Deve essere uno dei nove tipi di oggetto GeoJSON validi: Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature e FeatureCollection.

GeoJsonObjectType

Specifica il GeoJSON tipo: FeatureCollection.

Nome	Tipo	Descrizione
FeatureCollection	string	Oggetto `GeoJSON FeatureCollection`.

GeoJsonPoint

Tipo di geometria valido GeoJSON Point . Per informazioni dettagliate, vedere RFC 7946 .

Nome	Tipo	Descrizione
coordinates	number[]	Un `Position` è una matrice di numeri con due o più elementi. I primi due elementi sono longitudine e latitudine, esattamente in questo ordine. Altitudine/Elevazione è un terzo elemento facoltativo. Per informazioni dettagliate, vedere RFC 7946 .
type	string: Point	Specifica il tipo di oggetto `GeoJSON`. Deve essere uno dei nove tipi di oggetto GeoJSON validi: Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature e FeatureCollection.

GeoJsonPolygon

Tipo di geometria valido GeoJSON Polygon . Per informazioni dettagliate, vedere RFC 7946 .

Nome	Tipo	Descrizione
coordinates	number[]	Coordinate per il `GeoJson Polygon` tipo di geometria.
type	string: Polygon	Specifica il tipo di oggetto `GeoJSON`. Deve essere uno dei nove tipi di oggetto GeoJSON validi: Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature e FeatureCollection.

WFSEndpointLink

Collegamenti ad altri endpoint WFS

Nome	Tipo	Descrizione
href	string	Destinazione del collegamento.
hreflang	string	Suggerimento che indica la lingua del risultato della dereferenziazione del collegamento.
rel	string	Tipo di relazione.
title	string	Usato per etichettare la destinazione di un collegamento in modo che possa essere usato come identificatore leggibile (ad esempio, una voce di menu) nella lingua indicata dal campo intestazione Content-Language (se presente).
type	string	Suggerimento che indica il tipo di supporto del risultato della dereferenziazione del collegamento.

Condividi tramite