Search - Get Search Address Reverse Cross Street
Usare per ottenere informazioni sulla posizione incrociata dalle coordinate di latitudine e longitudine.
L'API Get Search Address Reverse Cross Street
è una richiesta HTTP GET
che restituisce la strada incrociata più vicina quando si specificano coordinate di latitudine e longitudine. Potrebbero esserci momenti in cui è necessario tradurre una coordinata (esempio: 37.786505, -122.3862) in una strada incrociata umana comprensibile. Spesso questo è necessario nelle applicazioni di rilevamento in cui si riceve un feed GPS dal dispositivo o dall'asset e si desidera conoscere l'indirizzo in cui si trova la coordinata.
Questo endpoint restituirà informazioni incrociate per una determinata coordinata.
GET https://atlas.microsoft.com/search/address/reverse/crossStreet/{format}?api-version=1.0&query={query}
GET https://atlas.microsoft.com/search/address/reverse/crossStreet/{format}?api-version=1.0&query={query}&limit={limit}&heading={heading}&radius={radius}&language={language}&view={view}
Parametri dell'URI
Nome | In | Necessario | Tipo | Descrizione |
---|---|---|---|---|
format
|
path | True |
Formato desiderato della risposta. Il valore può essere json o xml. |
|
api-version
|
query | True |
string |
Numero di versione dell'API Mappe di Azure. |
query
|
query | True |
number[] |
La query applicabile specificata come stringa delimitata da virgole composta da latitudine seguita da longitudine, ad esempio "47.641268,-122.125679". |
heading
|
query |
integer |
Titolo direzionale del veicolo in gradi, per viaggiare lungo un segmento di strada. 0 è Nord, 90 è Est e così via, i valori vanno da -360 a 360. La precisione può includere fino a una posizione decimale |
|
language
|
query |
string |
Lingua in cui devono essere restituiti i risultati della ricerca. Deve essere uno dei tag del linguaggio IETF supportati, senza distinzione tra maiuscole e minuscole. Quando i dati nella lingua specificata non sono disponibili per un campo specifico, viene usata la lingua predefinita. Per informazioni dettagliate, vedere Lingue supportate . |
|
limit
|
query |
integer |
Numero massimo di risposte restituite. Impostazione predefinita: 10, minimo: 1 e massimo: 100 |
|
radius
|
query |
integer |
Raggio in metri per consentire ai risultati di essere vincolati all'area definita |
|
view
|
query |
Il parametro View (chiamato anche parametro "area utente") consente di visualizzare le mappe corrette per un determinato paese/area geografica per le aree geopoliticamente contestate. Diversi paesi/aree geografiche hanno visualizzazioni diverse di tali aree e il parametro View consente all'applicazione di rispettare la visualizzazione richiesta dal paese o dall'area geografica in cui verrà eseguita l'applicazione. Per impostazione predefinita, il parametro View è impostato su "Unified" anche se non è stato definito nella richiesta. È responsabilità dell'utente determinare la posizione degli utenti e quindi impostare correttamente il parametro View per tale posizione. In alternativa, è possibile impostare 'View=Auto', che restituirà i dati della mappa in base all'indirizzo IP della richiesta. Il parametro View in Mappe di Azure deve essere usato in conformità alle leggi applicabili, incluse quelle relative al mapping, del paese/area geografica in cui mappe, immagini e altri dati e contenuto di terze parti autorizzati ad accedere tramite Mappe di Azure è reso disponibile. Esempio: view=IN. 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 Microsoft Entra ID. 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 Microsoft Entra ID sicurezza in Mappe di Azure vedere gli articoli seguenti per indicazioni. |
Risposte
Nome | Tipo | Descrizione |
---|---|---|
200 OK |
OK |
|
Other Status Codes |
Si è verificato un errore imprevisto. |
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.
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
Search address of the nearest intersection/crossroad
Esempio di richiesta
GET https://atlas.microsoft.com/search/address/reverse/crossStreet/json?api-version=1.0&query=37.337,-121.89
Risposta di esempio
{
"summary": {
"numResults": 1,
"queryTime": 41
},
"addresses": [
{
"address": {
"streetName": "East Santa Clara Street & North 2nd Street",
"crossStreet": "East Santa Clara Street",
"municipalitySubdivision": "San Jose, Downtown San Jose",
"municipality": "San Jose",
"countrySecondarySubdivision": "Santa Clara",
"countryTertiarySubdivision": "San Jose",
"countrySubdivisionCode": "CA",
"postalCode": "95113",
"countryCode": "US",
"country": "United States",
"countryCodeISO3": "USA",
"freeformAddress": "East Santa Clara Street & North 2nd Street, San Jose, CA 95113",
"countrySubdivisionName": "California"
},
"position": "37.33666,-121.88951"
}
]
}
Definizioni
Nome | Descrizione |
---|---|
Address |
Indirizzo del risultato |
Bounding |
Casella di selezione della posizione. |
Entity |
Origine del tipo di entità del rettangolo di selezione. Per la geocodatura inversa, questa operazione è sempre uguale alla posizione. |
Error |
Informazioni aggiuntive sulla gestione delle risorse. |
Error |
Dettagli dell'errore. |
Error |
Risposta di errore |
Lat |
Una posizione rappresentata come latitudine e longitudine usando nomi brevi 'lat' & 'lon'. |
Localized |
Il parametro View (chiamato anche parametro "area utente") consente di visualizzare le mappe corrette per un determinato paese/area geografica per le aree geopoliticamente contestate. Diversi paesi/aree geografiche hanno visualizzazioni diverse di tali aree e il parametro View consente all'applicazione di rispettare la visualizzazione richiesta dal paese o dall'area geografica in cui verrà eseguita l'applicazione. Per impostazione predefinita, il parametro View è impostato su "Unified" anche se non è stato definito nella richiesta. È responsabilità dell'utente determinare la posizione degli utenti e quindi impostare correttamente il parametro View per tale posizione. In alternativa, è possibile impostare 'View=Auto', che restituirà i dati della mappa in base all'indirizzo IP della richiesta. Il parametro View in Mappe di Azure deve essere usato in conformità alle leggi applicabili, incluse quelle relative al mapping, del paese/area geografica in cui mappe, immagini e altri dati e contenuto di terze parti autorizzati ad accedere tramite Mappe di Azure è reso disponibile. Esempio: view=IN. Per informazioni dettagliate, vedere Visualizzazioni supportate e visualizzare le visualizzazioni disponibili. |
Query |
Tipo di query restituito: NEARBY o NON_NEAR. |
Response |
Formato desiderato della risposta. Il valore può essere json o xml. |
Reverse |
Questo oggetto viene restituito da una chiamata CrossStreet Search con esito positivo |
Reverse |
Oggetto Result per una risposta Search Address Cross Street |
Search |
Oggetto Riepilogo per una risposta API Search. |
Address
Indirizzo del risultato
Nome | Tipo | Descrizione |
---|---|---|
boundingBox |
Casella di selezione della posizione. |
|
buildingNumber |
string |
Numero di edificio sulla strada. DEPRECATO, usare invece streetNumber. |
country |
string |
nome paese/area geografica |
countryCode |
string |
Paese (Nota: si tratta di un codice a due lettere, non di un nome paese/area geografica). |
countryCodeISO3 |
string |
Codice paese ISO alfa-3 |
countrySecondarySubdivision |
string |
Contea |
countrySubdivision |
string |
State or Province |
countrySubdivisionCode |
string |
|
countrySubdivisionName |
string |
Nome completo di un primo livello di gerarchia amministrativa paese/area geografica. Questo campo viene visualizzato solo nel caso in cui countrySubdivision venga presentato in un formato abbreviato. Supportato solo per Stati Uniti, Canada e Regno Unito. |
countryTertiarySubdivision |
string |
Area denominata |
crossStreet |
string |
Nome della strada incrociata. |
extendedPostalCode |
string |
Codice postale esteso (la disponibilità dipende dall'area). |
freeformAddress |
string |
Una riga di indirizzo formattata in base alle regole di formattazione del paese/area geografica di un risultato o nel caso di un paese/area geografica, il nome completo del paese o dell'area geografica. |
localName |
string |
Componente di indirizzo che rappresenta il nome di un'area geografica o di una località che raggruppa più oggetti indirizzabili a scopo di indirizzamento, senza essere un'unità amministrativa. Questo campo viene usato per compilare la |
municipality |
string |
Città/Città |
municipalitySubdivision |
string |
Sub/Super City |
neighbourhood |
string |
Un quartiere è un'area geograficamente localizzata all'interno di una città o città con caratteristiche distintive e interazioni sociali tra gli abitanti. |
postalCode |
string |
Codice postale/codice postale |
routeNumbers |
string[] |
Codici usati per identificare in modo non ambiguo la strada |
street |
string |
Nome della strada. DEPRECATO, usare invece streetName. |
streetName |
string |
Nome della strada. |
streetNameAndNumber |
string |
Nome della strada e numero. |
streetNumber |
string |
Numero di edificio sulla strada. |
BoundingBoxCompassNotation
Casella di selezione della posizione.
Nome | Tipo | Descrizione |
---|---|---|
entity |
Origine del tipo di entità del rettangolo di selezione. Per la geocodatura inversa, questa operazione è sempre uguale alla posizione. |
|
northEast |
string |
Latitudine nord-est, coordinata longitudine del rettangolo di selezione come float delimitati da virgole |
southWest |
string |
Latitudine sud-ovest, coordinata longitudine del rettangolo di selezione come float delimitati da virgole |
Entity
Origine del tipo di entità del rettangolo di selezione. Per la geocodatura inversa, questa operazione è sempre uguale alla posizione.
Nome | Tipo | Descrizione |
---|---|---|
position |
string |
Entità position |
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 |
Informazioni aggiuntive sull'errore. |
|
code |
string |
Codice di errore. |
details |
Dettagli dell'errore. |
|
message |
string |
Messaggio di errore. |
target |
string |
Destinazione dell'errore. |
ErrorResponse
Risposta di errore
Nome | Tipo | Descrizione |
---|---|---|
error |
Oggetto error. |
LatLongPairAbbreviated
Una posizione rappresentata come latitudine e longitudine usando nomi brevi 'lat' & 'lon'.
Nome | Tipo | Descrizione |
---|---|---|
lat |
number |
Latitudine, proprietà |
lon |
number |
Proprietà Longitudine |
LocalizedMapView
Il parametro View (chiamato anche parametro "area utente") consente di visualizzare le mappe corrette per un determinato paese/area geografica per le aree geopoliticamente contestate. Diversi paesi/aree geografiche hanno visualizzazioni diverse di tali aree e il parametro View consente all'applicazione di rispettare la visualizzazione richiesta dal paese o dall'area geografica in cui verrà eseguita l'applicazione. Per impostazione predefinita, il parametro View è impostato su "Unified" anche se non è stato definito nella richiesta. È responsabilità dell'utente determinare la posizione degli utenti e quindi impostare correttamente il parametro View per tale posizione. In alternativa, è possibile impostare 'View=Auto', che restituirà i dati della mappa in base all'indirizzo IP della richiesta. Il parametro View in Mappe di Azure deve essere usato in conformità alle leggi applicabili, incluse quelle relative al mapping, del paese/area geografica in cui mappe, immagini e altri dati e contenuto di terze parti autorizzati ad accedere tramite Mappe di Azure è reso disponibile. Esempio: view=IN.
Per informazioni dettagliate, vedere Visualizzazioni supportate e visualizzare le visualizzazioni disponibili.
Nome | Tipo | Descrizione |
---|---|---|
AE |
string |
Emirati Arabi Uniti (visualizzazione araba) |
AR |
string |
Argentina (visualizzazione argentina) |
Auto |
string |
Restituisce i dati della mappa in base all'indirizzo IP della richiesta. |
BH |
string |
Bahrain (visualizzazione araba) |
IN |
string |
India (visualizzazione indiana) |
IQ |
string |
Iraq (visualizzazione araba) |
JO |
string |
Giordania (visualizzazione araba) |
KW |
string |
Kuwait (visualizzazione araba) |
LB |
string |
Libano (visualizzazione araba) |
MA |
string |
Marocco (visualizzazione marocchina) |
OM |
string |
Oman (visualizzazione araba) |
PK |
string |
Pakistan (visualizzazione pakistana) |
PS |
string |
Autorità Palestinese (visualizzazione araba) |
QA |
string |
Qatar (visualizzazione araba) |
SA |
string |
Arabia Saudita (visualizzazione araba) |
SY |
string |
Siria (visualizzazione araba) |
Unified |
string |
Visualizzazione unificata (altri) |
YE |
string |
Yemen (visualizzazione araba) |
QueryType
Tipo di query restituito: NEARBY o NON_NEAR.
Nome | Tipo | Descrizione |
---|---|---|
NEARBY |
string |
Search è stato eseguito intorno a una determinata latitudine e longitudine con un raggio definito |
NON_NEAR |
string |
Search è stata eseguita a livello globale, senza pregiudizi a una determinata latitudine e longitudine, e nessun raggio definito |
ResponseFormat
Formato desiderato della risposta. Il valore può essere json o xml.
Nome | Tipo | Descrizione |
---|---|---|
json |
string |
|
xml |
string |
ReverseSearchCrossStreetAddressResult
Questo oggetto viene restituito da una chiamata CrossStreet Search con esito positivo
Nome | Tipo | Descrizione |
---|---|---|
addresses |
Matrice di indirizzi |
|
summary |
Oggetto Riepilogo per una risposta di Search Address Cross Street |
ReverseSearchCrossStreetAddressResultItem
Oggetto Result per una risposta Search Address Cross Street
Nome | Tipo | Descrizione |
---|---|---|
address |
Indirizzo del risultato |
|
position |
string |
Proprietà Position sotto forma di "{latitudine},{longitudine}" |
SearchSummary
Oggetto Riepilogo per una risposta API Search.
Nome | Tipo | Descrizione |
---|---|---|
fuzzyLevel |
integer |
Il livello massimo di fuzzy richiesto per fornire risultati. |
geoBias |
Indicazione quando il motore di ricerca interno ha applicato un pregiudizio geospaziale per migliorare la classificazione dei risultati. In alcuni metodi questo può essere interessato impostando i parametri lat e lon in cui sono disponibili. In altri casi è puramente interna. |
|
limit |
integer |
Numero massimo di risposte che verranno restituite |
numResults |
integer |
Numero di risultati nella risposta. |
offset |
integer |
Offset iniziale dei risultati restituiti all'interno del set di risultati completo. |
query |
string |
Parametro di query usato per produrre questi risultati della ricerca. |
queryTime |
integer |
Tempo trascorso per la risoluzione della query, in millisecondi. |
queryType |
Tipo di query restituito: NEARBY o NON_NEAR. |
|
totalResults |
integer |
Numero totale di risultati trovati. |