Class StaticMap

StaticMap

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

• API di 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 (latitudine/longitudine).
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 (latitudine/longitudine) alla definizione del percorso corrente.
addVisible(latitude, longitude)	StaticMap	Aggiunge una posizione (latitudine/longitudine) che deve essere visibile sulla mappa.
addVisible(address)	StaticMap	Aggiunge una posizione dell'indirizzo che deve essere visibile nella mappa.
beginPath()	StaticMap	Avvia una nuova definizione del percorso.
clearMarkers()	StaticMap	Cancella l'attuale insieme di indicatori.
clearPaths()	StaticMap	Cancella l'attuale insieme di percorsi.
clearVisibles()	StaticMap	Cancella l'insieme attuale di posizioni 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 dell'immagine non elaborati come array di byte.
getMapUrl()	String	Recupera l'URL dell'immagine della mappa.
setCenter(latitude, longitude)	StaticMap	Imposta il centro della mappa utilizzando un punto (latitudine/longitudine).
setCenter(address)	StaticMap	Imposta il centro della mappa utilizzando un indirizzo.
setCustomMarkerStyle(imageUrl, useShadow)	StaticMap	Imposta l'immagine dell'indicatore personalizzato 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 mostrare.
setMarkerStyle(size, color, label)	StaticMap	Imposta lo stile dell'indicatore da utilizzare durante la creazione di nuovi indicatori.
setMobile(useMobileTiles)	StaticMap	Specifica se utilizzare o meno set di riquadri specializzati per i dispositivi mobili.
setPathStyle(weight, color, fillColor)	StaticMap	Imposta lo stile del percorso da utilizzare quando crei 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.

Indietro

StaticMap: questa istanza della mappa, per il concatenamento.

---

addMarker(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

StaticMap: questa istanza della mappa, per il concatenamento.

Vedi anche

• API di Google Static Maps

---

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.

Indietro

StaticMap: questa istanza della mappa, per il concatenamento.

Vedi anche

• API di 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.
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

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.
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

StaticMap: questa istanza della mappa, per il concatenamento.

---

addPoint(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

StaticMap: questa istanza della mappa, per il concatenamento.

---

addVisible(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

StaticMap: questa istanza della mappa, per il concatenamento.

Vedi anche

• API di Google Static Maps

---

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 sulla mappa.

Indietro

StaticMap: questa istanza della mappa, per il concatenamento.

Vedi anche

• API di Google Static Maps

---

beginPath()

Avvia una nuova definizione del 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();

Indietro

StaticMap: questa istanza della mappa, per il concatenamento.

---

clearMarkers()

Cancella l'attuale insieme di indicatori.

const map = Maps.newStaticMap();
// ...
// Do something interesting here ...
// ...
// Remove all markers on the map.
map.clearMarkers();

Indietro

StaticMap: questa istanza della mappa, per il concatenamento.

---

clearPaths()

Cancella l'attuale insieme di percorsi.

const map = Maps.newStaticMap();
// ...
// Do something interesting here ...
// ...
// Remove all paths on the map.
map.clearPaths();

Indietro

StaticMap: questa istanza della mappa, per il concatenamento.

---

clearVisibles()

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

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.
const map = Maps.newStaticMap()
                .beginPath()
                .addAddress('New York, NY')
                .addAddress('Boston, MA')
                .endPath();

Indietro

StaticMap: questa istanza della mappa, per il concatenamento.

---

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, 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
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, 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.

---

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.

Indietro

Blob: un'immagine della mappa nel formato selezionato.

---

getMapImage()

Recupera i dati dell'immagine non elaborati come 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.
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.

---

getMapUrl()

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.

---

setCenter(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

StaticMap: questa istanza della mappa, per il concatenamento.

Vedi anche

• API di Google Static Maps

---

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.

Indietro

StaticMap: questa istanza della mappa, per il concatenamento.

Vedi anche

• API di Google Static Maps

---

setCustomMarkerStyle(imageUrl, useShadow)

Imposta l'immagine dell'indicatore personalizzato da utilizzare durante la creazione di nuovi indicatori. 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
imageUrl	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.
useShadow	Boolean	Indica che l'indicatore deve avere un'ombra generata in base alla regione visibile dell'immagine e alla sua opacità/trasparenza.

Indietro

StaticMap: questa istanza della mappa, per il concatenamento.

Vedi anche

• API di Google Static Maps

---

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.

Indietro

StaticMap: questa istanza della mappa, per il concatenamento.

Vedi anche

• API di 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.
const map = Maps.newStaticMap().setLanguage('fr');

Parametri

Nome	Tipo	Descrizione
language	String	Un identificatore di lingua BCP-47.

Indietro

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 mostrare.

// Creates a satellite map.
const map = Maps.newStaticMap().setMapType(Maps.StaticMap.Type.SATELLITE);

Parametri

Nome	Tipo	Descrizione
mapType	String	Un valore costante da Type.

Indietro

StaticMap: questa istanza della mappa, per il concatenamento.

Vedi anche

• API di Google Static Maps

---

setMarkerStyle(size, color, label)

Imposta lo stile dell'indicatore da utilizzare durante la creazione di nuovi indicatori. 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 MarkerSize.
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

StaticMap: questa istanza della mappa, per il concatenamento.

Vedi anche

• API di Google Static Maps

---

setMobile(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
useMobileTiles	Boolean	Se utilizzare o meno i riquadri per il mobile.

Indietro

StaticMap: questa istanza della mappa, per il concatenamento.

---

setPathStyle(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.
fillColor	String	Il colore di riempimento, una stringa nel formato "0xrrggbb" o un valore costante di Color.

Indietro

StaticMap: questa istanza della mappa, per il concatenamento.

Vedi anche

• API di Google Static Maps

---

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.

Indietro

StaticMap: questa istanza della mappa, per il concatenamento.

Vedi anche

• API di 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.
const map = Maps.newStaticMap().setZoom(10);

Parametri

Nome	Tipo	Descrizione
zoom	Integer	Un valore compreso tra 0 e 21 inclusi.

Indietro

StaticMap: questa istanza della mappa, per il concatenamento.

Vedi anche

• API di Google Static Maps