Render - Get Map Static Image

Servizio:

Maps

Versione API:

2024-04-01

Questa API di rendering produce viste mappa statiche e rasterizzate di un'area definita dall'utente. È adatto per applicazioni Web leggere, quando l'esperienza utente desiderata non richiede controlli mappa interattivi o quando la larghezza di banda è limitata. Questa API è utile anche per incorporare mappe all'esterno del browser, nei servizi back-end, nella generazione di report o nelle applicazioni desktop.

Questa API include parametri per la visualizzazione dei dati di base:

• Pinne etichettate in più stili.
• Eseguire il rendering dei tipi di geometria cerchio, percorso e poligono.

Per altre informazioni ed esempi dettagliati, vedere Eseguire il rendering di dati personalizzati in una mappa raster.

Le dimensioni del parametro bbox sono vincolate, a seconda del livello di zoom. Ciò garantisce che l'immagine risultante abbia un livello appropriato di dettaglio.

Livello di zoom	Intervallo Min Lon	Max Lon Range	Intervallo min lat	Max Lat Range
0	56,25	360.0	30.1105585173	180.0
1	28.125	360.0	14.87468995	180.0
2	14.063	351.5625	7.4130741851	137.9576312246
3	7.03125	175.78125	3.7034501005	73.6354071932
4	3.515625	87.890625	1.8513375155	35.4776115315
5	1.7578125	43.9453125	0.925620264	17.4589959239
6	0.87890625	21.97265625	0.4628040687	8.6907788223
7	0.439453125	10.986328125	0.2314012764	4.3404320789
8	0.2197265625	5.4931640625	0.1157005434	2.1695927024
9	0.1098632812	2.7465820312	0.0578502599	1.0847183194
10	0.0549316406	1.3732910156	0.0289251285	0.5423494021
11	0.0274658203	0.6866455078	0.014462564	0.2711734813
12	0.0137329102	0.3433227539	0.007231282	0.1355865882
13	0.0068664551	0.171661377	0.003615641	0.067793275
14	0.0034332275	0.0858306885	0.0018078205	0.0338966351
15	0.0017166138	0.0429153442	0.0009039102	0.0169483173
16	0.0008583069	0.0214576721	0.0004519551	0.0084741586
17	0.0004291534	0.0107288361	0.0002259776	0.0042370793
18	0.0002145767	0.005364418	0.0001129888	0.0021185396
19	0.0001072884	0.002682209	5.64944E-05	0.0010592698
20	5.36442E-05	0.0013411045	2.82472E-05	0.0005296349

Nota : il parametro center o bbox deve essere fornito all'API.

GET https://atlas.microsoft.com/map/static?api-version=2024-04-01

Con parametri facoltativi:

GET https://atlas.microsoft.com/map/static?api-version=2024-04-01&tilesetId={tilesetId}&trafficLayer={trafficLayer}&zoom={zoom}&center={center}&bbox={bbox}&height={height}&width={width}&language={language}&view={view}&pins={pins}&path={path}

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
api-version	query	True	string	Numero di versione dell'API Mappe di Azure. La versione corrente è 2024-04-01.
bbox	query		number[]	Un rettangolo di selezione è definito da due latitudine e due longitudini che rappresentano i quattro lati di un'area rettangolare sulla Terra. Formato : 'minLon, minLat, maxLon, maxLat' (in doppio). Nota: sono necessari parametri bbox o center. Essi si escludono a vicenda. bbox non deve essere usato con altezza o larghezza. Gli intervalli massimi e minimi consentiti per Lat e Lon sono definiti per ogni livello di zoom nella tabella nella parte superiore di questa pagina.
center	query		number[]	Coordinate del punto centrale in doppio. Formato: 'lon,lat'. Intervallo di longitudine: -180 a 180. Intervallo di latitudine: -90-90. Nota: sono necessari parametri centro o bbox. Essi si escludono a vicenda.
height	query		integer int32	Altezza dell'immagine risultante in pixel. Intervallo compreso tra 80 e 1500. Il valore predefinito è 512. Non deve essere usato con bbox.
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 .
path	query		string[]	Stile e posizioni del percorso (in double). Usare questo parametro per aggiungere facoltativamente linee, poligoni o cerchi all'immagine. Lo stile del percorso descrive l'aspetto della linea e del riempimento. Assicurarsi di codificare correttamente i valori con codifica URL di questo parametro perché conterrà caratteri riservati, ad esempio pipe e punteggiatura. Il parametro Path è supportato nello SKU dell'account mappe di Azure a partire da S1. Più istanze del parametro path consentono di specificare più geometrie con i relativi stili. Il numero di parametri per richiesta è limitato a 10 e il numero di posizioni è limitato a 100 per percorso. Per eseguire il rendering di un cerchio con raggio 100 metri e punto centrale alla latitudine 45°N e longitudine 122°W usando lo stile predefinito, aggiungere il parametro querystring path=ra100||-122 45 Si noti che la longitudine precede la latitudine. Dopo la codifica dell'URL, l'aspetto sarà simile al seguente path=ra100%7C%7C-122+45 Tutti gli esempi qui mostrano il parametro path senza codifica URL, per maggiore chiarezza. Per eseguire il rendering di una riga, separare ogni posizione con un carattere pipe. Ad esempio, usare path=||-122 45|-119.5 43.2|-121.67 47.12 Un poligono viene specificato con un percorso chiuso, in cui il primo e l'ultimo punto sono uguali. Ad esempio, usare path=||-122 45|-119.5 43.2|-121.67 47.12|-122 45 Il valore di longitudine per le posizioni di linee e poligoni può essere compreso nell'intervallo compreso tra -360 e 360 per consentire il rendering delle geometrie che attraversano il meridiano anti-meridiano. Modificatori di stile È possibile modificare l'aspetto del percorso aggiungendo modificatori di stile. Questi vengono aggiunti prima delle posizioni. I modificatori di stile hanno ognuno un nome di due lettere. Questi nomi abbreviati vengono usati per ridurre la lunghezza dell'URL. Per modificare il colore della struttura, usare il modificatore di stile "lc" e specificare il colore usando il formato di colore RGB HTML/CSS, che è un numero esadecimale a sei cifre (il formato a tre cifre non è supportato). Ad esempio, per usare un colore rosa profondo che si specifica come #FF1493 in CSS, usare path=lcFF1493||-122 45|-119.5 43.2 È possibile combinare più modificatori di stile per creare uno stile di visualizzazione più complesso. lc0000FF|lw3|la0.60|fa0.50||-122.2 47.6|-122.2 47.7|-122.3 47.7|-122.3 47.6|-122.2 47.6 Riepilogo del modificatore di stile Modificatore Descrizione Tipo Intervallo Lc Colore linea string Da 000000 a FFFFFF Fc Fill color string Da 000000 a FFFFFF la Alfa linea (opacità) float da 0 a 1 fa Riempimento alfa (opacità) float da 0 a 1 Lw Spessore linea int32 (0, 50] Ra Raggio cerchio (metri) float Maggiore di 0
pins	query		string[]	Stile e istanze pushpin. Usare questo parametro per aggiungere le pinne facoltativamente all'immagine. Lo stile della pinna descrive l'aspetto delle pinne e le istanze specificano le coordinate delle pinne (in doppio) e le etichette facoltative per ogni pin. Assicurarsi di codificare correttamente i valori URL di questo parametro perché conterrà caratteri riservati, ad esempio pipe e punteggiatura. Lo SKU S0 dell'account Mappe di Azure supporta solo una singola istanza del parametro pin. Altri SKU consentono a più istanze del parametro pin di specificare più stili di pin. Per eseguire il rendering di un pushpin a latitudine 45°N e longitudine 122°W usando lo stile predefinito di pushpin, aggiungere il parametro querystring pins=default||-122 45 Si noti che la longitudine viene prima della latitudine. Dopo aver eseguito la codifica dell'URL, questo aspetto sarà simile al seguente pins=default%7C%7C-122+45 Tutti gli esempi qui mostrano il parametro pin senza codifica URL, per maggiore chiarezza. Per eseguire il rendering di un pin in più posizioni, separare ogni posizione con un carattere di pipe. Ad esempio, usare pins=default||-122 45|-119.5 43.2|-121.67 47.12 Lo SKU dell'account Mappe di Azure S0 consente solo cinque puntini di push. Altri SKU dell'account non hanno questa limitazione. Modificatori di stile È possibile modificare l'aspetto dei pin aggiungendo modificatori di stile. Vengono aggiunti dopo lo stile, ma prima delle posizioni e delle etichette. I modificatori di stile hanno un nome a due lettere. Questi nomi abbreviati vengono usati per ridurre la lunghezza dell'URL. Per modificare il colore della pinna, usare il modificatore di stile "co" e specificare il colore usando il formato di colore RGB HTML/CSS, ovvero un numero esadecimale a sei cifre (la forma a tre cifre non è supportata). Ad esempio, per usare un colore rosa profondo che si specifica come #FF1493 in CSS, usare pins=default|coFF1493||-122 45 Etichette push Per aggiungere un'etichetta ai pin, inserire l'etichetta in virgolette singole appena prima delle coordinate. Evitare di usare caratteri speciali come | o || nell'etichetta. Ad esempio, per etichettare tre pin con i valori '1', '2' e '3', usare pins=default||'1'-122 45|'2'-119.5 43.2|'3'-121.67 47.12 Esiste uno stile di pushpin predefinito denominato 'none' che non visualizza un'immagine di pinna. È possibile usare questa opzione se si desidera visualizzare le etichette senza alcuna immagine di pin. Ad esempio, pins=none||'A'-122 45|'B'-119.5 43.2 Per modificare il colore delle etichette pushpin, usare il modificatore dello stile del colore dell'etichetta 'lc'. Ad esempio, per usare le pinne rosa con etichette nere, usare pins=default|coFF1493|lc000000||-122 45 Per modificare le dimensioni delle etichette, usare il modificatore di stile delle dimensioni dell'etichetta 'ls'. Le dimensioni dell'etichetta rappresentano l'altezza approssimativa del testo dell'etichetta in pixel. Ad esempio, per aumentare le dimensioni dell'etichetta a 12, usare pins=default|ls12||'A'-122 45|'B'-119 43 Le etichette vengono centrate sul punto di ancoraggio 'etichetta'. La posizione di ancoraggio è predefinita per le pinne predefinite e si trova al centro superiore delle pinne personalizzate (vedere di seguito). Per eseguire l'override dell'ancoraggio dell'etichetta, usando il modificatore di stile "la" e specificare le coordinate pixel X e Y per l'ancoraggio. Queste coordinate sono relative all'angolo superiore sinistro dell'immagine della pinna. I valori X positivi spostano l'ancoraggio a destra e i valori Y positivi spostano l'ancoraggio verso il basso. Ad esempio, per posizionare l'ancoraggio dell'etichetta a destra 10 pixel e 4 pixel sopra l'angolo superiore sinistro dell'immagine di pinna, usare pins=default|la10 -4||'A'-122 45|'B'-119 43 Pinne personalizzate Per usare un'immagine pushpin personalizzata, usare la parola 'custom' come nome dello stile del pin e quindi specificare un URL dopo la posizione e le informazioni sull'etichetta. La dimensione massima consentita per un'immagine etichetta personalizzata è di 65.536 pixel. Usare due caratteri della pipe per indicare che si specificano percorsi e si avvia l'URL. Ad esempio, pins=custom||-122 45||http://contoso.com/pushpins/red.png Dopo la codifica url, l'aspetto sarà simile al seguente pins=custom%7C%7C-122+45%7C%7Chttp%3A%2F%2Fcontoso.com%2Fpushpins%2Fred.png Per impostazione predefinita, le immagini delle puntine personalizzate vengono disegnate al centro in corrispondenza delle coordinate del segnaposto. Questo di solito non è ideale perché nasconde la posizione che stai cercando di evidenziare. Per eseguire l'override della posizione di ancoraggio dell'immagine del segnaposto, usare il modificatore di stile 'an'. In questo modo viene usato lo stesso formato del modificatore dello stile di ancoraggio delle etichette 'la'. Ad esempio, se l'immagine del segnaposto personalizzata ha la punta del segnaposto nell'angolo superiore sinistro dell'immagine, è possibile impostare l'ancoraggio su tale punto usando pins=custom|an0 0||-122 45||http://contoso.com/pushpins/red.png Nota: se si usa il modificatore di colore "co" con un'immagine di puntina da disegno personalizzata, il colore specificato sostituirà i canali RGB dei pixel nell'immagine, ma lascerà invariato il canale alfa (opacità). Questa operazione in genere viene eseguita solo con un'immagine personalizzata a tinta unita. Ridimensionare, rotazione e opacità È possibile ingrandire o ridurre le dimensioni delle puntine da disegno e delle relative etichette usando il modificatore dello stile di scala 'sc'. Questo è un valore maggiore di zero. Un valore pari a 1 è la scala standard. I valori maggiori di 1 renderanno le puntine da disegno più grandi e i valori inferiori a 1 le renderanno più piccole. Ad esempio, per disegnare le puntine da disegno il 50% più grande del normale, usare pins=default|sc1.5||-122 45 È possibile ruotare le puntine da disegno e le relative etichette usando il modificatore di stile di rotazione 'ro'. Si tratta di un numero di gradi di rotazione in senso orario. Utilizzare un numero negativo per ruotare in senso antiorario. Ad esempio, per ruotare le puntine da disegno a 90 gradi in senso orario e raddoppiarne le dimensioni, usare pins=default|ro90|sc2||-122 45 È possibile rendere le puntine e le relative etichette parzialmente trasparenti specificando il modificatore di stile alfa 'al'. Si tratta di un numero compreso tra 0 e 1 che indica l'opacità delle puntine da disegno. Zero li rende completamente trasparenti (e non visibili) e 1 li rende completamente opachi (che è l'impostazione predefinita). Ad esempio, per rendere le puntine e le relative etichette solo il 67% opaco, usare pins=default|al.67||-122 45 Riepilogo del modificatore di stile Modificatore Descrizione Tipo Intervallo al Alfa (opacità) float da 0 a 1 any Ancoraggio di ancoraggio <int32, int32> * co Colore del segnaposto string Da 000000 a FFFFFF la Ancoraggio etichette <int32, int32> * Lc Colore etichetta string Da 000000 a FFFFFF ls Dimensioni etichetta float Maggiore di 0 ro Rotazione float Da -360 a 360 Sc Scalabilità float Maggiore di 0 Le coordinate X e Y possono trovarsi in qualsiasi punto all'interno dell'immagine del segnaposto o di un margine intorno a esso. La dimensione del margine è il minimo della larghezza e dell'altezza del pin.
tilesetId	query		TilesetId	Stile mappa da restituire. I valori possibili sono microsoft.base.road, microsoft.base.darkgrey e microsoft.imagery. Il valore predefinito è impostato su microsoft.base.road. Per altre informazioni, vedere Rendering TileetId.
trafficLayer	query		TrafficTilesetId	Valore facoltativo, che indica che non viene eseguito alcun flusso di traffico sul risultato dell'immagine. I valori possibili sono microsoft.traffic.relative.main e nessuno. Il valore predefinito non è nessuno, indicando che non viene restituito alcun flusso di traffico. Se viene fornito il tileetId correlato al traffico, restituirà l'immagine della mappa con il livello di traffico corrispondente. Per altre informazioni, vedere Rendering TileetId.
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 sono disponibili mappe, immagini e altri dati e contenuti di terze parti autorizzati ad accedere tramite Mappe di Azure. Esempio: view=IN. Per informazioni dettagliate, vedere Visualizzazioni supportate e visualizzare le visualizzazioni disponibili.
width	query		integer int32	Larghezza dell'immagine risultante in pixel. Intervallo compreso tra 80 e 2000. Il valore predefinito è 512. Non deve essere usato con bbox.
zoom	query		integer int32	Livello di zoom desiderato della mappa. Il valore di zoom del supporto è compreso tra 0 e 20 (inclusivo) per tilesetId che è microsoft.base.road o microsoft.base.darkgrey. Il valore di zoom del supporto è compreso tra 0 e 19 (inclusivo) per tileetId che è microsoft.imagery. Il valore predefinito è 12. Per altre informazioni, vedere Livelli di zoom e Griglia di riquadri.

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 la sicurezza di Microsoft Entra ID in Mappe di Azure, vedere gli articoli seguenti per indicazioni.
Accept		MediaType	Il campo Accetta intestazione può essere usato per specificare le preferenze relative ai tipi di supporti di risposta. I tipi di supporti consentiti includono image/jpeg e image/png. Restituisce l'immagine in image/png se l'intestazione Accept non è specificata.

Risposte

Nome	Tipo	Descrizione
200 OK	object	Questa immagine viene restituita da una chiamata Get Map Static Image (Recupera immagine statica mappa). Media Types: "image/jpeg", "image/png" Intestazioni Content-Type: string
Other Status Codes	ErrorResponse	Si è verificato un errore imprevisto. Media Types: "image/jpeg", "image/png"

Sicurezza

AADToken

Si tratta dei flussi di Microsoft Entra OAuth 2.0 . Quando è associato al controllo degli accessi in base al ruolo di Azure , può essere usato per controllare l'accesso alle API REST di Mappe di Azure. I controlli di accesso basati sul ruolo di Azure vengono usati per designare l'accesso a uno o più account delle risorse delle risorse di Mappe di Azure 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 le API REST di Mappe di Azure.

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.

Note

• Questa definizione di sicurezza richiede l'uso dell'intestazione x-ms-client-id per indicare la risorsa mappe di Azure 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 dispongono di URL di autorizzazione univoci e configurazioni di 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 di Azure Maps Web SDK 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	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 portale di Azure, PowerShell, l'interfaccia della riga di comando, gli SDK di Azure o le 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 di Mappe di Azure in cui questa chiave può 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 nella risorsa mappe 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 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

Successful Static Image Request

Esempio di richiesta

HTTP

GET https://atlas.microsoft.com/map/static?api-version=2024-04-01&tilesetId=microsoft.base.road&zoom=10&center=-122.177621,47.613079

Risposta di esempio

Codice di stato:

200

Content-Type: image/png

"{file}"

Definizioni

Nome	Descrizione
ErrorAdditionalInfo	Informazioni aggiuntive sulla gestione delle risorse.
ErrorDetail	Dettagli dell'errore.
ErrorResponse	Risposta di errore
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 sono disponibili mappe, immagini e altri dati e contenuti di terze parti autorizzati ad accedere tramite Mappe di Azure. Esempio: view=IN. Per informazioni dettagliate, vedere Visualizzazioni supportate e visualizzare le visualizzazioni disponibili.
MediaType	Il campo Accetta intestazione può essere usato per specificare le preferenze relative ai tipi di supporti di risposta. I tipi di supporti consentiti includono image/jpeg e image/png. Restituisce l'immagine in image/png se l'intestazione Accept non è specificata.
TilesetId	Stile mappa da restituire. I valori possibili sono microsoft.base.road, microsoft.base.darkgrey e microsoft.imagery. Il valore predefinito è impostato su microsoft.base.road. Per altre informazioni, vedere Rendering TileetId.
TrafficTilesetId	Valore facoltativo, che indica che non viene eseguito alcun flusso di traffico sul risultato dell'immagine. I valori possibili sono microsoft.traffic.relative.main e nessuno. Il valore predefinito non è nessuno, indicando che non viene restituito alcun flusso di traffico. Se viene fornito il tileetId correlato al traffico, restituirà l'immagine della mappa con il livello di traffico corrispondente. Per altre informazioni, vedere Rendering TileetId.

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.

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 sono disponibili mappe, immagini e altri dati e contenuti di terze parti autorizzati ad accedere tramite Mappe di Azure. 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)

MediaType

Il campo Accetta intestazione può essere usato per specificare le preferenze relative ai tipi di supporti di risposta. I tipi di supporti consentiti includono image/jpeg e image/png. Restituisce l'immagine in image/png se l'intestazione Accept non è specificata.

Nome	Tipo	Descrizione
image/jpeg	string	Restituisce l'immagine in formato jpeg.
image/png	string	Restituire l'immagine in formato png.

TilesetId

Stile mappa da restituire. I valori possibili sono microsoft.base.road, microsoft.base.darkgrey e microsoft.imagery. Il valore predefinito è impostato su microsoft.base.road. Per altre informazioni, vedere Rendering TileetId.

Nome	Tipo	Descrizione
microsoft.base.darkgrey	string	TileetId contiene tutti i livelli con lo stile grigio scuro.
microsoft.base.road	string	TileetId contiene tutti i livelli con lo stile principale del rendering.
microsoft.imagery	string	TilesetId contiene una combinazione di immagini satellitari e aeree.

TrafficTilesetId

Valore facoltativo, che indica che non viene eseguito alcun flusso di traffico sul risultato dell'immagine. I valori possibili sono microsoft.traffic.relative.main e nessuno. Il valore predefinito non è nessuno, indicando che non viene restituito alcun flusso di traffico. Se viene fornito il tileetId correlato al traffico, restituirà l'immagine della mappa con il livello di traffico corrispondente. Per altre informazioni, vedere Rendering TileetId.

Nome	Tipo	Descrizione
microsoft.traffic.relative.main	string	Set di riquadri correlati al traffico supportato.
none	string	Valore predefinito, nessuna sovrapposizione del flusso di traffico.