Search - Get Reverse Geocoding

Riferimento

Service:: Maps

API Version:: 2023-06-01

Usare per ottenere un indirizzo e informazioni sulla posizione da coordinate di longitudine e latitudine.

L'API Get Reverse Geocoding è una richiesta HTTP GET usata per tradurre una coordinata (esempio: 37.786505, -122.3862) in un indirizzo di strada comprensibile. Utile per tenere traccia delle applicazioni in cui si riceve un feed GPS dal dispositivo o dall'asset e si desidera conoscere l'indirizzo associato alle coordinate. Questo endpoint restituirà le informazioni sull'indirizzo per una determinata coordinata.

GET https://atlas.microsoft.com/reverseGeocode?api-version=2023-06-01&coordinates={coordinates}

With optional parameters:

GET https://atlas.microsoft.com/reverseGeocode?api-version=2023-06-01&coordinates={coordinates}&resultTypes={resultTypes}&view={view}

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
api-version	query	True	string	Numero di versione dell'API Mappe di Azure.
coordinates	query	True	number[]	Coordinate della posizione in cui si vuole invertire il codice geografico. Esempio: coordinate &=lon,lat
resultTypes	query		ReverseGeocodingResultTypeEnum[]	Specificare i tipi di entità desiderati nella risposta. Verranno restituiti solo i tipi specificati. Se il punto non può essere mappato ai tipi di entità specificati, non vengono restituite informazioni sulla posizione nella risposta. Il valore predefinito è tutte le entità possibili. Elenco delimitato da virgole di tipi di entità selezionati dalle opzioni seguenti. Indirizzo Quartiere PopolamentoPlace Codice postale1 AdminDivision1 AdminDivision2 CountryRegion Questi tipi di entità vengono ordinati dall'entità più specifica all'entità meno specifica. Quando vengono trovate entità di più di un tipo di entità, viene restituita solo l'entità più specifica. Ad esempio, se si specifica Indirizzo e AdminDistrict1 come tipi di entità e entità sono stati trovati per entrambi i tipi, vengono restituite solo le informazioni sull'entità Address nella risposta.
view	query		string	Stringa che rappresenta un codice di area alfa-2 ISO 3166-1. In questo modo verranno modificati i bordi e le etichette geopolitiche 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, vedere Visualizzazioni supportate e visualizzare le visualizzazioni disponibili.

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 di Azure AD. Rappresenta un ID univoco per l'account Mappe di Azure e può essere recuperato dall'API del piano di gestione Mappe di Azure. Per usare la sicurezza di Azure AD in Mappe di Azure vedere gli articoli seguenti per indicazioni.
Accept-Language		string	Lingua in cui devono essere restituiti i risultati della ricerca. Per informazioni dettagliate, vedere Lingue supportate .

Nome

Necessario

Tipo

Descrizione

x-ms-client-id

string

Specifica l'account destinato all'utilizzo in combinazione con il modello di sicurezza di Azure AD. Rappresenta un ID univoco per l'account Mappe di Azure e può essere recuperato dall'API del piano di gestione Mappe di Azure. Per usare la sicurezza di Azure AD in Mappe di Azure vedere gli articoli seguenti per indicazioni.

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	GeocodingResponse	OK Media Types: "application/geo+json"
Other Status Codes	ErrorResponse	Si è verificato un errore imprevisto. Media Types: "application/geo+json"

Nome

Tipo

Descrizione

200 OK

GeocodingResponse

Media Types: "application/geo+json"

Other Status Codes

ErrorResponse

Si è verificato un errore imprevisto.

Media Types: "application/geo+json"

Sicurezza

AADToken

Si tratta dei flussi OAuth 2.0 Microsoft Entra. Quando è associato 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 basati sul ruolo di Azure vengono usati per designare l'accesso a uno o più Mappe di Azure account delle risorse o alle sotto-risorse. 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 riepilogo, questa definizione di sicurezza offre una soluzione per la modellazione di applicazioni tramite oggetti in grado di controllare l'accesso in API e ambiti specifici.

Nota

Questa definizione di sicurezza richiede l'uso dell'intestazione x-ms-client-id per indicare quale Mappe di Azure risorsa a cui l'applicazione richiede l'accesso. Questa operazione può essere acquisita dall'API di gestione mappe.
L'oggetto 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 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 Microsoft Identity Platform.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

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 durante la creazione di una 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 questa chiave, qualsiasi applicazione è autorizzata ad accedere a tutte le API REST. In altre parole, questi possono essere attualmente considerati come chiavi master per l'account per cui vengono rilasciati.

Per le applicazioni esposte pubblicamente, è consigliabile usare l'accesso da server a server delle API REST Mappe di Azure in cui questa chiave può essere archiviata in modo sicuro.

Type: apiKey
In: header

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.

Type: apiKey
In: header

Esempio

Search point -122.138681, 47.630358

Sample Request

HTTP

GET https://atlas.microsoft.com/reverseGeocode?api-version=2023-06-01&coordinates=-122.138681,47.630358

Sample Response

Status code:: 200

Content-Type: application/geo+json

Response Body

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "properties": {
        "address": {
          "countryRegion": {
            "name": "United States"
          },
          "adminDistricts": [
            {
              "shortName": "WA"
            },
            {
              "shortName": "King County"
            }
          ],
          "formattedAddress": "15127 NE 24th St, Redmond, WA 98052",
          "locality": "Redmond",
          "postalCode": "98052",
          "addressLine": "15127 NE 24th St"
        },
        "type": "Address",
        "confidence": "Medium",
        "matchCodes": [
          "Good"
        ],
        "geocodePoints": [
          {
            "geometry": {
              "type": "Point",
              "coordinates": [
                -122.138681,
                47.630358
              ]
            },
            "calculationMethod": "Rooftop",
            "usageTypes": [
              "Display"
            ]
          },
          {
            "geometry": {
              "type": "Point",
              "coordinates": [
                -122.1386787,
                47.6302179
              ]
            },
            "calculationMethod": "Rooftop",
            "usageTypes": [
              "Route"
            ]
          }
        ]
      },
      "geometry": {
        "type": "Point",
        "coordinates": [
          -122.138681,
          47.630358
        ]
      },
      "bbox": [
        -122.14632282407,
        47.626495282429325,
        -122.13103917593001,
        47.63422071757068
      ]
    }
  ]
}

Definizioni

Nome	Descrizione
Address	Indirizzo del risultato
AdminDistricts	Nome di suddivisione nel paese o nell'area geografica per un indirizzo. Questo elemento viene in genere considerato come suddivisione amministrativa del primo ordine, ma in alcuni casi contiene anche la seconda, terza o quarta suddivisione dell'ordine in un paese, una dipendenza o un'area geografica.
CalculationMethodEnum	Metodo usato per calcolare il punto di codice geografico.
ConfidenceEnum	Il livello di attendibilità del risultato della posizione geografica è una corrispondenza. Usare questo valore con il codice di corrispondenza per determinare per informazioni più complete sulla corrispondenza. L'attendibilità di una posizione geocoded si basa su molti fattori, tra cui l'importanza relativa della posizione geografica e la posizione dell'utente, se specificato.
CountryRegion
ErrorAdditionalInfo	Informazioni aggiuntive sulla gestione delle risorse.
ErrorDetail	Dettagli dell'errore.
ErrorResponse	Risposta di errore
FeatureCollectionEnum	Il tipo di un oggetto FeatureCollection deve essere FeatureCollection.
FeaturesItem
FeatureTypeEnum	Il tipo di una funzionalità deve essere Feature.
GeocodePoints	Raccolta di punti di codice geografico che differiscono dal modo in cui sono stati calcolati e dal loro uso suggerito.
GeocodingResponse	Questo oggetto viene restituito da una chiamata geocodifica riuscita
GeoJsonPoint	Tipo geometry valido `GeoJSON Point` . Per informazioni dettagliate, vedere RFC 7946 .
Intersection	Indirizzo del risultato.
MatchCodesEnum	Uno o più valori di codice corrispondenti che rappresentano il livello di geocodatura per ogni posizione nella risposta. Ad esempio, una posizione geocodificata con codici di corrispondenza di `Good` e `Ambiguous` significa che è stata trovata più di una posizione geografica per le informazioni sulla posizione e che il servizio geocode non disponeva di una gerarchia di ricerca per trovare una corrispondenza. Analogamente, una posizione geocoded con codici di corrispondenza e `AmbiguousUpHierarchy` implica che non è stato possibile trovare una posizione geografica corrispondente a tutte le informazioni sulla posizione fornite, quindi il servizio geocode deve cercare la gerarchia e trovare più corrispondenze a tale livello. Un esempio di up an `Ambiguous` and `UpHierarchy` result è quando si forniscono informazioni complete sull'indirizzo, ma il servizio geocode non riesce a individuare una corrispondenza per l'indirizzo di strada e restituisce invece informazioni per più di un valore RoadBlock. I valori possibili sono: `Good`: la posizione ha una sola corrispondenza o tutte le corrispondenze restituite sono considerate corrispondenze complesse. Ad esempio, una query per New York restituisce diverse corrispondenze buone. `Ambiguous`: la posizione è una delle corrispondenze possibili. Ad esempio, quando si esegue una query per l'indirizzo di strada 128 Main St., la risposta può restituire due posizioni per 128 North Main St. e 128 South Main St. perché non sono disponibili informazioni sufficienti per determinare quale opzione scegliere. `UpHierarchy`: la posizione rappresenta uno spostamento verso l'alto della gerarchia geografica. Ciò si verifica quando non è stata trovata una corrispondenza per la richiesta di posizione, quindi viene restituito un risultato meno preciso. Ad esempio, se non è possibile trovare una corrispondenza per l'indirizzo richiesto, potrebbe essere restituito un codice di corrispondenza di con un tipo di `UpHierarchy` entità RoadBlock.
Properties
ReverseGeocodingResultTypeEnum	Specificare i tipi di entità desiderati nella risposta. Verranno restituiti solo i tipi specificati. Se il punto non può essere mappato ai tipi di entità specificati, non vengono restituite informazioni sulla posizione nella risposta. Il valore predefinito è tutte le entità possibili. Elenco delimitato da virgole di tipi di entità selezionati dalle opzioni seguenti. Indirizzo Quartiere PopolamentoPlace Codice postale1 AdminDivision1 AdminDivision2 CountryRegion Questi tipi di entità vengono ordinati dall'entità più specifica all'entità meno specifica. Quando vengono trovate entità di più di un tipo di entità, viene restituita solo l'entità più specifica. Ad esempio, se si specifica Indirizzo e AdminDistrict1 come tipi di entità e entità sono stati trovati per entrambi i tipi, vengono restituite solo le informazioni sull'entità Address nella risposta.
UsageTypeEnum	Uso ottimale per il punto di codice geografico. Ogni punto di codice geografico è definito come `Route` punto, un `Display` punto o entrambi. Usare `Route` i punti se si sta creando una route alla posizione. Usare `Display` i punti se si mostra la posizione in una mappa. Ad esempio, se la posizione è un parco, un `Route` punto può specificare un ingresso al parco in cui è possibile entrare con un'auto e un punto può essere un `Display` punto che specifica il centro del parco.

Address

Indirizzo del risultato

Nome	Tipo	Descrizione
addressLine	string	AddressLine che include nome e numero di strada
adminDistricts	AdminDistricts[]	Nome di suddivisione nel paese o nell'area geografica per un indirizzo. Questo elemento viene in genere considerato come suddivisione amministrativa del primo ordine, ma in alcuni casi contiene anche la seconda, terza o quarta suddivisione dell'ordine in un paese, una dipendenza o un'area geografica.
countryRegion	CountryRegion
formattedAddress	string	Proprietà Address formattata
intersection	Intersection	Indirizzo del risultato.
locality	string	località, proprietà
neighborhood	string	proprietà di quartiere
postalCode	string	Proprietà Postal Code

AdminDistricts

Nome di suddivisione nel paese o nell'area geografica per un indirizzo. Questo elemento viene in genere considerato come suddivisione amministrativa del primo ordine, ma in alcuni casi contiene anche la seconda, terza o quarta suddivisione dell'ordine in un paese, una dipendenza o un'area geografica.

Nome	Tipo	Descrizione
name	string	Il nome del campo adminDistrict corrispondente, Per adminDistrict[0], questo potrebbe essere il nome completo dello stato, ad esempio Washington, For adminDistrict[1], questo potrebbe essere il nome completo della contea
shortName	string	Nome breve per il campo adminDistrict corrispondente, Per adminDistrict[0], questo potrebbe essere un nome breve di stato, ad esempio WA, Per adminDistrict[1], questo potrebbe essere il nome breve della contea

CalculationMethodEnum

Metodo usato per calcolare il punto di codice geografico.

Nome	Tipo	Descrizione
Interpolation	string	Il punto di codice geografico è stato corrispondente a un punto su una strada usando l'interpolazione.
InterpolationOffset	string	Il punto di codice geografico è stato abbinato a un punto su una strada usando l'interpolazione con un offset aggiuntivo per spostare il punto sul lato della strada.
Parcel	string	Il punto di codice geografico corrisponde al centro di un pacco.
Rooftop	string	Il punto di geocodice è stato abbinato al tetto di un edificio.

ConfidenceEnum

Il livello di attendibilità del risultato della posizione geografica è una corrispondenza. Usare questo valore con il codice di corrispondenza per determinare per informazioni più complete sulla corrispondenza.

L'attendibilità di una posizione geocoded si basa su molti fattori, tra cui l'importanza relativa della posizione geografica e la posizione dell'utente, se specificato.

Nome Tipo Descrizione

High

Nome	Tipo	Descrizione
High	string	Se l'attendibilità è impostata su `High`, sono state trovate una o più corrispondenze forti. Se applicabile, le corrispondenze di attendibilità multiple `High` vengono ordinate in ordine classificato in base all'importanza. Ad esempio, i punti di riferimento hanno importanza, ma gli indirizzi non sono. Se una richiesta include una posizione o una visualizzazione, la classificazione può cambiare in modo appropriato. Ad esempio, una query di posizione per "Parigi" restituisce "Parigi, Francia" e "Parigi, TX" con `High` attendibilità. "Parigi, Francia" è sempre classificato in primo luogo a causa dell'importanza, a meno che una posizione utente indica che l'utente è in o molto vicino a Parigi, TX o la visualizzazione mappa indica che l'utente sta cercando in quell'area.
Low	string
Medium	string	In alcune situazioni, la corrispondenza restituita potrebbe non essere allo stesso livello delle informazioni fornite nella richiesta. Ad esempio, una richiesta può specificare informazioni sull'indirizzo e il servizio geocode può essere in grado di corrispondere solo a un codice postale. In questo caso, se il servizio geocode ha un'attendibilità che il codice postale corrisponda ai dati, l'attendibilità è impostata su `Medium` e il codice di corrispondenza è impostato su per specificare che non può corrispondere a `UpHierarchy` tutte le informazioni e deve cercare la gerarchia up-hierarchy. Se le informazioni sulla posizione nella query sono ambigue e non sono presenti informazioni aggiuntive per classificare le posizioni (ad esempio la posizione utente o l'importanza relativa della posizione), l'attendibilità è impostata su `Medium`. Ad esempio, una query di posizione per "148th Ave, Bellevue" può restituire "148th Ave SE" e "148th Ave NE" con `Medium` attendibilità. Se le informazioni sulla posizione nella query non forniscono informazioni sufficienti per decodificare una posizione specifica, un valore di posizione meno preciso può essere restituito e la attendibilità è impostata su `Medium`. Ad esempio, se viene fornito un indirizzo, ma non viene trovata una corrispondenza per il numero di casa, il risultato del codice geografico con un tipo di entità Roadblock può essere restituito.

string

Se l'attendibilità è impostata su High, sono state trovate una o più corrispondenze forti. Se applicabile, le corrispondenze di attendibilità multiple High vengono ordinate in ordine classificato in base all'importanza. Ad esempio, i punti di riferimento hanno importanza, ma gli indirizzi non sono.

Se una richiesta include una posizione o una visualizzazione, la classificazione può cambiare in modo appropriato. Ad esempio, una query di posizione per "Parigi" restituisce "Parigi, Francia" e "Parigi, TX" con High attendibilità. "Parigi, Francia" è sempre classificato in primo luogo a causa dell'importanza, a meno che una posizione utente indica che l'utente è in o molto vicino a Parigi, TX o la visualizzazione mappa indica che l'utente sta cercando in quell'area.

Low

string

Medium

string

In alcune situazioni, la corrispondenza restituita potrebbe non essere allo stesso livello delle informazioni fornite nella richiesta. Ad esempio, una richiesta può specificare informazioni sull'indirizzo e il servizio geocode può essere in grado di corrispondere solo a un codice postale. In questo caso, se il servizio geocode ha un'attendibilità che il codice postale corrisponda ai dati, l'attendibilità è impostata su Medium e il codice di corrispondenza è impostato su per specificare che non può corrispondere a UpHierarchy tutte le informazioni e deve cercare la gerarchia up-hierarchy.

Se le informazioni sulla posizione nella query sono ambigue e non sono presenti informazioni aggiuntive per classificare le posizioni (ad esempio la posizione utente o l'importanza relativa della posizione), l'attendibilità è impostata su Medium. Ad esempio, una query di posizione per "148th Ave, Bellevue" può restituire "148th Ave SE" e "148th Ave NE" con Medium attendibilità.

Se le informazioni sulla posizione nella query non forniscono informazioni sufficienti per decodificare una posizione specifica, un valore di posizione meno preciso può essere restituito e la attendibilità è impostata su Medium. Ad esempio, se viene fornito un indirizzo, ma non viene trovata una corrispondenza per il numero di casa, il risultato del codice geografico con un tipo di entità Roadblock può essere restituito.

CountryRegion

Nome	Tipo	Descrizione
ISO	string	ISO del paese/area geografica
name	string	nome del paese/area geografica

ErrorAdditionalInfo

Informazioni aggiuntive sulla 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.

FeatureCollectionEnum

Il tipo di un oggetto FeatureCollection deve essere FeatureCollection.

Nome	Tipo	Descrizione
FeatureCollection	string

FeaturesItem

Nome	Tipo	Descrizione
bbox	number[]	Riquadro. Proiezione usata : EPSG:3857. Per informazioni dettagliate, vedere RFC 7946 .
geometry	GeoJsonPoint	Tipo geometry valido `GeoJSON Point` . Per informazioni dettagliate, vedere RFC 7946 .
id	string	ID per la funzionalità restituita
properties	Properties
type	FeatureTypeEnum	Il tipo di una funzionalità deve essere Feature.

FeatureTypeEnum

Il tipo di una funzionalità deve essere Feature.

Nome	Tipo	Descrizione
Feature	string

GeocodePoints

Raccolta di punti di codice geografico che differiscono dal modo in cui sono stati calcolati e dal loro uso suggerito.

Nome	Tipo	Descrizione
calculationMethod	CalculationMethodEnum	Metodo usato per calcolare il punto di codice geografico.
geometry	GeoJsonPoint	Tipo geometry valido `GeoJSON Point` . Per informazioni dettagliate, vedere RFC 7946 .
usageTypes	UsageTypeEnum[]	Uso ottimale per il punto di codice geografico. Ogni punto di codice geografico è definito come `Route` punto, un `Display` punto o entrambi. Usare `Route` i punti se si sta creando una route alla posizione. Usare `Display` i punti se si mostra la posizione in una mappa. Ad esempio, se la posizione è un parco, un `Route` punto può specificare un ingresso al parco in cui è possibile entrare con un'auto e un punto può essere un `Display` punto che specifica il centro del parco.

GeocodingResponse

Questo oggetto viene restituito da una chiamata geocodifica riuscita

Nome	Tipo	Descrizione
features	FeaturesItem[]
nextLink	string	Il collegamento alla pagina successiva delle funzionalità restituite. Se è l'ultima pagina, nessun campo.
type	FeatureCollectionEnum	Il tipo di un oggetto FeatureCollection deve essere FeatureCollection.

GeoJsonPoint

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

Nome	Tipo	Descrizione
bbox	number[]	Riquadro. Proiezione usata : EPSG:3857. Per informazioni dettagliate, vedere RFC 7946 .
coordinates	number[]	Una `Position` è una matrice di numeri con due o più elementi. I primi due elementi sono longitudine e latitudine, esattamente in tale 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 oggetti GeoJSON validi: Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature e FeatureCollection.

Intersection

Indirizzo del risultato.

Nome	Tipo	Descrizione
baseStreet	string	Strada primaria per la posizione.
displayName	string	Nome completo dell'intersezione.
intersectionType	string	Tipo di intersezione.
secondaryStreet1	string	La prima strada intersecante.
secondaryStreet2	string	Se presente, la seconda strada intersecante.

MatchCodesEnum

Uno o più valori di codice corrispondenti che rappresentano il livello di geocodatura per ogni posizione nella risposta.

Ad esempio, una posizione geocodificata con codici di corrispondenza di Good e Ambiguous significa che è stata trovata più di una posizione geografica per le informazioni sulla posizione e che il servizio geocode non disponeva di una gerarchia di ricerca per trovare una corrispondenza.

Analogamente, una posizione geocoded con codici di corrispondenza e AmbiguousUpHierarchy implica che non è stato possibile trovare una posizione geografica corrispondente a tutte le informazioni sulla posizione fornite, quindi il servizio geocode deve cercare la gerarchia e trovare più corrispondenze a tale livello. Un esempio di up an Ambiguous and UpHierarchy result è quando si forniscono informazioni complete sull'indirizzo, ma il servizio geocode non riesce a individuare una corrispondenza per l'indirizzo di strada e restituisce invece informazioni per più di un valore RoadBlock.

I valori possibili sono:

Good: la posizione ha una sola corrispondenza o tutte le corrispondenze restituite sono considerate corrispondenze complesse. Ad esempio, una query per New York restituisce diverse corrispondenze buone.

Ambiguous: la posizione è una delle corrispondenze possibili. Ad esempio, quando si esegue una query per l'indirizzo di strada 128 Main St., la risposta può restituire due posizioni per 128 North Main St. e 128 South Main St. perché non sono disponibili informazioni sufficienti per determinare quale opzione scegliere.

UpHierarchy: la posizione rappresenta uno spostamento verso l'alto della gerarchia geografica. Ciò si verifica quando non è stata trovata una corrispondenza per la richiesta di posizione, quindi viene restituito un risultato meno preciso. Ad esempio, se non è possibile trovare una corrispondenza per l'indirizzo richiesto, potrebbe essere restituito un codice di corrispondenza di con un tipo di UpHierarchy entità RoadBlock.

Nome	Tipo	Descrizione
Ambiguous	string
Good	string
UpHierarchy	string

Properties

Nome	Tipo	Descrizione
address	Address	Indirizzo del risultato
confidence	ConfidenceEnum	Il livello di attendibilità del risultato della posizione geografica è una corrispondenza. Usare questo valore con il codice di corrispondenza per determinare per informazioni più complete sulla corrispondenza. L'attendibilità di una posizione geocoded si basa su molti fattori, tra cui l'importanza relativa della posizione geografica e la posizione dell'utente, se specificato.
geocodePoints	GeocodePoints[]	Raccolta di punti di codice geografico che differiscono dal modo in cui sono stati calcolati e dal loro uso suggerito.
matchCodes	MatchCodesEnum[]	Uno o più valori di codice corrispondenti che rappresentano il livello di geocodatura per ogni posizione nella risposta. Ad esempio, una posizione geocodificata con codici di corrispondenza di `Good` e `Ambiguous` significa che è stata trovata più di una posizione geografica per le informazioni sulla posizione e che il servizio geocode non disponeva di una gerarchia di ricerca per trovare una corrispondenza. Analogamente, una posizione geocoded con codici di corrispondenza e `AmbiguousUpHierarchy` implica che non è stato possibile trovare una posizione geografica corrispondente a tutte le informazioni sulla posizione fornite, quindi il servizio geocode deve cercare la gerarchia e trovare più corrispondenze a tale livello. Un esempio di up an `Ambiguous` and `UpHierarchy` result è quando si forniscono informazioni complete sull'indirizzo, ma il servizio geocode non riesce a individuare una corrispondenza per l'indirizzo di strada e restituisce invece informazioni per più di un valore RoadBlock. I valori possibili sono: `Good`: la posizione ha una sola corrispondenza o tutte le corrispondenze restituite sono considerate corrispondenze complesse. Ad esempio, una query per New York restituisce diverse corrispondenze buone. `Ambiguous`: la posizione è una delle corrispondenze possibili. Ad esempio, quando si esegue una query per l'indirizzo di strada 128 Main St., la risposta può restituire due posizioni per 128 North Main St. e 128 South Main St. perché non sono disponibili informazioni sufficienti per determinare quale opzione scegliere. `UpHierarchy`: la posizione rappresenta uno spostamento verso l'alto della gerarchia geografica. Ciò si verifica quando non è stata trovata una corrispondenza per la richiesta di posizione, quindi viene restituito un risultato meno preciso. Ad esempio, se non è possibile trovare una corrispondenza per l'indirizzo richiesto, potrebbe essere restituito un codice di corrispondenza di con un tipo di `UpHierarchy` entità RoadBlock.
type	string	Uno dei valori possibili: Indirizzo Blocco stradale RoadIntersection Quartiere PopolamentoPlace Codice postale1 AdminDivision1 AdminDivision2 CountryRegion

ReverseGeocodingResultTypeEnum

Specificare i tipi di entità desiderati nella risposta. Verranno restituiti solo i tipi specificati. Se il punto non può essere mappato ai tipi di entità specificati, non vengono restituite informazioni sulla posizione nella risposta. Il valore predefinito è tutte le entità possibili. Elenco delimitato da virgole di tipi di entità selezionati dalle opzioni seguenti.

Indirizzo
Quartiere
PopolamentoPlace
Codice postale1
AdminDivision1
AdminDivision2
CountryRegion

Questi tipi di entità vengono ordinati dall'entità più specifica all'entità meno specifica. Quando vengono trovate entità di più di un tipo di entità, viene restituita solo l'entità più specifica. Ad esempio, se si specifica Indirizzo e AdminDistrict1 come tipi di entità e entità sono stati trovati per entrambi i tipi, vengono restituite solo le informazioni sull'entità Address nella risposta.

Nome	Tipo	Descrizione
Address	string
AdminDivision1	string
AdminDivision2	string
CountryRegion	string
Neighborhood	string
PopulatedPlace	string
Postcode1	string

UsageTypeEnum

Uso ottimale per il punto di codice geografico. Ogni punto di codice geografico è definito come Route punto, un Display punto o entrambi. Usare Route i punti se si sta creando una route alla posizione. Usare Display i punti se si mostra la posizione in una mappa. Ad esempio, se la posizione è un parco, un Route punto può specificare un ingresso al parco in cui è possibile entrare con un'auto e un punto può essere un Display punto che specifica il centro del parco.

Nome	Tipo	Descrizione
Display	string
Route	string

Share via

Search - Get Reverse Geocoding

Parametri dell'URI

Intestazione della richiesta

Risposte

Sicurezza

AADToken

Scopes

subscription-key

SAS Token

Esempio

Search point -122.138681, 47.630358

Sample Request

Sample Response

Definizioni

Address

AdminDistricts

CalculationMethodEnum

ConfidenceEnum

CountryRegion

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

FeatureCollectionEnum

FeaturesItem

FeatureTypeEnum

GeocodePoints

GeocodingResponse

GeoJsonPoint

Intersection

MatchCodesEnum

Properties

ReverseGeocodingResultTypeEnum

UsageTypeEnum

Risorse aggiuntive