Class StaticMap

StaticMap

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

• API Google Static Maps

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

• API Google Static Maps

---

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

• API Google Static Maps

---

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

• API Google Static Maps

---

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

• API Google Static Maps

---

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

• API Google Static Maps

---

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

• API Google Static Maps

---

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

• API Google Static Maps

---

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

• API Google Static Maps

---

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

• Supporto delle lingue nelle API di Google Maps

---

setMapType(mapType)

Imposta 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 di Type.

Ritorni

StaticMap - Questa istanza della mappa, per il concatenamento.

Vedi anche

• API Google Static Maps

---

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

• API Google Static Maps

---

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

• API Google Static Maps

---

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

• API Google Static Maps

---

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.

Vedi anche

• API Google Static Maps