RenderGetMapStaticImageQueryParamProperties interface

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.

bbox?: number[]

Valore della proprietà

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.

center?: number[]

Valore della proprietà

Altezza dell'immagine risultante in pixel. Intervallo compreso tra 80 e 1500. Il valore predefinito è 512. Non deve essere usato con bbox.

height?: number

Valore della proprietà

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.

language?: string

Valore della proprietà

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

path?: string

Valore della proprietà

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 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, 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. Per 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. Per 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. Il valore 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

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

pins?: string

Valore della proprietà

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.

tilesetId?: "microsoft.base" | "microsoft.base.labels" | "microsoft.base.hybrid" | "microsoft.terra.main" | "microsoft.base.road" | "microsoft.base.darkgrey" | "microsoft.base.labels.road" | "microsoft.base.labels.darkgrey" | "microsoft.base.hybrid.road" | "microsoft.base.hybrid.darkgrey" | "microsoft.imagery" | "microsoft.weather.radar.main" | "microsoft.weather.infrared.main" | "microsoft.traffic.absolute" | "microsoft.traffic.absolute.main" | "microsoft.traffic.relative" | "microsoft.traffic.relative.main" | "microsoft.traffic.relative.dark" | "microsoft.traffic.delay" | "microsoft.traffic.delay.main" | "microsoft.traffic.reduced.main" | "microsoft.traffic.incident"

Valore della proprietà

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.

trafficLayer?: "microsoft.traffic.relative.main" | "none"

Valore della proprietà

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.

view?: "AE" | "AR" | "BH" | "IN" | "IQ" | "JO" | "KW" | "LB" | "MA" | "OM" | "PK" | "PS" | "QA" | "SA" | "SY" | "YE" | "Auto" | "Unified"

Valore della proprietà

Larghezza dell'immagine risultante in pixel. Intervallo compreso tra 80 e 2000. Il valore predefinito è 512. Non deve essere usato con bbox.

width?: number

Valore della proprietà

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.

zoom?: number

Valore della proprietà