Consente di creare e decorare immagini di mappe statiche.
L'esempio seguente mostra come utilizzare questa classe per creare una mappa del Theatre District di New York City, che includa le stazioni ferroviarie vicine, e visualizzarla in una semplice app web.
// Create a map centered on Times Square. var 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. var 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 (var i = 0; i < corners.length; i++) { map.addAddress(corners[i]); } // All static map URLs require an API key. var 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 di un punto (lat/lng) che deve essere visibile sulla mappa. |
addVisible(address) | StaticMap | Aggiunge una posizione dell'indirizzo che deve essere visibile sulla 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 corrente di posizioni visibili. |
endPath() | StaticMap | Completa una definizione di percorso iniziata con beginPath(). |
getAs(contentType) | Blob | Restituisce i dati all'interno di questo oggetto sotto forma di blob convertito nel tipo di contenuto specificato. |
getBlob() | Blob | Recupera i dati dell'immagine come Blob . |
getMapImage() | Byte[] | Restituisce i dati di immagine non elaborati sotto forma di array di byte. |
getMapUrl() | String | Restituisce l'URL dell'immagine della mappa. |
setCenter(latitude, longitude) | StaticMap | Consente di impostare il centro della mappa utilizzando un punto (lat/lng). |
setCenter(address) | StaticMap | Imposta il centro della mappa utilizzando un indirizzo. |
setCustomMarkerStyle(imageUrl, useShadow) | StaticMap | Consente di impostare l'immagine dell'indicatore personalizzata da utilizzare durante la creazione di 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 visualizzare. |
setMarkerStyle(size, color, label) | StaticMap | Consente di impostare lo stile degli indicatori da utilizzare per la creazione di nuovi indicatori. |
setMobile(useMobileTiles) | StaticMap | Consente di impostare se utilizzare o meno insiemi di riquadri specializzati per i dispositivi mobili. |
setPathStyle(weight, color, fillColor) | StaticMap | Imposta lo stile del percorso da utilizzare durante la creazione di nuovi percorsi. |
setSize(width, height) | StaticMap | Consente di impostare 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. var map = Maps.newStaticMap() .beginPath() .addAddress('New York, NY') .addAddress('Boston, MA') .endPath();
Parametri
Nome | Tipo | Descrizione |
---|---|---|
address | String | Un indirizzo da aggiungere. |
Ritorni
StaticMap
- Questa istanza della mappa, per il concatenamento.
addMarker(latitude, longitude)
Aggiunge un indicatore alla mappa utilizzando un punto (lat/lng).
// Creates a map and adds a marker at the specified coordinates. var 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. |
Ritorni
StaticMap
- Questa istanza della mappa, per il concatenamento.
Vedi anche
addMarker(address)
Aggiunge un indicatore alla mappa utilizzando un indirizzo.
// Creates a map and adds a marker at the specified address. var map = Maps.newStaticMap().addMarker('76 9th Ave, New York NY');
Parametri
Nome | Tipo | Descrizione |
---|---|---|
address | String | L'indirizzo in cui posizionare il nuovo indicatore. |
Ritorni
StaticMap
- Questa istanza della mappa, per il concatenamento.
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. var 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. |
Ritorni
StaticMap
- Questa istanza della mappa, per il concatenamento.
addPath(polyline)
Aggiunge un percorso alla mappa utilizzando una polilinea codificata.
// Creates a map and adds a path from New York to Boston. var polyline = Maps.encodePolyline([40.714353, -74.005973, 42.358431, -71.059773]); var map = Maps.newStaticMap().addPath(polyline);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
polyline | String | Una polilinea codificata. |
Ritorni
StaticMap
- Questa istanza della mappa, per il concatenamento.
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. var 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. |
Ritorni
StaticMap
- Questa istanza della mappa, per il concatenamento.
addVisible(latitude, longitude)
Aggiunge una posizione di un punto (lat/lng) che deve essere visibile sulla mappa.
// Creates a map where New York and Boston are visible. var 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. |
Ritorni
StaticMap
- Questa istanza della mappa, per il concatenamento.
Vedi anche
addVisible(address)
Aggiunge una posizione dell'indirizzo che deve essere visibile sulla mappa.
// Creates a map where New York and Boston are visible. var map = Maps.newStaticMap() .addVisible('New York, NY') .addVisible('Boston, MA');
Parametri
Nome | Tipo | Descrizione |
---|---|---|
address | String | Un indirizzo che deve essere visibile sulla mappa. |
Ritorni
StaticMap
- Questa istanza della mappa, per il concatenamento.
Vedi anche
beginPath()
Avvia una nuova definizione di percorso. Le chiamate a addAddress()
e addPoint()
definiscono ogni nuovo vertice nel percorso. Il percorso è completato quando viene chiamato endPath()
.
// Creates a map and adds a path from New York to Boston. var map = Maps.newStaticMap() .beginPath() .addAddress('New York, NY') .addAddress('Boston, MA') .endPath();
Ritorni
StaticMap
- Questa istanza della mappa, per il concatenamento.
clearMarkers()
Cancella l'insieme di indicatori corrente.
var map = Maps.newStaticMap(); // ... // Do something interesting here ... // ... // Remove all markers on the map. map.clearMarkers();
Ritorni
StaticMap
- Questa istanza della mappa, per il concatenamento.
clearPaths()
Cancella l'insieme di percorsi corrente.
var map = Maps.newStaticMap(); // ... // Do something interesting here ... // ... // Remove all paths on the map. map.clearPaths();
Ritorni
StaticMap
- Questa istanza della mappa, per il concatenamento.
clearVisibles()
Cancella l'insieme corrente di posizioni visibili.
var map = Maps.newStaticMap(); // ... // Do something interesting here ... // ... // Remove all visible locations created with addVisible(). map.clearVisibles();
Ritorni
StaticMap
- Questa istanza della mappa, per il concatenamento.
endPath()
Completa una definizione di percorso iniziata con beginPath().
// Creates a map and adds a path from New York to Boston. var map = Maps.newStaticMap() .beginPath() .addAddress('New York, NY') .addAddress('Boston, MA') .endPath();
Ritorni
StaticMap
- Questa istanza della mappa, per il concatenamento.
getAs(contentType)
Restituisce i dati all'interno di questo oggetto sotto forma di blob convertito nel tipo di contenuto specificato. Questo metodo aggiunge l'estensione appropriata al nome del file, ad esempio "myfile.pdf". Tuttavia, si presuppone che la parte del nome del 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 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, è valido anche qualsiasi formato 'image/bmp' , 'image/gif' , 'image/jpeg' o 'image/png' . |
Ritorni
Blob
: i dati sotto forma di blob.
getBlob()
Recupera i dati dell'immagine come Blob
.
// Creates a map centered on Times Square and saves it to Google Drive. var map = Maps.newStaticMap().setCenter('Times Square, New York, NY'); DocsList.createFile(map); // You can call map.getBlob() explicitly or use it // implicitly by passing the map where a blob is expected.
Ritorni
Blob
: un'immagine della mappa nel formato immagine selezionato.
getMapImage()
Restituisce i dati di immagine non elaborati sotto forma di array di byte.
In generale, è preferibile utilizzare getBlob()
, che consente interazioni più semplici con altri
servizi.
// Creates a map centered on Times Square and saves it to Google Drive. var map = Maps.newStaticMap().setCenter('Times Square, New York, NY'); DocsList.createFile(Utilities.newBlob(map.getMapImage(), 'image/png', 'map.png'));
Ritorni
Byte[]
: un'immagine della mappa nel formato immagine selezionato.
getMapUrl()
Restituisce l'URL dell'immagine della mappa.
// Creates a map centered on Times Square and gets the URL. var 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");
Ritorni
String
- URL: l'URL dell'immagine della mappa.
setCenter(latitude, longitude)
Consente di impostare il centro della mappa utilizzando un punto (lat/lng).
// Creates a map centered on Times Square, using its coordinates. var map = Maps.newStaticMap().setCenter(40.759011, -73.984472);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
latitude | Number | Latitudine del centro. |
longitude | Number | La longitudine del centro. |
Ritorni
StaticMap
- Questa istanza della mappa, per il concatenamento.
Vedi anche
setCenter(address)
Imposta il centro della mappa utilizzando un indirizzo.
// Creates a map centered on Times Square, using its address. var map = Maps.newStaticMap().setCenter('Times Square, New York, NY');
Parametri
Nome | Tipo | Descrizione |
---|---|---|
address | String | L'indirizzo del centro. |
Ritorni
StaticMap
- Questa istanza della mappa, per il concatenamento.
Vedi anche
setCustomMarkerStyle(imageUrl, useShadow)
Consente di impostare l'immagine dell'indicatore personalizzata da utilizzare durante la creazione di nuovi indicatori. Gli indicatori già aggiunti non sono interessati.
// Creates a map with markers set to be medium sized, black, and labeled with the number "1". var 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 si consiglia di usare PNG. |
useShadow | Boolean | Indica che all'indicatore deve essere generata un'ombra, in base alla regione visibile dell'immagine e alla sua opacità/trasparenza. |
Ritorni
StaticMap
- Questa istanza della mappa, per il concatenamento.
Vedi anche
setFormat(format)
Imposta il formato dell'immagine della mappa.
// Creates a map with the image format set to PNG. var map = Maps.newStaticMap().setFormat(Maps.StaticMap.Format.PNG);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
format | String | Un valore costante di Format . |
Ritorni
StaticMap
- Questa istanza della mappa, per il concatenamento.
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. var map = Maps.newStaticMap().setLanguage('fr');
Parametri
Nome | Tipo | Descrizione |
---|---|---|
language | String | Un identificatore della lingua BCP-47. |
Ritorni
StaticMap
- Questa istanza della mappa, per il concatenamento.
Vedi anche
setMapType(mapType)
setMarkerStyle(size, color, label)
Consente di impostare lo stile degli indicatori da utilizzare per la creazione di nuovi indicatori. Gli indicatori già aggiunti non sono interessati.
// Creates a map with markers set to be medium sized, black, and labeled with the number "1". var map = Maps.newStaticMap() .setMarkerStyle(Maps.StaticMap.MarkerSize.MID, Maps.StaticMap.Color.BLACK , '1');
Parametri
Nome | Tipo | Descrizione |
---|---|---|
size | String | Un valore costante di MarkerSize . |
color | String | Una stringa nel formato "0xrrggbb" o un valore costante di Color . |
label | String | Una stringa contenente un carattere singolo A-Z o 0-9. |
Ritorni
StaticMap
- Questa istanza della mappa, per il concatenamento.
Vedi anche
setMobile(useMobileTiles)
Consente di impostare se utilizzare o meno insiemi di riquadri specializzati per i dispositivi mobili.
// Creates a map that uses mobile-friendly tiles. var map = Maps.newStaticMap().setMobile(true);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
useMobileTiles | Boolean | Indica se utilizzare o meno i riquadri per dispositivi mobili. |
Ritorni
StaticMap
- Questa istanza della mappa, per il concatenamento.
setPathStyle(weight, color, fillColor)
Imposta lo stile del percorso da utilizzare durante 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. var 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, sotto forma di stringa nel formato "0xrrggbb" o un valore costante di Color . |
fillColor | String | Il colore di riempimento, una stringa nel formato "0xrrggbb" o un valore costante da Color . |
Ritorni
StaticMap
- Questa istanza della mappa, per il concatenamento.
Vedi anche
setSize(width, height)
Consente di impostare la larghezza e l'altezza dell'immagine della mappa in pixel.
// Creates a map 400px wide by 300px high. var 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. |
Ritorni
StaticMap
- Questa istanza della mappa, per il concatenamento.
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. var map = Maps.newStaticMap().setZoom(10);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
zoom | Integer | Un valore compreso tra 0 e 21 inclusi. |
Ritorni
StaticMap
- Questa istanza della mappa, per il concatenamento.