Consente la creazione e la decorazione di immagini di mappe statiche.
L'esempio seguente mostra come utilizzare questa classe per creare una mappa del New York City Theatre District, comprese le stazioni ferroviarie vicine, e mostralo 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 un punto (lat/lng) posizione 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 del percorso. |
clearMarkers() | StaticMap | Cancella l'insieme di indicatori corrente. |
clearPaths() | StaticMap | Cancella l'insieme di percorsi corrente. |
clearVisibles() | StaticMap | Cancella l'insieme di posizioni visibili corrente. |
endPath() | StaticMap | Completa una definizione del percorso iniziata con startPath(). |
getAs(contentType) | Blob | Restituisce i dati all'interno di questo oggetto come blob convertito nel tipo di contenuto specificato. |
getBlob() | Blob | Recupera i dati immagine come Blob . |
getMapImage() | Byte[] | Ottiene i dati di immagine non elaborati come un array di byte. |
getMapUrl() | String | Ottiene 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 personalizzato da utilizzare per la creazione di nuovi indicatori. |
setFormat(format) | StaticMap | Consente di impostare il formato dell'immagine della mappa. |
setLanguage(language) | StaticMap | Imposta la lingua da utilizzare per il testo sulla mappa (dove disponibile). |
setMapType(mapType) | StaticMap | Consente di impostare 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 quando si creano nuovi percorsi. |
setSize(width, height) | StaticMap | Consente di impostare la larghezza e l'altezza dell'immagine della mappa in pixel. |
setZoom(zoom) | StaticMap | Consente di impostare 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. |
Invio
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. |
Invio
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. |
Invio
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. |
Invio
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. |
Invio
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. |
Invio
StaticMap
- Questa istanza della mappa, per il concatenamento.
addVisible(latitude, longitude)
Aggiunge un punto (lat/lng) posizione 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. |
Invio
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. |
Invio
StaticMap
- Questa istanza della mappa, per il concatenamento.
Vedi anche
beginPath()
Avvia una nuova definizione del percorso. Le chiamate a addAddress()
e addPoint()
ne definiscono ciascuna
nuovo vertice del percorso. Il percorso viene 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();
Invio
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();
Invio
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();
Invio
StaticMap
- Questa istanza della mappa, per il concatenamento.
clearVisibles()
Cancella l'insieme di posizioni visibili corrente.
var map = Maps.newStaticMap(); // ... // Do something interesting here ... // ... // Remove all visible locations created with addVisible(). map.clearVisibles();
Invio
StaticMap
- Questa istanza della mappa, per il concatenamento.
endPath()
Completa una definizione del percorso iniziata con startPath().
// 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();
Invio
StaticMap
- Questa istanza della mappa, per il concatenamento.
getAs(contentType)
Restituisce i dati all'interno di questo oggetto come blob convertito nel tipo di contenuto specificato. Questo aggiunge l'estensione appropriata al nome del file, ad esempio "miofile.pdf". Tuttavia, presuppone che la parte del nome file che segue l'ultimo punto (se presente) sia una un'estensione che deve essere sostituita. Di conseguenza, "ShoppingList.25.12.2014" diventa "ShoppingList.12.25.pdf".
Per visualizzare le quote giornaliere per le conversioni, consulta Quote per Google Servizi. I domini Google Workspace appena creati potrebbero essere temporaneamente soggetti a restrizioni quote.
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, vengono visualizzati anche i valori 'image/bmp' , 'image/gif' , 'image/jpeg' o 'image/png'
valida. Per un documento di Documenti Google è valido anche 'text/markdown' . |
Invio
Blob
: i dati come blob.
getBlob()
Recupera i dati 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.
Invio
Blob
: un'immagine della mappa nel formato dell'immagine selezionato.
getMapImage()
Ottiene i dati di immagine non elaborati come un array di byte.
In generale, preferisci utilizzare getBlob()
, che consente interazioni più semplici con altri
i servizi di machine learning.
// 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'));
Invio
Byte[]
: un'immagine della mappa nel formato dell'immagine selezionato.
getMapUrl()
Ottiene 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");
Invio
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 | La latitudine del centro. |
longitude | Number | La longitudine del centro. |
Invio
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. |
Invio
StaticMap
- Questa istanza della mappa, per il concatenamento.
Vedi anche
setCustomMarkerStyle(imageUrl, useShadow)
Consente di impostare l'immagine dell'indicatore personalizzato da utilizzare per la creazione di nuovi indicatori. Indicatori già stati aggiunte non sono interessate.
// 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, sebbene sia consigliato il formato PNG. |
useShadow | Boolean | Indica che l'indicatore deve avere un'ombra generata, in base al regione visibile e la sua opacità/trasparenza. |
Invio
StaticMap
: questa istanza della mappa, per il concatenamento.
Vedi anche
setFormat(format)
Consente di impostare 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 da Format . |
Invio
StaticMap
: questa istanza della mappa, per il concatenamento.
Vedi anche
setLanguage(language)
Imposta la lingua da utilizzare per il testo sulla mappa (dove disponibile).
// Creates a map with the language set to French. var map = Maps.newStaticMap().setLanguage('fr');
Parametri
Nome | Tipo | Descrizione |
---|---|---|
language | String | Un identificatore lingua BCP-47. |
Invio
StaticMap
: questa istanza della mappa, per il concatenamento.
Vedi anche
setMapType(mapType)
Consente di impostare il tipo di mappa da visualizzare.
// Creates a satellite map. var map = Maps.newStaticMap().setMapType(Maps.StaticMap.Type.SATELLITE);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
mapType | String | Un valore costante da Type . |
Invio
StaticMap
: questa istanza della mappa, per il concatenamento.
Vedi anche
setMarkerStyle(size, color, label)
Consente di impostare lo stile degli indicatori da utilizzare per la creazione di nuovi indicatori. 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 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 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 dei dispositivi mobili. |
Invio
StaticMap
: questa istanza della mappa, per il concatenamento.
setPathStyle(weight, color, fillColor)
Imposta lo stile del percorso da utilizzare quando si creano 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 | Lo spessore delle linee in pixel. |
color | String | Il colore della linea, sotto forma di stringa nel formato "0xrrggbb" o un valore costante
Color . |
fillColor | String | Il colore di riempimento, una stringa nel formato "0xrrggbb". o un valore costante
Color . |
Invio
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. |
Invio
StaticMap
- Questa istanza della mappa, per il concatenamento.
Vedi anche
setZoom(zoom)
Consente di impostare 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. |
Invio
StaticMap
: questa istanza della mappa, per il concatenamento.