Search - Get Search Address Reverse Cross Street

Riferimento

Service:: Maps

API Version:: 1.0

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}

With optional parameters:

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	ResponseFormat	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		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.

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	ReverseSearchCrossStreetAddressResult	OK
Other Status Codes	ErrorResponse	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.

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 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.

Type: 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.

Type: apiKey
In: header

Esempio

Search address of the nearest intersection/crossroad

Sample Request

HTTP

GET https://atlas.microsoft.com/search/address/reverse/crossStreet/json?api-version=1.0&query=37.337,-121.89

Sample Response

Status code:: 200

{
  "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
BoundingBoxCompassNotation	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.
ErrorAdditionalInfo	Informazioni aggiuntive sulla gestione delle risorse.
ErrorDetail	Dettagli dell'errore.
ErrorResponse	Risposta di errore
LatLongPairAbbreviated	Una posizione rappresentata come latitudine e longitudine usando nomi brevi 'lat' & 'lon'.
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.
QueryType	Tipo di query restituito: NEARBY o NON_NEAR.
ResponseFormat	Formato desiderato della risposta. Il valore può essere json o xml.
ReverseSearchCrossStreetAddressResult	Questo oggetto viene restituito da una chiamata CrossStreet Search con esito positivo
ReverseSearchCrossStreetAddressResultItem	Oggetto Result per una risposta Search Address Cross Street
SearchSummary	Oggetto Riepilogo per una risposta API Search.

Address

Indirizzo del risultato

Nome	Tipo	Descrizione
boundingBox	BoundingBoxCompassNotation	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	`countrySubdivisionCode` prefisso da `countryCode` ( countryCode-countrySubdivisionCode ) e il trattino forma il codice ISO 3166-2. Esempi: TX per Texas, SCT per Scozia e ON per Ontario.
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 `freeformAddress` proprietà. `localName` rappresenta il comune postale. A seconda della posizione, `localName` è il nome comunemente noto di una città o di una città. Per il nome comunemente noto di una città o di una città, usare `localName` invece di `municipality`.
municipality	string	Città/Città Nota: `municipality` rappresenta il comune residenziale. A seconda della posizione, il `municipality` valore può essere diverso dal nome comunemente noto di una città o di una città. Per il nome comunemente noto della città o della città, è consigliabile usare il `localName` valore anziché il `municipality` valore.
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	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	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.

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	Formato di interscambio dati dell'oggetto JavaScript
xml	string	Linguaggio di markup estendibile

ReverseSearchCrossStreetAddressResult

Questo oggetto viene restituito da una chiamata CrossStreet Search con esito positivo

Nome	Tipo	Descrizione
addresses	ReverseSearchCrossStreetAddressResultItem[]	Matrice di indirizzi
summary	SearchSummary	Oggetto Riepilogo per una risposta di Search Address Cross Street

ReverseSearchCrossStreetAddressResultItem

Oggetto Result per una risposta Search Address Cross Street

Nome	Tipo	Descrizione
address	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	LatLongPairAbbreviated	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	QueryType	Tipo di query restituito: NEARBY o NON_NEAR.
totalResults	integer	Numero totale di risultati trovati.

Condividi tramite