Search - Get Geocode Autocomplete
Utilizzare questa opzione per ottenere un elenco classificato di entità suggerite in base alla posizione di un utente e a una query parziale.
Data una richiesta con la posizione dell'utente e una query parziale che funge da prefisso di una stringa di query completa (chiamata prefisso di query), l'API di Autocompletamento di Mappe di Azure restituisce un elenco di entità suggerite che l'utente probabilmente sta cercando. Queste entità sono classificate dalla più alla meno probabile.
GET {endpoint}/geocode:autocomplete?api-version=2026-01-01&query={query}
GET {endpoint}/geocode:autocomplete?api-version=2026-01-01&query={query}&coordinates={coordinates}&bbox={bbox}&top={top}&resultTypeGroups={resultTypeGroups}&resultTypes={resultTypes}&view={view}&countryRegion={countryRegion}
Parametri dell'URI
| Nome | In | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
endpoint
|
path | True |
string (uri) |
Il nome host del servizio Mappe di Azure. Usa |
|
api-version
|
query | True |
string minLength: 1 |
Versione dell'API da usare per questa operazione. |
|
query
|
query | True |
string |
Obbligatorio. Prefisso della query dell'utente. Esempio: "1 Micro" o "Muir Woods". |
|
bbox
|
query |
number[] |
Obbligatorio quando Esempio: lon1,lat1,lon2,lat2. Dimensioni minime: circa 0,00001 gradi (~0,01 metri). Dimensione massima: fino all'intera estensione globale (da -180,-90 a 180,90) |
|
|
coordinates
|
query |
number[] |
Obbligatorio quando
Nota: |
|
|
country
|
query |
string |
Segnala il risultato del completamento automatico a un codice regione/paese ISO 3166-1 Alpha-2 specificato, ad esempio FR. Verranno restituiti solo i risultati nel paese o nell'area geografica specificata. |
|
|
result
|
query |
Elenco delimitato da virgole dei gruppi di tipi di entità restituiti. I valori possibili sono
|
||
|
result
|
query |
Elenco delimitato da virgole dei tipi di entità restituiti. Quando il tipo group è impostato su Address, i tipi supportati sono:
Tutti gli altri tipi appartengono al gruppo Tipo di luogo. Questi possono includere entità come AdminDivision1, Neighborhood, PopulatedPlace e altro ancora. Il valore predefinito è tutti i tipi di entità possibili. |
||
|
top
|
query |
integer (int32) minimum: 1maximum: 20 |
Numero massimo di risposte che verranno restituite. Impostazione predefinita: 5, minimo: 1 e massimo: 20. |
|
|
view
|
query |
string |
Stringa che rappresenta un codice area/paese ISO 3166-1 Alpha-2. In questo modo verranno modificati i bordi e le etichette geopolitici contestati per allinearsi all'area utente specificata. Per impostazione predefinita, il parametro View è impostato su "Auto" anche se non è stato definito nella richiesta. Per informazioni dettagliate e per visualizzare le visualizzazioni disponibili, vedere viste supportate. |
Intestazione della richiesta
| Nome | Necessario | Tipo | Descrizione |
|---|---|---|---|
| x-ms-client-id |
string |
Specifica quale account è destinato all'uso in combinazione con il modello di sicurezza di Azure AD. Rappresenta un ID unico per l'account Mappe di Azure e può essere recuperato dall'API Account del piano di gestione Mappe di Azure. Per maggiori informazioni sull'uso della sicurezza Microsoft Entra ID in Mappe di Azure, vedi Gestire l'autenticazione in Mappe di Azure. |
|
| Accept-Language |
string |
Lingua in cui devono essere restituiti i risultati della ricerca. Per informazioni dettagliate, vedere lingue supportate. |
Risposte
| Nome | Tipo | Descrizione |
|---|---|---|
| 200 OK |
La richiesta ha avuto esito positivo. Media Types: "application/geo+json", "application/json" |
|
| Other Status Codes |
Risposta di errore imprevista. Media Types: "application/geo+json", "application/json" Intestazioni x-ms-error-code: string |
Sicurezza
AadToken
Questi sono i flussi Microsoft Entra OAuth 2.0. Quando abbinata al controllo Azure basato su ruolo può essere utilizzata per controllare l'accesso alle API REST di Mappe di Azure. I controlli di accesso basati su ruoli di Azure sono utilizzati per designare l'accesso a uno o più account o sottorisorse risorse di Mappe di Azure. 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 le API REST di Mappe di Azure.
Per implementare scenari, è consigliabile visualizzare 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-idper indicare a quale risorsa di Mappe di Azure l'applicazione richiede l'accesso. Questa operazione può essere acquisita dall'API di gestione di mappe . - Il
Authorization URLè specifico dell'istanza del cloud pubblico di Azure. I cloud sovrani hanno URL di autorizzazione unici e configurazioni Microsoft Entra ID. - Il controllo degli accessi in base al ruolo di Azure viene configurato dal piano di gestione di Azure tramite il portale di Azure, PowerShell, l'interfaccia della riga di comando, gli SDK di Azure o le API REST.
- L'utilizzo della Sdk Web di 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 di 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 |
subscription-key
Si tratta di una chiave condivisa di cui viene effettuato il provisioning quando si Creare un account di Mappe di Azure nel 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 applicazioni client riservate per accedere alle API REST di Mappe di Azure in modo che la chiave possa essere archiviata in modo sicuro.
Tipo:
apiKey
In:
header
SAS Token
Si tratta di un token di firma di accesso condiviso creato dall'operazione List SAS nell'risorsa di Mappe di Azure tramite il piano di gestione di Azure tramite il portale di Azure, PowerShell, l'interfaccia della riga di comando, gli SDK di Azure o le API REST.
Con questo token, qualsiasi applicazione è autorizzata ad accedere ai controlli di accesso in base al ruolo di Azure e al controllo granulare per la scadenza, la frequenza e le 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
Autocomplete API call to search for '1 Microsoft'
Esempio di richiesta
GET https://atlas.microsoft.com/geocode:autocomplete?api-version=2026-01-01&query=1 Microsoft&coordinates=-113.301894,49.201888
Risposta di esempio
Content-Type: application/geo+json
{
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"geometry": null,
"properties": {
"typeGroup": "Address",
"type": "Address",
"address": {
"streetNumber": "1",
"streetName": "Microsoft Way",
"addressLine": "1 Microsoft Way",
"locality": "Redmond",
"adminDistricts": [
{
"name": "Washington"
},
{
"name": "King County"
}
],
"countryRegion": {
"ISO": "US",
"name": "United States"
},
"postalCode": "98052",
"formattedAddress": "1 Microsoft Way, Redmond, Washington 98052, United States"
}
}
},
{
"type": "Feature",
"geometry": null,
"properties": {
"typeGroup": "Place",
"type": "LandmarkBuilding",
"address": {
"locality": "Bellevue",
"adminDistricts": [
{
"name": "Washington"
},
{
"name": "King County"
}
],
"countryRegion": {
"ISO": "US",
"name": "United States"
},
"formattedAddress": "Bellevue, Washington, United States"
},
"name": "Microsoft-Advanta C"
}
}
]
}
Autocomplete API call to search for '1 Microsoft Way, Redmond', filtered by roadblock resultTypes, place resultTypeGroups, and return empty result
Esempio di richiesta
GET https://atlas.microsoft.com/geocode:autocomplete?api-version=2026-01-01&query=1 Microsoft Way, Redmond&coordinates=-113.301894,49.201888&resultTypeGroups=Place&resultTypes=RoadBlock
Risposta di esempio
Content-Type: application/geo+json
{
"type": "FeatureCollection",
"features": []
}
Autocomplete API call to search for 'Muir Woods', filtered by address resultTypeGroups
Esempio di richiesta
GET https://atlas.microsoft.com/geocode:autocomplete?api-version=2026-01-01&query=Muir Woods&coordinates=-113.301894,49.201888&resultTypeGroups=Address
Risposta di esempio
Content-Type: application/geo+json
{
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"geometry": null,
"properties": {
"typeGroup": "Address",
"type": "RoadBlock",
"address": {
"locality": "Mill Valley",
"adminDistricts": [
{
"name": "California",
"shortName": "CA"
},
{
"name": "Marin County"
}
],
"countryRegion": {
"ISO": "US",
"name": "United States"
},
"postalCode": "94941",
"streetName": "Muir Woods Trail",
"addressLine": "",
"formattedAddress": "Muir Woods Trail, Mill Valley, CA 94941, United States"
}
}
},
{
"type": "Feature",
"geometry": null,
"properties": {
"typeGroup": "Address",
"type": "RoadBlock",
"address": {
"locality": "Sausalito",
"adminDistricts": [
{
"name": "California",
"shortName": "CA"
},
{
"name": "Marin County"
}
],
"countryRegion": {
"ISO": "US",
"name": "United States"
},
"postalCode": "94965",
"streetName": "Muir Woods Rd",
"addressLine": "",
"formattedAddress": "Muir Woods Rd, Sausalito, CA 94965, United States"
}
}
},
{
"type": "Feature",
"geometry": null,
"properties": {
"typeGroup": "Address",
"type": "RoadBlock",
"address": {
"locality": "Las Vegas",
"adminDistricts": [
{
"name": "Nevada",
"shortName": "NV"
},
{
"name": "Clark County"
}
],
"countryRegion": {
"ISO": "US",
"name": "United States"
},
"postalCode": "89122",
"streetName": "Muir Woods Pkwy",
"addressLine": "",
"formattedAddress": "Muir Woods Pkwy, Las Vegas, NV 89122, United States"
}
}
},
{
"type": "Feature",
"geometry": null,
"properties": {
"typeGroup": "Address",
"type": "RoadBlock",
"address": {
"locality": "Stockton",
"adminDistricts": [
{
"name": "California",
"shortName": "CA"
},
{
"name": "San Joaquin County"
}
],
"countryRegion": {
"ISO": "US",
"name": "United States"
},
"postalCode": "95209",
"streetName": "Muir Woods Ave",
"addressLine": "",
"formattedAddress": "Muir Woods Ave, Stockton, CA 95209, United States"
}
}
},
{
"type": "Feature",
"geometry": null,
"properties": {
"typeGroup": "Address",
"type": "RoadBlock",
"address": {
"locality": "Stonington",
"adminDistricts": [
{
"name": "Maine",
"shortName": "ME"
},
{
"name": "Hancock County"
}
],
"countryRegion": {
"ISO": "US",
"name": "United States"
},
"postalCode": "04681",
"streetName": "Muir Woods Rd",
"addressLine": "",
"formattedAddress": "Muir Woods Rd, Stonington, ME 04681, United States"
}
}
}
]
}
Autocomplete API call to search for 'Muir Woods', filtered by park and populated place resultTypes, place resultTypeGroups
Esempio di richiesta
GET https://atlas.microsoft.com/geocode:autocomplete?api-version=2026-01-01&query=Muir Woods&coordinates=-122.581711,37.896980&resultTypeGroups=Place&resultTypes=Park,PopulatedPlace
Risposta di esempio
Content-Type: application/geo+json
{
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"geometry": null,
"properties": {
"typeGroup": "Place",
"type": "PopulatedPlace",
"address": {
"locality": "Muir Woods",
"adminDistricts": [
{
"name": "Georgia"
},
{
"name": "Fulton County"
}
],
"countryRegion": {
"ISO": "US",
"name": "United States"
},
"postalCode": "30349",
"formattedAddress": "Muir Woods, Georgia 30349, United States"
}
}
},
{
"type": "Feature",
"geometry": null,
"properties": {
"typeGroup": "Place",
"type": "Park",
"address": {
"adminDistricts": [
{
"name": "California"
},
{
"name": "Marin County"
}
],
"countryRegion": {
"ISO": "US",
"name": "United States"
},
"formattedAddress": "California"
},
"name": "Muir Woods National Park"
}
}
]
}
Autocomplete API call to search for 'Muir Woods', filtered by park resultTypes
Esempio di richiesta
GET https://atlas.microsoft.com/geocode:autocomplete?api-version=2026-01-01&query=Muir Woods&coordinates=-122.581711,37.896980&resultTypes=Park
Risposta di esempio
Content-Type: application/geo+json
{
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"geometry": null,
"properties": {
"typeGroup": "Place",
"type": "Park",
"address": {
"adminDistricts": [
{
"name": "California"
},
{
"name": "Marin County"
}
],
"countryRegion": {
"ISO": "US",
"name": "United States"
},
"formattedAddress": "California"
},
"name": "Muir Woods National Monument"
}
}
]
}
Autocomplete API call to search for 'Muir Woods', filtered by place resultTypeGroups
Esempio di richiesta
GET https://atlas.microsoft.com/geocode:autocomplete?api-version=2026-01-01&query=Muir Woods&coordinates=-122.581711,37.896980&resultTypeGroups=Place
Risposta di esempio
Content-Type: application/geo+json
{
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"geometry": null,
"properties": {
"typeGroup": "Place",
"type": "Forest",
"address": {
"adminDistricts": [
{
"name": "Wisconsin"
},
{
"name": "Dane County"
}
],
"countryRegion": {
"ISO": "US",
"name": "United States"
},
"formattedAddress": "Wisconsin"
},
"name": "Muir Woods"
}
},
{
"type": "Feature",
"geometry": null,
"properties": {
"typeGroup": "Place",
"type": "PopulatedPlace",
"address": {
"locality": "Muir Woods",
"adminDistricts": [
{
"name": "Georgia"
},
{
"name": "Fulton County"
}
],
"countryRegion": {
"ISO": "US",
"name": "United States"
},
"postalCode": "30349",
"formattedAddress": "Muir Woods, Georgia 30349, United States"
}
}
},
{
"type": "Feature",
"geometry": null,
"properties": {
"typeGroup": "Place",
"type": "Park",
"address": {
"adminDistricts": [
{
"name": "California"
},
{
"name": "Marin County"
}
],
"countryRegion": {
"ISO": "US",
"name": "United States"
},
"formattedAddress": "California"
},
"name": "Muir Woods National Monument"
}
}
]
}
Autocomplete API call to search for 'Muir Woods', filtered by roadblock resultTypes, address resultTypeGroups
Esempio di richiesta
GET https://atlas.microsoft.com/geocode:autocomplete?api-version=2026-01-01&query=Muir Woods&coordinates=-113.301894,49.201888&resultTypeGroups=Address&resultTypes=RoadBlock
Risposta di esempio
Content-Type: application/geo+json
{
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"geometry": null,
"properties": {
"typeGroup": "Address",
"type": "RoadBlock",
"address": {
"streetName": "Muir St",
"addressLine": " Muir St",
"locality": "Grosse Pointe Farms",
"adminDistricts": [
{
"name": "Michigan"
},
{
"name": "Wayne County"
}
],
"countryRegion": {
"ISO": "US",
"name": "United States"
},
"postalCode": "48236",
"formattedAddress": "Muir St, Grosse Pointe Farms, Michigan 48236, United States"
}
}
}
]
}
Definizioni
| Nome | Descrizione |
|---|---|
| Address |
L'indirizzo di una posizione suggerita da geocodifica o autocompletamento, suddivisa in campi strutturati.
La scarsità è normale: sono popolati solo i campi che l'entità risolta fornisce in mente. Ad esempio, |
|
Address |
Una suddivisione amministrativa che contiene un indirizzo. Ad esempio, uno stato, una provincia o una contea. Restituito come una voce nella matrice principale |
|
Address |
Il paese o la regione che contiene l'indirizzo, identificato dal nome visualizzato e dal codice paese ISO 3166-1 Alpha-2. Entrambi i campi possono essere omessi in una determinata risposta. |
|
Autocomplete |
Una singola voce nell'array |
|
Autocomplete |
Il |
|
Autocomplete |
Il corpo di risposta riuscito restituì da |
|
Autocomplete |
Una classificazione delle suggerimenti di autocompletamento usata sia |
|
Autocomplete |
Una classificazione grossolana di una suggestione di autocompletamento in uno di due gruppi. Utilizzato sia |
|
Azure. |
Oggetto error. |
|
Azure. |
Risposta contenente i dettagli dell'errore. |
|
Azure. |
Oggetto contenente informazioni più specifiche sull'errore. Secondo le linee guida Azure REST API - https://aka.ms/AzureRestApiGuidelines#handling-errors. |
|
Feature |
Il |
|
Feature |
Il |
|
Geo |
Specifica il tipo di |
|
Geo |
Tipo geometry |
| Intersection |
I dettagli dell'intersezione per un indirizzo si risolvono come un incrocio stradale — l'angolo dove si incontrano due o più strade con nome. Popolata solo quando l'entità risolta è un |
Address
L'indirizzo di una posizione suggerita da geocodifica o autocompletamento, suddivisa in campi strutturati.
La scarsità è normale: sono popolati solo i campi che l'entità risolta fornisce in mente. Ad esempio, streetName e streetNumber appaiono solo per indirizzi a livello strada, e intersection appaiono solo per i risultati degli incroci stradali.
| Nome | Tipo | Descrizione |
|---|---|---|
| addressLine |
string |
La prima riga dell'indirizzo, tipicamente il nome e il numero della strada. Ad esempio: |
| adminDistricts |
Le suddivisioni amministrative che contengono l'indirizzo, ordinate dal più grossolano al più raffinato. La prima voce è tipicamente la suddivisione di primo ordine (come uno stato degli Stati Uniti o una provincia canadese); Le voci successive coprono le suddivisioni più precise in cui il paese, la dipendenza o la regione le definisce (come una contea all'indice 1). |
|
| countryRegion |
Il paese o la regione che contiene l'indirizzo, con il suo nome visualizzato e il codice paese ISO 3166-1 Alpha-2. |
|
| formattedAddress |
string |
L'indirizzo completo viene reso come una singola stringa leggibile dall'uomo, con i componenti uniti secondo le convenzioni del paese o della regione dell'indirizzo. Esempio: |
| intersection |
I dettagli delle strade che si intersecano per l'indirizzo, popolati quando l'entità risolta è un |
|
| locality |
string |
La località in cui si trova l'indirizzo: di solito una città, un paese o un villaggio. Ad esempio: |
| neighborhood |
string |
Il quartiere nominato all'interno della località, quando viene identificato. |
| postalCode |
string |
Il codice postale dell'indirizzo, quando viene definito. Esempio: |
| streetName |
string |
La componente del nome stradale dell'indirizzo, quando l'entità risolta è un indirizzo a livello strada. Esempio: |
| streetNumber |
string |
Il numero della casa o dell'edificio sulla strada, quando l'entità risolta è un indirizzo a livello strada. Esempio: |
AddressAdminDistrictsItem
Una suddivisione amministrativa che contiene un indirizzo. Ad esempio, uno stato, una provincia o una contea. Restituito come una voce nella matrice principale Address.adminDistricts , dove le voci sono ordinate dal più grossolano al più fine.
| Nome | Tipo | Descrizione |
|---|---|---|
| name |
string |
Il nome completo del quartiere. Ad esempio, |
| shortName |
string |
La forma abbreviata o abbreviata del nome della suddivisione, quando viene definita una. Ad esempio, |
AddressCountryRegion
Il paese o la regione che contiene l'indirizzo, identificato dal nome visualizzato e dal codice paese ISO 3166-1 Alpha-2. Entrambi i campi possono essere omessi in una determinata risposta.
| Nome | Tipo | Descrizione |
|---|---|---|
| ISO |
string |
Il codice paese ISO 3166-1 Alpha-2 per il paese o la regione. Ad esempio, |
| name |
string |
Il nome visualizzato del paese o della regione. Ad esempio: |
AutocompleteFeature
Una singola voce nell'array features di un AutocompleteResponse, conforme alla forma dell'oggetto GeoJSON Feature .
Rappresenta una proposta di autocompletamento: classificazione (type, typeGroup), indirizzo analizzato e nome opzionale del luogo sono esposti tramite properties, con una coordinata rappresentativa su geometry quando è disponibile.
| Nome | Tipo | Descrizione |
|---|---|---|
| geometry |
La coordinata della proposta di autocompletamento è un |
|
| properties |
Dati strutturati sulla proposta di autocompletamento, inclusa la sua classificazione, indirizzo analizzato e (per |
|
| type |
Il tipo di |
AutocompleteProperties
Il properties carico utile di un AutocompleteFeature. Contiene la classificazione del risultato (typeGroup, type), il suo indirizzo analizzato e (per molti Placerisultati -tipizzati) un nome di visualizzazione separato.
| Nome | Tipo | Descrizione |
|---|---|---|
| address |
L'indirizzo del risultato di autocompletamento, analizzato in campi strutturati.
|
|
| name |
string |
Il nome visualizzato del luogo suggerito. Popolati per |
| type |
Il tipo specifico di entità a cui il risultato si risolve. Ad esempio, un indirizzo, un luogo popolato, un parco o un punto di riferimento. Vedi |
|
| typeGroup |
La classificazione ampia del risultato come indirizzo o luogo nominato. Vedi |
AutocompleteResponse
Il corpo di risposta riuscito restituì da Get Autocomplete. Codificato come un GeoJSON FeatureCollection array di cui features contiene uno Feature per ogni suggerimento di autocompletamento, classificato dal più al meno probabile.
| Nome | Tipo | Descrizione |
|---|---|---|
| features |
L'array degli |
|
| nextLink |
string |
Contiene l'URL per recuperare la pagina successiva dei risultati se la risposta è paginata. Questo è utile quando la risposta è troppo ampia per essere restituita in una singola chiamata, permettendo agli utenti di navigare tra più pagine di risultati. |
| type |
Il |
AutocompleteResultTypeEnum
Una classificazione delle suggerimenti di autocompletamento usata sia Get Autocomplete come filtro di input (tramite il parametro resultTypes di query) sia come etichetta di output (tramite il type campo su ciascun AutocompleteProperties). I membri definiscono una tassonomia in stile gazzettaio che comprende indirizzi, segmenti stradali, regioni amministrative, luoghi popolati, caratteristiche naturali e punti di interesse. Questa tassonomia è suddivisa in due gruppi più ampi da AutocompleteResultTypeGroupsEnum: Address, che copre indirizzi e segmenti stradali; e Place, che copre tutti gli altri tipi di risultati.
| Valore | Descrizione |
|---|---|
| Address |
Un indirizzo specifico. |
| AdminDivision1 |
Primo livello amministrativo all'interno del paese/regione, come uno stato o una provincia. |
| AdminDivision2 |
Secondo livello amministrativo all'interno del paese/regione, come una contea. |
| AdminDivision3 |
Terzo livello amministrativo all'interno del paese/regione, come un distretto, una parrocchia o un comune. |
| AdministrativeBuilding |
Un edificio che ospita uffici governativi o funzioni amministrative pubbliche. |
| Airport |
Una struttura dove gli aerei decollano e atterrano regolarmente, con strutture per passeggeri e carichi. |
| AirportTerminal |
Un edificio terminale passeggeri all'interno di un aeroporto. |
| AmusementPark |
Una struttura di intrattenimento con giostre, giochi e attrazioni a tema. |
| AncientSite |
Un luogo dove sono conservati resti archeologici o manufatti culturali di un'antica cultura. |
| Aquarium |
Una struttura pubblica dove vengono esposti e studiati piante e animali acquatici. |
| Archipelago |
Un gruppo o catena di isole. |
| Basin |
Una depressione naturale sulla superficie terrestre, spesso circondata da terreni più elevati. |
| Battlefield |
Un luogo di una battaglia terrestre di grande importanza storica. |
| Bay |
Un corpo d'acqua parzialmente recintato, più piccolo di un golfo e più grande di una baia. |
| Beach |
Una riva di sabbia, ciottoli o altri sedimenti non consolidati lungo un corpo d'acqua. |
| Bridge |
Una struttura che sostiene una strada, una ferrovia o un sentiero attraverso un ostacolo come un fiume, una valle o un'altra strada. |
| BusinessStructure |
Un edificio utilizzato per attività commerciali o commerciali generali che non rientra in una categoria più specifica. |
| Camp |
Un sito con rifugi o strutture per occupazione temporanea, come un campeggio o un insediamento stagionale. |
| Canal |
Un corso d'acqua artificiale utilizzato per trasporti, irrigazione o drenaggio. |
| Casino |
Una struttura utilizzata per il gioco d'azzardo e i giochi d'azzardo. |
| Castle |
Un edificio storicamente fortificato o complesso di edifici, tipicamente associato a residenze nobili o reali. |
| Cave |
Una camera o passaggio naturale sotterraneo formato nella roccia. |
| Cemetery |
Un luogo di sepoltura o un cimitero. |
| Channel |
Un corso d'acqua navigabile tra due corpi terrestri o il percorso principale di flusso di un corpo idrico più grande. |
| Church |
Un edificio utilizzato per il culto cristiano pubblico. |
| Cliff |
Una parete alta e ripida di roccia o terra, spesso che domina una costa o una valle. |
| Coast |
Un tratto di terra con nome che confina con il mare. |
| CommunityCenter |
Una struttura che ospita attività comunitarie, riunioni e servizi sociali. |
| Continent |
Uno dei principali continenti terrestri. |
| CountryRegion |
Un paese o una regione. |
| Crater |
Una depressione circolare formata da attività vulcanica o da impatto di meteorite. |
| CulturalRegion |
Un'area caratterizzata da caratteristiche culturali condivise, come lingua, etnia o patrimonio. |
| Dam |
Una barriera costruita attraversando un ruscello o un fiume per trattenere l'acqua. |
| Delta |
Si è formata una forma di depositi alluvionali dove un fiume incontra un corpo d'acqua più grande. |
| Desert |
Una vasta regione arida con vegetazione scarsa a causa delle precipitazioni limitate. |
| DrainageBasin |
Un'area di terra drenata da un sistema fluviale e dai suoi affluenti. |
| Dune |
Un cumulo o una cresta di sabbia soffiata dal vento. |
| FacilityStructure |
Una struttura che ospita una struttura specializzata, come un impianto di servizi o un'installazione di servizi. |
| FerryTerminal |
Una struttura dove passeggeri e veicoli salgono e scendono dai traghetti. |
| FinancialStructure |
Un edificio che ospita una banca, una cooperativa di credito o altri istituti di servizi finanziari. |
| FireStation |
Un edificio che ospita vigili del fuoco, attrezzature e veicoli di emergenza. |
| Forest |
Una vasta area di terreno dominata dagli alberi. |
| Fort |
Una struttura militare difensiva o opere di terra. |
| Garden |
Un'area coltivata per l'esposizione di piante ornamentali o curate scientificamente. |
| Geyser |
Una sorgente termale che periodicamente eruta getti d'acqua e vapore. |
| Glacier |
Una massa persistente di ghiaccio che si muove lentamente sotto il proprio peso. |
| GolfCourse |
Un campo allestito per giocare a golf. |
| GreaterPopulatedPlace |
Un'area metropolitana o conurbazione che contiene ed estende oltre un luogo abitato. |
| HigherEducationFacility |
Un college, università o istituzione simile di istruzione post-secondaria. |
| HistoricalSite |
Un sito di rilevanza storica, spesso conservato come luogo di patrimonio culturale. |
| Hospital |
Una struttura medica che offre assistenza sia per pazienti residenziali che ambulatoriali. |
| HotSpring |
Una sorgente naturale da cui emerge acqua sotterranea riscaldata geotermicamente alla superficie. |
| Ice |
Una massa naturale o uno strato superficiale di acqua ghiacciata che ricopre terra o acqua. |
| IndigenousPeoplesReserve |
Un territorio riconosciuto come patria di un popolo o comunità indigena. |
| IndustrialStructure |
Un edificio o un'installazione utilizzata per la produzione, la produzione o altre operazioni industriali. |
| Island |
Una massa terrestre circondata dall'acqua, più piccola di un continente. |
| Isthmus |
Una stretta striscia di terra che collega due masse terrestri più grandi e separa due specchi d'acqua. |
| Lake |
Un corpo d'acqua stagnante nell'entroterra circondato da terraferma. |
| LandArea |
Una regione terrestre nominata che non rientra in una categoria geografica più specifica. |
| Landform |
Una caratteristica naturale del terreno che non rientra in una categoria più specifica, come un |
| LandmarkBuilding |
Un edificio notevole di importanza architettonica, culturale o storica che funge da punto di riferimento riconoscibile. |
| Library |
Un edificio che ospita una collezione di libri e altri supporti disponibili per l'uso pubblico. |
| Lighthouse |
Una struttura costiera o portuale che espone una luce di navigazione per guidare le navi. |
| Marina |
Una struttura portuale che fornisce ormeggi e servizi per piccole imbarcazioni e yacht. |
| Market |
Un luogo dove i beni vengono comprati e venduti, tipicamente al dettaglio. |
| MedicalStructure |
Un edificio utilizzato per servizi medici o sanitari diversi da un |
| MetroStation |
Una stazione su una metropolitana, sotterranea o altro sistema ferroviario urbano a rapido livello. |
| MilitaryBase |
Un'installazione gestita dalle forze armate per addestramento, rifornimento o operazioni. |
| Mission |
Un complesso gestito da un gruppo religioso per fornire servizi alla comunità e propagare la fede. |
| Monument |
Una struttura commemorativa o una statua eretta per onorare una persona, un evento o un'idea. |
| Mosque |
Un edificio utilizzato per il culto islamico pubblico. |
| Mountain |
Una forma del terreno che si eleva significativamente sopra i dintorni, tipicamente con pendii ripidi e una vetta definita. |
| MountainRange |
Una serie collegata di montagne che formano una catena continua. |
| MultiModalStation |
Una stazione che serve più modalità di trasporto, come ferrovia, autobus o metropolitana combinata. |
| Museum |
Una struttura dove vengono conservati ed esposti oggetti di interesse artistico, scientifico o storico. |
| NauticalStructure |
Una struttura legata ad attività marittime o nautiche, come un molo, un molo o una boa. |
| Neighborhood |
Un'area riconosciuta localmente all'interno di un luogo popolato, spesso con confini informali o culturalmente definiti. |
| Oasis |
Un'area fertile in un deserto sostenuta da una fonte d'acqua naturale. |
| ObservationPoint |
Un punto panoramico o punto di osservazione che offre viste panoramiche dell'area circostante. |
| Ocean |
Una delle principali divisioni dell'oceano globale della Terra. |
| OfficeBuilding |
Un edificio utilizzato principalmente come uffici professionali o amministrativi. |
| Other |
Un suggerimento che non si adatta a nessun altro tipo definito. |
| Park |
Un'area mantenuta per attività ricreative pubbliche o per il piacere paesaggistico. |
| ParkingStructure |
Una struttura a più livelli dedicata al parcheggio dei veicoli. |
| Pass |
Un percorso navigabile attraverso o sopra una catena montuosa o un ostacolo simile. |
| Peninsula |
Una massa terrestre che si proteneva in un corpo d'acqua e quasi circondata da esso. |
| Plain |
Un'ampia area di terreno relativamente pianeggiante o dolcemente ondulato. |
| Planet |
Un corpo celeste che orbita attorno a una stella, tipicamente usato per rappresentare la Terra come radice della gerarchia geografica. |
| Plateau |
Un'area elevata di terreno relativamente pianeggiante con pendii ripidi su uno o più lati. |
| Playground |
Un'area ricreativa attrezzata per il gioco dei bambini. |
| PlayingField |
Un'area aperta utilizzata per praticare sport organizzati. |
| Pole |
Un polo geografico, come il Polo Nord o il Polo Sud. |
| PoliticalUnit |
Un'entità politica autonoma, come uno stato o territorio indipendente o dipendente. |
| PopulatedPlace |
Un'area concentrata di insediamento umano, come una città, un paese o un villaggio. |
| Port |
Una struttura marittima con terminal per il carico e lo scarico di merci o passeggeri via mare. |
| Postcode1 |
La categoria di codice postale più piccola, come un CAP. |
| Promontory |
Una prominente forma di rilievo che si protende in una pianura o in uno specchio d'acqua. |
| RaceTrack |
Una pista o un percorso progettato per veicoli da corsa, animali o atleti. |
| RailwayStation |
Una struttura dove i passeggeri salgono e scendono dai treni. |
| Reef |
Una cresta sommersa o parzialmente sommersa di roccia, sabbia o corallo vicino alla superficie dell'acqua. |
| ReligiousStructure |
Un edificio usato per il culto o la pratica religiosa che non rientra in una categoria più specifica, come |
| Reserve |
Un appezzamento protetto di terra riservato alla conservazione, alla fauna selvatica o ad altri usi restritivi. |
| ResidentialStructure |
Un edificio utilizzato principalmente per la residenza umana, come un complesso di appartamenti o abitazioni. |
| River |
Un corso d'acqua naturale che scorre verso un'altitudine più bassa, tipicamente verso un mare, un lago o un altro fiume. |
| RoadBlock |
Un segmento di strada senza un numero di casa specifico, restituito quando il servizio di geocodifica non riesce a trovare un numero esatto per la consulta. Nonostante il nome, questo valore non indica una chiusura fisica della strada. |
| Ruin |
Una struttura distrutta o decadente che non svolge più la sua funzione originale. |
| ScientificResearchBase |
Una struttura utilizzata come base per la ricerca scientifica, spesso in ambienti remoti o estremi. |
| Sea |
Un grande corpo d'acqua salata parzialmente recintata dalla terraferma, più piccola di un oceano. |
| SeaplaneLandingArea |
Un'area d'acqua destinata al decollo e all'atterraggio degli idrovolanti. |
| Shrine |
Una struttura o un sito che commemora una persona o commemora un evento o concetto sacro. |
| SkiArea |
Un'area ricreativa sviluppata per lo sci e altri sport invernali. |
| Spring |
Una fonte naturale da cui l'acqua sotterranea scorre dalla superficie terrestre. |
| Stadium |
Un ampio impianto con posti a sedere a livelli per sport o eventi per spettatori. |
| StatisticalDistrict |
Una regione definita a scopo statistico o censuario, come un'area statistica metropolitana o un tratto censuario. |
| Temple |
Un edificio dedicato al culto religioso. |
| Theater |
Un luogo per la presentazione di opere teatrali, film o altre esibizioni dal vivo o registrate. |
| TouristRailway |
Una ferrovia panoramica o storica operava principalmente per il turismo piuttosto che per il trasporto regolare. |
| TouristStructure |
Un edificio che serve i turisti, come un centro visitatori o un ufficio informazioni turistiche. |
| Trailhead |
Il punto di partenza di un sentiero per escursioni, ciclismo o ricreazione. |
| TransportationStructure |
Una struttura che supporta infrastrutture di trasporto, come un casello, una pesata o una pensilina di transito. |
| Tunnel |
Un passaggio sotterraneo o subacqueo per il trasporto stradale, ferroviario o pedonale. |
| Valley |
Un'area allungata e bassa tra colline o montagne, spesso contenente un corso d'acqua. |
| Volcano |
Una montagna o collina formata da attività vulcanica, tipicamente con un cratere sulla sua sommità. |
| Walkway |
Un sentiero o una superficie asfaltata destinata all'uso pedonale. |
| Wall |
Una barriera costruita che forma un confine verticale continuo, spesso usata per difesa, separazione o commemorazione. |
| Waterfall |
Un punto in cui un ruscello o un fiume scende verticalmente o ripidamente. |
| WaterFeature |
Un corpo d'acqua che non rientra in una categoria più specifica, come un |
| Wetland |
Un'area di terra satura d'acqua e che supporta vegetazione acquatica, come una palude o una palude. |
| Winery |
Una struttura dove il vino viene prodotto e spesso offerto per degustazione o vendita. |
| Zoo |
Una struttura dove gli animali selvatici vengono tenuti per esposizione pubblica e studio. |
AutocompleteResultTypeGroupsEnum
Una classificazione grossolana di una suggestione di autocompletamento in uno di due gruppi. Utilizzato sia Get Autocomplete come filtro di input tramite il resultTypeGroups parametro di query (che limita quali tipi di suggerimenti vengono restituiti) sia come classificatore di output tramite il typeGroup campo di ciascuno AutocompleteProperties (identificando a quale gruppo appartiene una suggestione restituita). Il Address gruppo copre indirizzi individuali e segmenti di strada; copre Place tutti gli altri tipi di entità (regioni amministrative, luoghi popolati, caratteristiche naturali e punti di interesse).
| Valore | Descrizione |
|---|---|
| Address |
Suggerimenti che si riferiscono a un indirizzo specifico o a un tratto stradale. |
| Place |
Suggerimenti che si riuniscono a luoghi nominati, inclusi regioni amministrative, luoghi popolati, quartieri, caratteristiche naturali e punti di interesse. Gli esempi includono |
Azure.Core.Foundations.Error
Oggetto error.
| Nome | Tipo | Descrizione |
|---|---|---|
| code |
string |
Uno di un set definito dal server di codici di errore. |
| details |
Matrice di dettagli sugli errori specifici che hanno causato l'errore segnalato. |
|
| innererror |
Oggetto contenente informazioni più specifiche dell'oggetto corrente sull'errore. |
|
| message |
string |
Rappresentazione leggibile dell'errore. |
| target |
string |
Destinazione dell'errore. |
Azure.Core.Foundations.ErrorResponse
Risposta contenente i dettagli dell'errore.
| Nome | Tipo | Descrizione |
|---|---|---|
| error |
Oggetto error. |
Azure.Core.Foundations.InnerError
Oggetto contenente informazioni più specifiche sull'errore. Secondo le linee guida Azure REST API - https://aka.ms/AzureRestApiGuidelines#handling-errors.
| Nome | Tipo | Descrizione |
|---|---|---|
| code |
string |
Uno di un set definito dal server di codici di errore. |
| innererror |
Errore interno. |
FeatureCollectionEnum
Il GeoJSON tipo di oggetto utilizzato alla radice delle risposte riuscite delle operazioni di geocodifica diretta, geocodifica inversa e autocompletamento (incluse le loro varianti batch). L'unico valore è FeatureCollection, come definito nell'RFC 7946.
Get Polygon è l'unica eccezione: la sua radice di risposta è un GeoJSON Feature, vedi FeatureTypeEnum.
| Valore | Descrizione |
|---|---|
| FeatureCollection |
Il tipo di |
FeatureTypeEnum
Il GeoJSON tipo di oggetto per Feature gli oggetti. Etichetta ogni voce all'interno dell'array features di una FeatureCollection risposta (geocodifica, geocodifica inversa, autocompletamento) e appare alla radice della Get Polygon risposta. L'unico valore è Feature, come definito nell'RFC 7946.
| Valore | Descrizione |
|---|---|
| Feature |
Il tipo di |
GeoJsonObjectType
Specifica il tipo di GeoJSON. Deve essere uno dei nove tipi di oggetto GeoJSON validi: Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature e FeatureCollection.
| Valore | Descrizione |
|---|---|
| Point |
|
| MultiPoint |
|
| LineString |
|
| MultiLineString |
|
| Polygon |
|
| MultiPolygon |
|
| GeometryCollection |
|
| Feature |
Oggetto |
| FeatureCollection |
Oggetto |
GeoJsonPoint
Tipo geometry GeoJSON Point valido. Per informazioni dettagliate, vedere RFC 7946.
Intersection
I dettagli dell'intersezione per un indirizzo si risolvono come un incrocio stradale — l'angolo dove si incontrano due o più strade con nome. Popolata solo quando l'entità risolta è un RoadIntersection; il genitore Address.intersection viene altrimenti omesso.
| Nome | Tipo | Descrizione |
|---|---|---|
| baseStreet |
string |
La strada principale dell'incrocio — tipicamente la strada a cui si riferisce il numero di indirizzo. |
| displayName |
string |
Un nome leggibile dall'uomo per l'incrocio che combina le strade trasversali, come |
| intersectionType |
string |
Una breve etichetta che descrive la forma dell'incrocio. Ad esempio, distinguere un incrocio a livello da uno a livello separato come un ponte o un cavalcavia. |
| secondaryStreet1 |
string |
La prima strada incrociata che si incontra |
| secondaryStreet2 |
string |
La seconda strada trasversale all'incrocio, quando ce n'è presente. Popolata solo per incroci di tre o più strade. |