Consente la creazione e la decorazione di immagini di mappe statiche.
L'esempio riportato di seguito mostra come utilizzare questa classe per creare una mappa del Theatre District di New York, incluse le stazioni ferroviarie nelle vicinanze, 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 |
---|---|---|
addAddress(address) | StaticMap | Aggiunge un nuovo indirizzo alla definizione del percorso corrente. |
addMarker(latitude, longitude) | StaticMap | Aggiunge un indicatore alla mappa utilizzando un punto (lat/lng). |
addMarker(address) | StaticMap | Aggiunge un indicatore alla mappa utilizzando un indirizzo. |
addPath(points) | StaticMap | Aggiunge un percorso alla mappa utilizzando un array di punti. |
addPath(polyline) | StaticMap | Aggiunge un percorso alla mappa utilizzando una polilinea codificata. |
addPoint(latitude, longitude) | StaticMap | Aggiunge un nuovo punto (lat/lng) alla definizione del percorso corrente. |
addVisible(latitude, longitude) | StaticMap | Aggiunge una posizione del punto (lat/lng) che deve essere visibile nella mappa. |
addVisible(address) | StaticMap | Aggiunge una posizione dell'indirizzo che deve essere visibile nella mappa. |
beginPath() | StaticMap | Avvia una nuova definizione di percorso. |
clearMarkers() | StaticMap | Cancella l'insieme di indicatori corrente. |
clearPaths() | StaticMap | Cancella l'insieme di percorsi corrente. |
clearVisibles() | StaticMap | Cancella l'insieme attuale di località visibili. |
endPath() | StaticMap | Completa una definizione di percorso iniziata con beginPath(). |
getAs(contentType) | Blob | Restituisce i dati all'interno di questo oggetto come blob convertito nel tipo di contenuti specificato. |
getBlob() | Blob | Recupera i dati dell'immagine come Blob . |
getMapImage() | Byte[] | Recupera i dati non elaborati dell'immagine come array di byte. |
getMapUrl() | String | Recupera l'URL dell'immagine mappa. |
setCenter(latitude, longitude) | StaticMap | Imposta il centro della mappa utilizzando un punto (lat/lng). |
setCenter(address) | StaticMap | Imposta il centro della mappa utilizzando un indirizzo. |
setCustomMarkerStyle(imageUrl, useShadow) | StaticMap | Imposta l'immagine del marker personalizzato da utilizzare quando crei nuovi indicatori. |
setFormat(format) | StaticMap | Imposta il formato dell'immagine della mappa. |
setLanguage(language) | StaticMap | Imposta la lingua da utilizzare per il testo sulla mappa (se disponibile). |
setMapType(mapType) | StaticMap | Imposta il tipo di mappa da mostrare. |
setMarkerStyle(size, color, label) | StaticMap | Imposta lo stile dell'indicatore da utilizzare per la creazione di nuovi indicatori. |
setMobile(useMobileTiles) | StaticMap | Imposta se utilizzare o meno insiemi di riquadri specializzati per i dispositivi mobili. |
setPathStyle(weight, color, fillColor) | StaticMap | Imposta lo stile del percorso da utilizzare per la creazione di nuovi percorsi. |
setSize(width, height) | StaticMap | Imposta la larghezza e l'altezza dell'immagine della mappa in pixel. |
setZoom(zoom) | StaticMap | Imposta il fattore di zoom o il livello di ingrandimento utilizzato per la mappa. |
Documentazione dettagliata
addAddress(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. |
Invio
StaticMap
: questa istanza di mappa, per l'accodamento.
addMarker(latitude, longitude)
Aggiunge un indicatore alla mappa utilizzando un punto (lat/lng).
// 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. |
Invio
StaticMap
: questa istanza di mappa, per l'accodamento.
Vedi anche
addMarker(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. |
Invio
StaticMap
: questa istanza di mappa, per l'accodamento.
Vedi anche
addPath(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 di latitudine/longitudine che definiscono il percorso. |
Invio
StaticMap
: questa istanza di mappa, per l'accodamento.
addPath(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. |
Invio
StaticMap
: questa istanza di mappa, per l'accodamento.
addPoint(latitude, longitude)
Aggiunge un nuovo punto (lat/lng) 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. |
Invio
StaticMap
: questa istanza di mappa, per l'accodamento.
addVisible(latitude, longitude)
Aggiunge una posizione del punto (lat/lng) che deve essere visibile nella 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. |
Invio
StaticMap
: questa istanza di mappa, per l'accodamento.
Vedi anche
addVisible(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 nella mappa. |
Invio
StaticMap
: questa istanza di mappa, per l'accodamento.
Vedi anche
beginPath()
Avvia una nuova definizione di percorso. Le chiamate a addAddress()
e addPoint()
definiscono ogni
nuovo vertice nel percorso. Il percorso viene completato quando viene chiamato endPath()
.
// 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();
Invio
StaticMap
: questa istanza di mappa, per l'accodamento.
clearMarkers()
Cancella l'insieme di indicatori corrente.
const map = Maps.newStaticMap(); // ... // Do something interesting here ... // ... // Remove all markers on the map. map.clearMarkers();
Invio
StaticMap
: questa istanza di mappa, per l'accodamento.
clearPaths()
Cancella l'insieme di percorsi corrente.
const map = Maps.newStaticMap(); // ... // Do something interesting here ... // ... // Remove all paths on the map. map.clearPaths();
Invio
StaticMap
: questa istanza di mappa, per l'accodamento.
clearVisibles()
Cancella l'insieme corrente di località visibili.
const map = Maps.newStaticMap(); // ... // Do something interesting here ... // ... // Remove all visible locations created with addVisible(). map.clearVisibles();
Invio
StaticMap
: questa istanza di mappa, per l'accodamento.
endPath()
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();
Invio
StaticMap
: questa istanza di mappa, per l'accodamento.
getAs(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, assume 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ù severe.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
contentType | String | Il tipo MIME a 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 di Documenti Google, è valido anche 'text/markdown' . |
Invio
Blob
: i dati come blob.
getBlob()
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.
Invio
Blob
: un'immagine della mappa nel formato selezionato.
getMapImage()
Recupera i dati non elaborati dell'immagine come array di byte.
In generale, ti consigliamo di utilizzare getBlob()
, 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'), );
Invio
Byte[]
: un'immagine della mappa nel formato selezionato.
getMapUrl()
Recupera l'URL dell'immagine 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`);
Invio
String
- URL L'URL dell'immagine della mappa.
setCenter(latitude, longitude)
Imposta il centro della mappa utilizzando un punto (lat/lng).
// 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. |
Invio
StaticMap
: questa istanza di mappa, per l'accodamento.
Vedi anche
setCenter(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. |
Invio
StaticMap
: questa istanza di mappa, per l'accodamento.
Vedi anche
setCustomMarkerStyle(imageUrl, useShadow)
Imposta l'immagine del marker personalizzato da utilizzare quando crei nuovi indicatori. I marker 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 |
---|---|---|
imageUrl | String | Specifica un URL da utilizzare come icona personalizzata dell'indicatore. Le immagini possono essere in formato PNG, JPEG o GIF, anche se è consigliato il formato PNG. |
useShadow | Boolean | Indica che per l'indicatore deve essere generata un'ombra in base alla regione visibile dell'immagine e alla sua opacità/trasparenza. |
Invio
StaticMap
: questa istanza di mappa, per l'accodamento.
Vedi anche
setFormat(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 . |
Invio
StaticMap
: questa istanza di mappa, per l'accodamento.
Vedi anche
setLanguage(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. |
Invio
StaticMap
: questa istanza di mappa, per l'accodamento.
Vedi anche
setMapType(mapType)
setMarkerStyle(size, color, label)
Imposta lo stile dell'indicatore da utilizzare per la creazione di nuovi indicatori. I marker 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 MarkerSize . |
color | String | Una stringa nel formato "0xrrggbb" o un valore costante da Color . |
label | String | Una stringa contenente un singolo carattere A-Z o 0-9. |
Invio
StaticMap
: questa istanza di mappa, per l'accodamento.
Vedi anche
setMobile(useMobileTiles)
Imposta se utilizzare o meno insiemi 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 |
---|---|---|
useMobileTiles | Boolean | Indica se utilizzare o meno riquadri mobili. |
Invio
StaticMap
: questa istanza di mappa, per l'accodamento.
setPathStyle(weight, color, fillColor)
Imposta lo stile del percorso da utilizzare per la creazione di 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 da
Color . |
fillColor | String | Il colore di riempimento, una stringa nel formato "0xrrggbb" o un valore costante di
Color . |
Invio
StaticMap
: questa istanza di mappa, per l'accodamento.
Vedi anche
setSize(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. |
Invio
StaticMap
: questa istanza di mappa, per l'accodamento.
Vedi anche
setZoom(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 zero e 21, inclusi. |
Invio
StaticMap
: questa istanza di mappa, per l'accodamento.