Class StaticMap

StaticMap

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

• API Google Maps Static

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

• API Google Maps Static

---

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

• API Google Maps Static

---

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

• API Google Maps Static

---

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

• API Google Maps Static

---

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

• API Google Maps Static

---

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

• API Google Maps Static

---

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

• API Google Maps Static

---

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

• API Google Maps Static

---

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

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

Invio

StaticMap: questa istanza di mappa, per l'accodamento.

Vedi anche

• API Google Maps Static

---

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

• API Google Maps Static

---

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

• API Google Maps Static

---

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

• API Google Maps Static

---

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.

Vedi anche

• API Google Maps Static