Render - Get Map Image

Servizio:

Maps

Versione API:

1.0

Usare per eseguire il rendering di un'immagine rettangolare definita dall'utente contenente una sezione mappa usando un livello di zoom compreso tra 0 e 20.

Nota

Mappe di Azure Rendering v1 ritiro del servizio

Il servizio rendering Mappe di Azure v1 è ora deprecato e verrà ritirato il 9/17/26. Per evitare interruzioni del servizio, tutte le chiamate all'API Render v1 devono essere aggiornate per usare l'API Render v2 entro 9/17/26.

L'intervallo di risoluzione supportato per l'immagine della mappa è compreso tra 1x1 e 8192x8192. Se si decide quando usare il servizio immagini statiche nel servizio riquadro della mappa, è possibile considerare come interagire con la mappa di cui è stato eseguito il rendering. Se il contenuto della mappa sarà relativamente invariato, una mappa statica è una buona scelta. Se si vuole supportare un sacco di zoom, panoramica e modifica del contenuto della mappa, il servizio riquadro della mappa sarà una scelta migliore.

Il servizio offre anche funzionalità Di composizione immagini per ottenere un'immagine statica con dati aggiuntivi come; pushpin e sovrapposizioni geometry con le funzionalità Gen1 S0, S1 e Gen2 seguenti.

In Gen1 S0 è possibile:

• Eseguire il rendering di fino a 5 pin specificati nella richiesta
• Specificare un'immagine personalizzata per i pin a cui si fa riferimento nella richiesta
• Aggiungere etichette alle pinne

In Gen1 S1 e Gen2 è possibile:

• Eseguire il rendering delle pinne tramite Mappe di Azure Data Service
• Specificare più stili pushpin
• Eseguire il rendering dei tipi di geometria cerchio, polilinea e poligono.
• Rendering dei tipi geometry GeoJSON supportati caricati tramite Mappe di Azure Data Service

Per esempi dettagliati, vedere la guida come eseguire il rendering di dati personalizzati in una mappa raster.

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

Gli intervalli Lat e Lon supportati quando si usa il parametro bbox sono i seguenti:

Livello di zoom	Max Lon Range	Intervallo massimo lat
0	360.0	170.0
1	360.0	170.0
2	360.0	170.0
3	360.0	170.0
4	360.0	170.0
5	180.0	85,0
6	90,0	42.5
7	45.0	21,25
8	22,5	10.625
9	11,25	5.3125
10	5.625	2.62625
11	2.8125	1.328125
12	1.40625	0.6640625
13	0.703125	0.33203125
14	0.3515625	0.166015625
15	0.17578125	0.0830078125
16	0.087890625	0.0415039063
17	0.0439453125	0.0207519531
18	0.0219726563	0.0103759766
19	0.0109863281	0.0051879883
20	0.0054931641	0.0025939941

GET https://atlas.microsoft.com/map/static/png?api-version=1.0

Con parametri facoltativi:

GET https://atlas.microsoft.com/map/static/png?api-version=1.0&layer={layer}&style={style}&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
format	path	True	RasterTileFormat	Formato desiderato della risposta. Valore possibile: png.
api-version	query	True	string	Numero di versione dell'API Mappe di Azure.
bbox	query		number[]	Riquadro. Proiezione usata : EPSG:3857. Formato: 'minLon, minLat, maxLon, maxLat'. Nota: bbox o center sono parametri obbligatori. Si escludono a vicenda. Non deve essere usato con altezza o larghezza. Gli intervalli massimi 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. Formato: 'lon,lat'. Proiezione usata EPSG:3857. Intervallo di longitudine: da -180 a 180. Intervallo di latitudine: da -85 a 85. Nota: i parametri center o bbox sono obbligatori. Si escludono a vicenda.
height	query		integer int32	Altezza dell'immagine risultante in pixel. L'intervallo è compreso tra 1 e 8192. 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 di lingua 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 .
layer	query		StaticMapLayer	Livello mappa richiesto. Se il livello è impostato su etichette o ibrido, il formato deve essere png.
path	query		string[]	Stile percorso e posizioni. Usare questo parametro per aggiungere facoltativamente righe, poligoni o cerchi all'immagine. Lo stile del percorso descrive l'aspetto della linea e del riempimento. Assicurarsi di codificare correttamente i valori URL di questo parametro perché conterrà caratteri riservati, ad esempio pipe e punteggiatura. Il parametro path è supportato in Mappe di Azure SKU dell'account a partire da S1. Più istanze del parametro percorso 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 viene prima della latitudine. Dopo aver eseguito la codifica dell'URL, questo aspetto sarà simile al seguente path=ra100%7C%7C-122+45 Tutti gli esempi qui mostrano il parametro percorso senza codifica URL, per maggiore chiarezza. Per eseguire il rendering di una riga, separare ogni posizione con un carattere di pipe. Ad esempio, usare path=||-122 45|-119.5 43.2|-121.67 47.12 Per eseguire il rendering di un poligono, l'ultima posizione deve essere uguale alla posizione iniziale. Ad esempio, usare path=||-122 45|-119.5 43.2|-121.67 47.12|-122 45 I valori di longitudine e latitudine per le posizioni di linee e poligoni possono trovarsi 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. Vengono aggiunti prima delle posizioni. 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 struttura, usare il modificatore di stile 'lc' e specificare il colore usando il formato di colore HTML/CSS RGB 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 visivo 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 Recupero dei percorsi da archiviazione dati Mappe di Azure Per tutti gli SKU dell'account Mappe di Azure diversi da S0, le informazioni sulla posizione del percorso possono essere ottenute da Mappe di Azure Archiviazione dati. Dopo aver caricato un documento GeoJSON contenente i percorsi del percorso, il servizio archiviazione dati restituisce un ID dati univoco (UDID) che è possibile usare per fare riferimento ai dati nel parametro del percorso. Per usare la geometria del punto da un documento GeoJSON caricato come percorsi del percorso, specificare l'UDID nella sezione percorsi del parametro percorso. Ad esempio, path=||udid-29dc105a-dee7-409f-a3f9-22b066ae4713 Si noti che non è consentito combinare i percorsi del percorso da Archiviazione dati con le posizioni specificate nel parametro percorso. Riepilogo modifica stile Modificatore Descrizione Range Lc Colore linea 000000 a FFFFFFFF Fc Fill color 000000 a FFFFFFFF la Linea alfa (opacità) da 0 a 1 fa Riempimento alfa (opacità) da 0 a 1 Lw Spessore linea Maggiore di 0 Ra Raggio cerchio (metri) Maggiore di 0
pins	query		string[]	Stile e istanze della puntina da disegno. Usare questo parametro per aggiungere facoltativamente puntine all'immagine. Lo stile della puntina da disegno descrive l'aspetto delle puntine e le istanze specificano le coordinate delle puntine da disegno e delle etichette facoltative per ogni puntina. Assicurarsi di codificare correttamente i valori con codifica 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 pins. Altri SKU consentono a più istanze del parametro pin di specificare più stili pin. Per eseguire il rendering di una puntina a latitudine 45°N e longitudine 122°W usando lo stile predefinito della puntina da disegno, aggiungere il parametro querystring pins=default||-122 45 Si noti che la longitudine precede la latitudine. Dopo la codifica dell'URL, l'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 S0 Mappe di Azure consente solo cinque puntine da disegno. Altri SKU di account non hanno questa limitazione. Modificatori di stile È possibile modificare l'aspetto dei pin aggiungendo modificatori di stile. Questi vengono aggiunti dopo lo stile, ma prima delle posizioni e delle etichette. 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 puntina da disegno, 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 (il formato a tre cifre non è supportato). Ad esempio, per usare un colore rosa profondo che si specifica come #FF1493 in CSS, usare pins=default|coFF1493||-122 45 Etichette di puntina da disegno Per aggiungere un'etichetta ai puntini, inserire l'etichetta tra virgolette singole subito prima delle coordinate. Ad esempio, per etichettare tre puntini con i valori '1', '2' e '3', usare pins=default||'1'-122 45|'2'-119.5 43.2|'3'-121.67 47.12 C'è uno stile di puntina predefinito denominato 'none' che non visualizza un'immagine di puntina da disegno. È possibile usarlo se si desidera visualizzare le etichette senza alcuna immagine di puntina. Ad esempio, pins=none||'A'-122 45|'B'-119.5 43.2 Per modificare il colore delle etichette della puntina da disegno, usare il modificatore di stile del colore dell'etichetta 'lc'. Ad esempio, per usare puntine rosa con etichette nere, usare pins=default|coFF1493|lc000000||-122 45 Per modificare le dimensioni delle etichette, usare il modificatore di stile delle dimensioni delle etichette 'ls'. La dimensione dell'etichetta rappresenta 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 sono centrate sulla puntina di ancoraggio dell'etichetta. La posizione di ancoraggio è predefinita per le puntine da disegno predefinite e si trova al centro superiore delle puntine personalizzate (vedere di seguito). Per eseguire l'override dell'ancoraggio dell'etichetta, usando il modificatore di stile "la" e fornire le coordinate pixel X e Y per l'ancoraggio. Queste coordinate sono relative all'angolo superiore sinistro dell'immagine della puntina da disegno. 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 10 pixel a destra e 4 pixel sopra l'angolo superiore sinistro dell'immagine della puntina da disegno, usare pins=default|la10 -4||'A'-122 45|'B'-119 43 Puntine personalizzate Per usare un'immagine di puntina da disegno personalizzata, usare la parola 'custom' come nome dello stile di aggiunta e quindi specificare un URL dopo la posizione e le informazioni sull'etichetta. Usare due caratteri pipe per indicare che è stato fatto specificare i percorsi e avviare 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. Recupero di puntine da archiviazione dati di Mappe di Azure Per tutti gli SKU dell'account Mappe di Azure diversi da S0, le informazioni sulla posizione della puntina da disegno possono essere ottenute da Mappe di Azure Archiviazione dati. Dopo aver caricato un documento GeoJSON contenente le posizioni dei pin, il servizio di archiviazione dati restituisce un ID dati univoco (UDID) che è possibile usare per fare riferimento ai dati nel parametro pin. Per usare la geometria del punto da un documento GeoJSON caricato come posizioni dei pin, specificare l'UDID nella sezione locations del parametro pins. Ad esempio, pins=default||udid-29dc105a-dee7-409f-a3f9-22b066ae4713 Si noti che verranno usati solo la geometria punto e multipunto, i punti e i multipunti dalle raccolte geometry e la geometria dei punti dalle caratteristiche. La geometria linestring e poligono verrà ignorata. Se il punto proviene da una funzionalità e la funzionalità ha una proprietà stringa denominata "label", il valore di tale proprietà verrà usato come etichetta per il pin. È possibile combinare le posizioni dei pin da Archiviazione dati e i percorsi dei pin specificati nel parametro pin. Qualsiasi posizione del segnaposto delimitata da pipe può essere una longitudine e una latitudine o un UDID. Ad esempio, pins=default||-122 45|udid-29dc105a-dee7-409f-a3f9-22b066ae4713|-119 43 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 Range al Alfa (opacità) da 0 a 1 any Ancoraggio di ancoraggio * co Colore del segnaposto Da 000000 a FFFFFF la Ancoraggio etichetta * Lc Colore etichetta 000000 a FFFFFFFF ls Dimensioni etichetta Maggiore di 0 ro Rotazione -360 a 360 M.b Scalabilità Maggiore di 0 Le coordinate X e Y possono essere ovunque all'interno di un'immagine di pin o un margine intorno a esso. La dimensione del margine è il minimo della larghezza e dell'altezza del pin.
style	query		MapImageStyle	Stile mappa da restituire. I valori possibili sono principali e scuri.
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. Paesi/aree geografiche diverse 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à utilizzata 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. L'intervallo è compreso tra 1 e 8192. Il valore predefinito è 512. Non deve essere usato con bbox.
zoom	query		integer int32	Livello di zoom desiderato della mappa. Il valore di zoom deve essere compreso nell'intervallo compreso tra 0 e 20 (inclusi). Il valore predefinito è 12. Per informazioni dettagliate, vedi Livelli di zoom e Griglia 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 Microsoft Entra ID sicurezza in Mappe di Azure vedere gli articoli seguenti per indicazioni.

Risposte

Nome	Tipo	Descrizione
200 OK	object	Questa immagine viene restituita da una chiamata di immagine statica get map riuscita Media Types: "application/json", "image/jpeg", "image/png", "image/pbf", "application/vnd.mapbox-vector-tile" Intestazioni Content-Type: string
Other Status Codes	ErrorResponse	Si è verificato un errore imprevisto. Media Types: "application/json", "image/jpeg", "image/png", "image/pbf", "application/vnd.mapbox-vector-tile"

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.

Note

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

Successful Static Image Request

Esempio di richiesta

HTTP

GET https://atlas.microsoft.com/map/static/png?api-version=1.0&layer=basic&style=main&zoom=2&bbox=1.355233,42.982261,24.980233,56.526017

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 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.
MapImageStyle	Stile mappa da restituire. I valori possibili sono principali e scuri.
RasterTileFormat	Formato desiderato della risposta. Valore possibile: png.
StaticMapLayer	Livello mappa richiesto. Se il livello è impostato su etichette o ibrido, il formato deve essere png.

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

MapImageStyle

Stile mappa da restituire. I valori possibili sono principali e scuri.

Nome	Tipo	Descrizione
dark	string	Versione grigio scuro dello stile principale Mappe di Azure
main	string	Mappe di Azure stile principale

RasterTileFormat

Formato desiderato della risposta. Valore possibile: png.

Nome	Tipo	Descrizione
png	string	Immagine nel formato png. Supporta i livelli di zoom da 0 a 18.

StaticMapLayer

Livello mappa richiesto. Se il livello è impostato su etichette o ibrido, il formato deve essere png.

Nome	Tipo	Descrizione
basic	string	Restituisce un'immagine contenente tutte le funzionalità della mappa, tra cui poligoni, bordi, strade e etichette.
hybrid	string	Restituisce un'immagine contenente bordi, strade e etichette e può essere sovrascritto in altri riquadri (ad esempio immagini satellite) per produrre riquadri ibridi.
labels	string	Restituisce un'immagine delle informazioni sull'etichetta della mappa.