Render - Get Map Static Image

Servizio:: Maps

Versione API:: 2024-04-01

Questa API di rendering produce visualizzazioni 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 in applicazioni esterne al browser, nei servizi back-end, nella generazione di report o nelle applicazioni desktop.

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

Puntine con etichetta in più stili.
Eseguire il rendering di 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 di dettaglio appropriato.

Livello di zoom	Intervallo min Lon	Portata massima di Lon	Intervallo min lat	Portata massima dei lattanti
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: al centro o parametro 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 attuale è 2024-04-01.

bbox

query

number[]

Un rettangolo delimitatore è definito da due latitudine e due longitudini che rappresentano i quattro lati di un'area rettangolare sulla Terra. Formato : 'minLon, minLat, maxLon, maxLat' (in double).

Nota: bbox o center sono parametri obbligatori. 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 doppia. Formato: 'lon,lat'. Intervallo di longitudine: da -180 a 180. Intervallo di latitudine: da -90 a 90.

Nota: i parametri center o bbox sono obbligatori. Si escludono a vicenda.

height

query

integer (int32)

minimum: 80
maximum: 1500

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

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 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 di 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 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, dove 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 della longitudine per le posizioni delle linee e dei 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 modifica stile

Modificatore	Descrizione	TIPO	Intervallo
Lc	Colore della linea	corda	Da 000000 a FFFFFF
fc	Colore riempimento	corda	Da 000000 a FFFFFF
la	Alfa linea (opacità)	galleggiare	da 0 a 1
fa	Riempimento alfa (opacità)	galleggiare	da 0 a 1
Lw	Larghezza della linea	int32	(0, 50]
Ra	Raggio cerchio (metri)	galleggiare	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 da disegno e le istanze specificano le coordinate delle puntine da disegno (in doppio) e le etichette facoltative per ogni puntina. 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 e il numero di posizioni è limitato a 5 per pin. Altri SKU consentono fino a 25 istanze del parametro pin di specificare più stili di pin e il numero di posizioni è limitato a 50 per pin.

Per eseguire il rendering di una puntina a 45°N e longitudine 122°W usando lo stile predefinito della puntina da disegno predefinita, aggiungere il parametro querystring

pins=default||-122 45

Si noti che la longitudine precede la latitudine. Dopo la codifica 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 pipe. Ad esempio, usare

pins=default||-122 45|-119.5 43.2|-121.67 47.12

Lo SKU dell'account di Mappe di Azure S0 consente solo cinque puntine da disegno. Altri SKU di account non hanno questa limitazione.

Modificatori di stile

È possibile modificare l'aspetto delle puntine aggiungendo i 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, 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

pins=default|coFF1493||-122 45

Etichette puntina da disegno

Per aggiungere un'etichetta ai puntini, inserire l'etichetta tra virgolette singole poco prima delle coordinate. Evitare di usare caratteri speciali, ad esempio | 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 puntina predefinito denominato 'none' che non visualizza un'immagine di puntina da disegno. Puoi usarlo se vuoi visualizzare le etichette senza alcuna immagine di aggiunta. 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 dello stile di 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 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 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 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 da 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. La dimensione massima consentita per un'immagine di etichetta personalizzata è di 65.536 pixel. Usare due caratteri di pipe per indicare che sono state specificate le posizioni e che l'URL viene avviato. 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 da disegno personalizzate vengono disegnate al centro in corrispondenza delle coordinate del segnaposto. Questo in genere non è ideale perché nasconde la posizione che si sta tentando di evidenziare. Per eseguire l'override della posizione di ancoraggio dell'immagine del pin, usare il modificatore di stile "an". In questo modo viene usato lo stesso formato del modificatore di stile di ancoraggio dell'etichetta 'la'. Ad esempio, se l'immagine di puntina 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 viene in genere eseguita solo con un'immagine personalizzata a tinta unita.

Ridimensionare, rotazione e opacità

È possibile rendere le puntine e le relative etichette più grandi o più piccole usando il modificatore di stile di scala 'sc'. Si tratta di un valore maggiore di zero. Un valore pari a 1 è la scala standard. I valori maggiori di 1 renderanno più grandi i pin e i valori inferiori a 1 li renderanno più piccoli. Ad esempio, per disegnare le puntine da disegno 50% più grandi del normale, usare

pins=default|sc1.5||-122 45

È possibile ruotare le puntine e le relative etichette usando il modificatore dello stile di rotazione 'ro'. Si tratta di un numero di gradi di rotazione in senso orario. Usare 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 da disegno e le relative etichette parzialmente trasparenti specificando il modificatore di stile alfa 'al'. 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 è il valore predefinito). Ad esempio, per creare puntine da disegno e le relative etichette solo 67% opache, usare

pins=default|al.67||-122 45

Riepilogo modifica stile

Modificatore	Descrizione	TIPO	Intervallo
ale	Alfa (opacità)	galleggiare	da 0 a 1
un	Ancoraggio pin	<int32, int32>	*
co	Colore segnaposto	corda	Da 000000 a FFFFFF
la	Ancoraggio etichette	<int32, int32>	*
Lc	Colore etichetta	corda	Da 000000 a FFFFFF
Ls	Dimensioni etichetta	galleggiare	Maggiore di 0
ro	Rotazione	galleggiare	Da -360 a 360
sc	Scala	galleggiare	Maggiore di 0

Le coordinate X e Y possono essere ovunque all'interno dell'immagine del pin o di un margine intorno a esso. La dimensione del margine è il minimo della larghezza e dell'altezza del segnaposto.

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

trafficLayer

query

TrafficTilesetId

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

view

query

LocalizedMapView

Il parametro View (detto anche parametro "area utente") consente di visualizzare le mappe corrette per un determinato paese/area geografica per aree geopolitiche 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à utilizzata l'applicazione.Different countries/regions have different views of such regions, and the View parameter allows your application to comply with the view required by the country/region your application will be serving. 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 altri contenuti di terze parti autorizzati ad accedere tramite Mappe di Azure. Esempio: view=IN.

Per informazioni dettagliate e per visualizzare le visualizzazioni disponibili, vedere viste supportate.

width

query

integer (int32)

minimum: 80
maximum: 2000

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)

minimum: 0
maximum: 20

Livello di zoom desiderato della mappa. Supporto dell'intervallo di valori di zoom compreso tra 0 e 20 (inclusi) per tilesetId microsoft.base.road o microsoft.base.darkgrey. Supporto dell'intervallo di valori di zoom compreso tra 0 e 19 (inclusi) per tilesetId 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	Indica l'account destinato all'uso con il modello di sicurezza ID Microsoft Entra. Questo ID univoco per l'account Mappe di Azure può essere ottenuto dall'API Account del piano di gestione di Mappe di Azure. Per altre informazioni sull'uso della sicurezza dell'ID Microsoft Entra in Mappe di Azure, vedere Gestire l'autenticazione in Mappe di Azure.
Accept		MediaType	Il campo di intestazione Accetta può essere utilizzato per specificare le preferenze relative ai tipi di supporti di risposta. I tipi di file multimediali consentiti includono image/jpeg e image/png. Restituisci 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 riuscita. Media Types: "image/jpeg", "image/png" Intestazioni Content-Type: string
Other Status Codes	ErrorResponse	Errore imprevisto. Media Types: "image/jpeg", "image/png"

Nome

Tipo

Descrizione

200 OK

object

Questa immagine viene restituita da una chiamata Get Map Static Image riuscita.

Media Types: "image/jpeg", "image/png"

Intestazioni

Content-Type: string

Other Status Codes

ErrorResponse

Errore imprevisto.

Media Types: "image/jpeg", "image/png"

Sicurezza

AADToken

Questi sono i flussi di Microsoft Entra OAuth 2.0. Se abbinato a l'accesso in base al ruolo di Azure controllarlo, può essere usato per controllare l'accesso alle API REST di Mappe di Azure. I controlli di accesso in base al ruolo di Azure vengono usati per designare l'accesso a uno o più account di risorse di Mappe di Azure o a risorse secondarie. A 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 concetti di autenticazione. In sintesi, questa definizione di sicurezza offre una soluzione per la modellazione di applicazioni tramite oggetti in grado di controllare l'accesso su API e ambiti specifici.

Note

Questa definizione di sicurezza richiede l'uso dell'intestazione x-ms-client-id per indicare a quale risorsa di Mappe di Azure l'applicazione richiede l'accesso. Questa operazione può essere acquisita dall'API di gestione di mappe .

Il 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 il portale di Azure, PowerShell, l'interfaccia della riga di comando, gli SDK di Azure o le API REST. * L'utilizzo del 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 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 effettuato il provisioning durante la creazione di un risorsa di Mappe di Azure tramite il 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.

Con questa chiave, qualsiasi applicazione è autorizzata ad accedere a tutte le API REST. In altre parole, questi possono essere attualmente considerati 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 nell'risorsa di Mappe di Azure tramite il 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.

Con questo token, qualsiasi applicazione è autorizzata ad accedere ai controlli di accesso in base al ruolo di Azure e al controllo granulare per la scadenza, la frequenza e le 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 sull'errore di gestione delle risorse.
ErrorDetail	Dettagli dell'errore.
ErrorResponse	Risposta di errore
LocalizedMapView	Il parametro View (detto anche parametro "area utente") consente di visualizzare le mappe corrette per un determinato paese/area geografica per aree geopolitiche 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à utilizzata l'applicazione.Different countries/regions have different views of such regions, and the View parameter allows your application to comply with the view required by the country/region your application will be serving. 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 altri contenuti di terze parti autorizzati ad accedere tramite Mappe di Azure. Esempio: view=IN. Per informazioni dettagliate e per visualizzare le visualizzazioni disponibili, vedere viste supportate.
MediaType	Il campo di intestazione Accetta può essere utilizzato per specificare le preferenze relative ai tipi di supporti di risposta. I tipi di file multimediali consentiti includono image/jpeg e image/png. Restituisci 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 Render TilesetId.
TrafficTilesetId	Valore facoltativo, che indica che non viene eseguito alcun flusso di traffico sovrapposto al risultato dell'immagine. I valori possibili sono microsoft.traffic.relative.main e nessuno. Il valore predefinito è none, che indica che non viene restituito alcun flusso di traffico. Se viene specificato tilesetId correlato al traffico, restituirà l'immagine della mappa con il livello di traffico corrispondente. Per altre informazioni, vedere Render TilesetId.

ErrorAdditionalInfo

Object

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome	Tipo	Descrizione
info	object	Informazioni aggiuntive.
type	string	Tipo di informazioni aggiuntive.

ErrorDetail

Object

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

Object

Risposta di errore

Nome	Tipo	Descrizione
error	ErrorDetail	Oggetto error.

LocalizedMapView

Enumerazione

Per informazioni dettagliate e per visualizzare le visualizzazioni disponibili, vedere viste supportate.

Valore	Descrizione
AE	Emirati Arabi Uniti (visualizzazione araba)
AR	Argentina (visualizzazione argentina)
BH	Bahrain (visualizzazione araba)
IN	India (visualizzazione indiana)
IQ	Iraq (visualizzazione araba)
JO	Giordania (visualizzazione araba)
KW	Kuwait (visualizzazione araba)
LB	Libano (visualizzazione araba)
MA	Marocco (visualizzazione marocchina)
OM	Oman (visualizzazione araba)
PK	Pakistan (visualizzazione pakistana)
PS	Autorità Palestinese (visualizzazione araba)
QA	Qatar (visualizzazione araba)
SA	Arabia Saudita (visualizzazione araba)
SY	Siria (visualizzazione araba)
US	Stati Uniti d'America
YE	Yemen (visualizzazione araba)
Auto	Restituisce i dati della mappa in base all'indirizzo IP della richiesta.
Unified	Visualizzazione unificata (altri)

MediaType

Enumerazione

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

Valore	Descrizione
image/png	Restituisci l'immagine in formato png.
image/jpeg	Restituisci l'immagine in formato jpeg.

TilesetId

Enumerazione

Valore	Descrizione
microsoft.base.road	TilesetId contiene tutti i livelli con lo stile principale di rendering.
microsoft.base.darkgrey	TilesetId contiene tutti i livelli con il nostro stile grigio scuro.
microsoft.imagery	TilesetId contiene una combinazione di immagini satellitari e aeree.

TrafficTilesetId

Enumerazione

Valore	Descrizione
microsoft.traffic.relative.main	TilesetId relativo al traffico supportato.
none	Valore predefinito, nessuna sovrapposizione del flusso di traffico.

Condividi tramite

Render - Get Map Static Image

Parametri dell'URI

Modificatori di stile

Riepilogo modifica stile

Modificatori di stile

Etichette puntina da disegno

Puntine personalizzate

Ridimensionare, rotazione e opacità

Riepilogo modifica stile

Intestazione della richiesta

Risposte

Sicurezza

AADToken

Note

Ambiti

subscription-key

SAS Token

Esempio

Successful Static Image Request

Esempio di richiesta

Risposta di esempio

Definizioni

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

LocalizedMapView

MediaType

TilesetId

TrafficTilesetId