Consente la creazione e la decorazione di immagini di mappe statiche.
L'esempio seguente mostra come utilizzare questa classe per creare una mappa del Theatre District di New York, incluse le stazioni ferroviarie vicine, e visualizzarla in una semplice app web.
// Create a map centered on Times Square. const map = Maps.newStaticMap().setSize(600, 600).setCenter( 'Times Square, New York, NY'); // Add markers for the nearbye train stations. map.setMarkerStyle( Maps.StaticMap.MarkerSize.MID, Maps.StaticMap.Color.RED, 'T', ); map.addMarker('Grand Central Station, New York, NY'); map.addMarker('Penn Station, New York, NY'); // Show the boundaries of the Theatre District. const corners = [ '8th Ave & 53rd St, New York, NY', '6th Ave & 53rd St, New York, NY', '6th Ave & 40th St, New York, NY', '8th Ave & 40th St, New York, NY', ]; map.setPathStyle(4, Maps.StaticMap.Color.BLACK, Maps.StaticMap.Color.BLUE); map.beginPath(); for (let i = 0; i < corners.length; i++) { map.addAddress(corners[i]); } // All static map URLs require an API key. const url = `${map.getMapUrl()}&key=YOUR_API_KEY`;
Vedi anche
Metodi
| Metodo | Tipo restituito | Breve descrizione |
|---|---|---|
add | Static | Aggiunge un nuovo indirizzo alla definizione del percorso corrente. |
add | Static | Aggiunge un indicatore alla mappa utilizzando un punto (latitudine/longitudine). |
add | Static | Aggiunge un indicatore alla mappa utilizzando un indirizzo. |
add | Static | Aggiunge un percorso alla mappa utilizzando un array di punti. |
add | Static | Aggiunge un percorso alla mappa utilizzando una polilinea codificata. |
add | Static | Aggiunge un nuovo punto (latitudine/longitudine) alla definizione del percorso corrente. |
add | Static | Aggiunge una posizione (latitudine/longitudine) che deve essere visibile sulla mappa. |
add | Static | Aggiunge una posizione dell'indirizzo che deve essere visibile nella mappa. |
begin | Static | Avvia una nuova definizione del percorso. |
clear | Static | Cancella l'attuale insieme di indicatori. |
clear | Static | Cancella l'attuale insieme di percorsi. |
clear | Static | Cancella l'insieme attuale di posizioni visibili. |
end | Static | Completa una definizione di percorso iniziata con beginPath(). |
get | Blob | Restituisce i dati all'interno di questo oggetto come blob convertito nel tipo di contenuti specificato. |
get | Blob | Recupera i dati dell'immagine come Blob. |
get | Byte[] | Recupera i dati dell'immagine non elaborata come array di byte. |
get | String | Recupera l'URL dell'immagine della mappa. |
set | Static | Imposta il centro della mappa utilizzando un punto (latitudine/longitudine). |
set | Static | Imposta il centro della mappa utilizzando un indirizzo. |
set | Static | Imposta l'immagine del marcatore personalizzato da utilizzare durante la creazione di nuovi marcatori. |
set | Static | Imposta il formato dell'immagine della mappa. |
set | Static | Imposta la lingua da utilizzare per il testo sulla mappa (se disponibile). |
set | Static | Imposta il tipo di mappa da mostrare. |
set | Static | Imposta lo stile del marcatore da utilizzare durante la creazione di nuovi marcatori. |
set | Static | Specifica se utilizzare o meno set di riquadri specializzati per i dispositivi mobili. |
set | Static | Imposta lo stile del percorso da utilizzare quando crei nuovi percorsi. |
set | Static | Imposta la larghezza e l'altezza dell'immagine della mappa in pixel. |
set | Static | Imposta il fattore di zoom o il livello di ingrandimento utilizzato per la mappa. |
Documentazione dettagliata
add Address(address)
Aggiunge un nuovo indirizzo alla definizione del percorso corrente.
// Creates a map and adds a path from New York to Boston. const map = Maps.newStaticMap() .beginPath() .addAddress('New York, NY') .addAddress('Boston, MA') .endPath();
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
address | String | Un indirizzo da aggiungere. |
Indietro
Static: questa istanza della mappa, per il concatenamento.
add Marker(latitude, longitude)
Aggiunge un indicatore alla mappa utilizzando un punto (latitudine/longitudine).
// Creates a map and adds a marker at the specified coordinates. const map = Maps.newStaticMap().addMarker(40.741799, -74.004207);
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
latitude | Number | La latitudine del nuovo indicatore. |
longitude | Number | La longitudine del nuovo indicatore. |
Indietro
Static: questa istanza della mappa, per il concatenamento.
Vedi anche
add Marker(address)
Aggiunge un indicatore alla mappa utilizzando un indirizzo.
// Creates a map and adds a marker at the specified address. const map = Maps.newStaticMap().addMarker('76 9th Ave, New York NY');
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
address | String | L'indirizzo in cui posizionare il nuovo indicatore. |
Indietro
Static: questa istanza della mappa, per il concatenamento.
Vedi anche
add Path(points)
Aggiunge un percorso alla mappa utilizzando un array di punti.
// Creates a map and adds a path from New York to Boston. const map = Maps.newStaticMap().addPath([ 40.714353, -74.005973, 42.358431, -71.059773, ]);
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
points | Number[] | Un array di coppie latitudine/longitudine che definiscono il percorso. |
Indietro
Static: questa istanza della mappa, per il concatenamento.
add Path(polyline)
Aggiunge un percorso alla mappa utilizzando una polilinea codificata.
// Creates a map and adds a path from New York to Boston. const polyline = Maps.encodePolyline([ 40.714353, -74.005973, 42.358431, -71.059773, ]); const map = Maps.newStaticMap().addPath(polyline);
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
polyline | String | Una polilinea codificata. |
Indietro
Static: questa istanza della mappa, per il concatenamento.
add Point(latitude, longitude)
Aggiunge un nuovo punto (latitudine/longitudine) alla definizione del percorso corrente.
// Creates a map and adds a path from New York to Boston. const map = Maps.newStaticMap() .beginPath() .addPoint(40.714353, -74.005973) .addPoint(42.358431, -71.059773) .endPath();
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
latitude | Number | La latitudine del punto. |
longitude | Number | La longitudine del punto. |
Indietro
Static: questa istanza della mappa, per il concatenamento.
add Visible(latitude, longitude)
Aggiunge una posizione (latitudine/longitudine) che deve essere visibile sulla mappa.
// Creates a map where New York and Boston are visible. const map = Maps.newStaticMap() .addVisible(40.714353, -74.005973) .addVisible(42.358431, -71.059773);
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
latitude | Number | La latitudine del punto. |
longitude | Number | La longitudine del punto. |
Indietro
Static: questa istanza della mappa, per il concatenamento.
Vedi anche
add Visible(address)
Aggiunge una posizione dell'indirizzo che deve essere visibile nella mappa.
// Creates a map where New York and Boston are visible. const map = Maps.newStaticMap().addVisible('New York, NY').addVisible('Boston, MA');
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
address | String | Un indirizzo che deve essere visibile sulla mappa. |
Indietro
Static: questa istanza della mappa, per il concatenamento.
Vedi anche
begin Path()
Avvia una nuova definizione del percorso. Le chiamate a add e add definiscono ogni
nuovo vertice nel percorso. Il percorso viene completato quando viene chiamato end.
// Creates a map and adds a path from New York to Boston. const map = Maps.newStaticMap() .beginPath() .addAddress('New York, NY') .addAddress('Boston, MA') .endPath();
Indietro
Static: questa istanza della mappa, per il concatenamento.
clear Markers()
Cancella l'attuale insieme di indicatori.
const map = Maps.newStaticMap(); // ... // Do something interesting here ... // ... // Remove all markers on the map. map.clearMarkers();
Indietro
Static: questa istanza della mappa, per il concatenamento.
clear Paths()
Cancella l'attuale insieme di percorsi.
const map = Maps.newStaticMap(); // ... // Do something interesting here ... // ... // Remove all paths on the map. map.clearPaths();
Indietro
Static: questa istanza della mappa, per il concatenamento.
clear Visibles()
Cancella l'insieme attuale di posizioni visibili.
const map = Maps.newStaticMap(); // ... // Do something interesting here ... // ... // Remove all visible locations created with addVisible(). map.clearVisibles();
Indietro
Static: questa istanza della mappa, per il concatenamento.
end Path()
Completa una definizione di percorso iniziata con beginPath().
// Creates a map and adds a path from New York to Boston. const map = Maps.newStaticMap() .beginPath() .addAddress('New York, NY') .addAddress('Boston, MA') .endPath();
Indietro
Static: questa istanza della mappa, per il concatenamento.
get As(contentType)
Restituisce i dati all'interno di questo oggetto come blob convertito nel tipo di contenuti specificato. Questo metodo aggiunge l'estensione appropriata al nome file, ad esempio "myfile.pdf". Tuttavia, si presume che la parte del nome file che segue l'ultimo punto (se presente) sia un'estensione esistente che deve essere sostituita. Di conseguenza, "ShoppingList.12.25.2014" diventa "ShoppingList.12.25.pdf".
Per visualizzare le quote giornaliere per le conversioni, consulta Quote per i servizi Google. I domini Google Workspace appena creati potrebbero essere temporaneamente soggetti a quote più rigide.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
content | String | Il tipo MIME in cui eseguire la conversione. Per la maggior parte dei blob, 'application/pdf' è
l'unica opzione valida. Per le immagini in formato BMP, GIF, JPEG o PNG, sono validi anche 'image/bmp', 'image/gif', 'image/jpeg' o 'image/png'. Per un documento Google, è valido anche 'text/markdown'. |
Indietro
Blob: i dati come blob.
get Blob()
Recupera i dati dell'immagine come Blob.
// Creates a map centered on Times Square and saves it to Google Drive. const map = Maps.newStaticMap().setCenter('Times Square, New York, NY'); DriveApp.createFile(map); // You can call map.getBlob() explicitly or use it // implicitly by passing the map where a blob is expected.
Indietro
Blob: un'immagine della mappa nel formato selezionato.
get Map Image()
Recupera i dati dell'immagine non elaborati come array di byte.
In generale, è preferibile utilizzare get, che consente interazioni più semplici con altri
servizi.
// Creates a map centered on Times Square and saves it to Google Drive. const map = Maps.newStaticMap().setCenter('Times Square, New York, NY'); DriveApp.createFile( Utilities.newBlob(map.getMapImage(), 'image/png', 'map.png'), );
Indietro
Byte[]: un'immagine della mappa nel formato selezionato.
get Map Url()
Recupera l'URL dell'immagine della mappa.
// Creates a map centered on Times Square and gets the URL. const map = Maps.newStaticMap().setCenter('Times Square, New York, NY'); // All static map URLs require an API key. Logger.log(`${map.getMapUrl()}&key=YOUR_API_KEY`);
Indietro
String: URL dell'immagine della mappa.
set Center(latitude, longitude)
Imposta il centro della mappa utilizzando un punto (latitudine/longitudine).
// Creates a map centered on Times Square, using its coordinates. const map = Maps.newStaticMap().setCenter(40.759011, -73.984472);
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
latitude | Number | La latitudine del centro. |
longitude | Number | La longitudine del centro. |
Indietro
Static: questa istanza della mappa, per il concatenamento.
Vedi anche
set Center(address)
Imposta il centro della mappa utilizzando un indirizzo.
// Creates a map centered on Times Square, using its address. const map = Maps.newStaticMap().setCenter('Times Square, New York, NY');
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
address | String | L'indirizzo del centro. |
Indietro
Static: questa istanza della mappa, per il concatenamento.
Vedi anche
set Custom Marker Style(imageUrl, useShadow)
Imposta l'immagine del marcatore personalizzato da utilizzare durante la creazione di nuovi marcatori. I marcatori già aggiunti non sono interessati.
// Creates a map with markers set to be medium sized, black, and labeled with // the number "1". const map = Maps.newStaticMap().setCustomMarkerStyle( 'http://www.example.com/marker.png', false, );
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
image | String | Specifica un URL da utilizzare come icona personalizzata del marcatore. Le immagini possono essere in formato PNG, JPEG o GIF, anche se è consigliato il formato PNG. |
use | Boolean | Indica che l'indicatore deve avere un'ombra generata in base alla regione visibile dell'immagine e alla sua opacità/trasparenza. |
Indietro
Static: questa istanza della mappa, per il concatenamento.
Vedi anche
set Format(format)
Imposta il formato dell'immagine della mappa.
// Creates a map with the image format set to PNG. const map = Maps.newStaticMap().setFormat(Maps.StaticMap.Format.PNG);
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
format | String | Un valore costante da Format. |
Indietro
Static: questa istanza della mappa, per il concatenamento.
Vedi anche
set Language(language)
Imposta la lingua da utilizzare per il testo sulla mappa (se disponibile).
// Creates a map with the language set to French. const map = Maps.newStaticMap().setLanguage('fr');
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
language | String | Un identificatore di lingua BCP-47. |
Indietro
Static: questa istanza della mappa, per il concatenamento.
Vedi anche
set Map Type(mapType)
set Marker Style(size, color, label)
Imposta lo stile del marcatore da utilizzare durante la creazione di nuovi marcatori. I marcatori già aggiunti non sono interessati.
// Creates a map with markers set to be medium sized, black, and labeled with // the number "1". const map = Maps.newStaticMap().setMarkerStyle( Maps.StaticMap.MarkerSize.MID, Maps.StaticMap.Color.BLACK, '1', );
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
size | String | Un valore costante da Marker. |
color | String | Una stringa nel formato "0xrrggbb" o un valore costante di Color. |
label | String | Una stringa contenente un singolo carattere A-Z o 0-9. |
Indietro
Static: questa istanza della mappa, per il concatenamento.
Vedi anche
set Mobile(useMobileTiles)
Specifica se utilizzare o meno set di riquadri specializzati per i dispositivi mobili.
// Creates a map that uses mobile-friendly tiles. const map = Maps.newStaticMap().setMobile(true);
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
use | Boolean | Se utilizzare o meno i riquadri per il mobile. |
Indietro
Static: questa istanza della mappa, per il concatenamento.
set Path Style(weight, color, fillColor)
Imposta lo stile del percorso da utilizzare quando crei nuovi percorsi. I percorsi già aggiunti non sono interessati.
// Creates a map with paths set to be 1 pixel wide with a black line and a white // fill. const map = Maps.newStaticMap().setPathStyle( 1, Maps.StaticMap.Color.BLACK, 'red', );
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
weight | Integer | La larghezza delle linee in pixel. |
color | String | Il colore della linea, come stringa nel formato "0xrrggbb" o un valore costante di
Color. |
fill | String | Il colore di riempimento, una stringa nel formato "0xrrggbb" o un valore costante di
Color. |
Indietro
Static: questa istanza della mappa, per il concatenamento.
Vedi anche
set Size(width, height)
Imposta la larghezza e l'altezza dell'immagine della mappa in pixel.
// Creates a map 400px wide by 300px high. const map = Maps.newStaticMap().setSize(400, 300);
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
width | Integer | La larghezza dell'immagine in pixel. |
height | Integer | L'altezza dell'immagine in pixel. |
Indietro
Static: questa istanza della mappa, per il concatenamento.
Vedi anche
set Zoom(zoom)
Imposta il fattore di zoom o il livello di ingrandimento utilizzato per la mappa.
// Creates a map with a zoom factor of 10. const map = Maps.newStaticMap().setZoom(10);
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
zoom | Integer | Un valore compreso tra 0 e 21 inclusi. |
Indietro
Static: questa istanza della mappa, per il concatenamento.