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

Metodi

MetodoTipo restituitoBreve descrizione
addAddress(address)StaticMapAggiunge un nuovo indirizzo alla definizione del percorso corrente.
addMarker(latitude, longitude)StaticMapAggiunge un indicatore alla mappa utilizzando un punto (latitudine/longitudine).
addMarker(address)StaticMapAggiunge un indicatore alla mappa utilizzando un indirizzo.
addPath(points)StaticMapAggiunge un percorso alla mappa utilizzando un array di punti.
addPath(polyline)StaticMapAggiunge un percorso alla mappa utilizzando una polilinea codificata.
addPoint(latitude, longitude)StaticMapAggiunge un nuovo punto (latitudine/longitudine) alla definizione del percorso corrente.
addVisible(latitude, longitude)StaticMapAggiunge una posizione (latitudine/longitudine) che deve essere visibile sulla mappa.
addVisible(address)StaticMapAggiunge una posizione dell'indirizzo che deve essere visibile nella mappa.
beginPath()StaticMapAvvia una nuova definizione del percorso.
clearMarkers()StaticMapCancella l'attuale insieme di indicatori.
clearPaths()StaticMapCancella l'attuale insieme di percorsi.
clearVisibles()StaticMapCancella l'insieme attuale di posizioni visibili.
endPath()StaticMapCompleta una definizione di percorso iniziata con beginPath().
getAs(contentType)BlobRestituisce i dati all'interno di questo oggetto come blob convertito nel tipo di contenuti specificato.
getBlob()BlobRecupera i dati dell'immagine come Blob.
getMapImage()Byte[]Recupera i dati dell'immagine non elaborata come array di byte.
getMapUrl()StringRecupera l'URL dell'immagine della mappa.
setCenter(latitude, longitude)StaticMapImposta il centro della mappa utilizzando un punto (latitudine/longitudine).
setCenter(address)StaticMapImposta il centro della mappa utilizzando un indirizzo.
setCustomMarkerStyle(imageUrl, useShadow)StaticMapImposta l'immagine del marcatore personalizzato da utilizzare durante la creazione di nuovi marcatori.
setFormat(format)StaticMapImposta il formato dell'immagine della mappa.
setLanguage(language)StaticMapImposta la lingua da utilizzare per il testo sulla mappa (se disponibile).
setMapType(mapType)StaticMapImposta il tipo di mappa da mostrare.
setMarkerStyle(size, color, label)StaticMapImposta lo stile del marcatore da utilizzare durante la creazione di nuovi marcatori.
setMobile(useMobileTiles)StaticMapSpecifica se utilizzare o meno set di riquadri specializzati per i dispositivi mobili.
setPathStyle(weight, color, fillColor)StaticMapImposta lo stile del percorso da utilizzare quando crei nuovi percorsi.
setSize(width, height)StaticMapImposta la larghezza e l'altezza dell'immagine della mappa in pixel.
setZoom(zoom)StaticMapImposta 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

NomeTipoDescrizione
addressStringUn 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

NomeTipoDescrizione
latitudeNumberLa latitudine del nuovo indicatore.
longitudeNumberLa longitudine del nuovo indicatore.

Indietro

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.
const map = Maps.newStaticMap().addMarker('76 9th Ave, New York NY');

Parametri

NomeTipoDescrizione
addressStringL'indirizzo in cui posizionare il nuovo indicatore.

Indietro

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.
const map = Maps.newStaticMap().addPath([
  40.714353,
  -74.005973,
  42.358431,
  -71.059773,
]);

Parametri

NomeTipoDescrizione
pointsNumber[]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

NomeTipoDescrizione
polylineStringUna 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

NomeTipoDescrizione
latitudeNumberLa latitudine del punto.
longitudeNumberLa 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

NomeTipoDescrizione
latitudeNumberLa latitudine del punto.
longitudeNumberLa longitudine del punto.

Indietro

StaticMap: questa istanza della mappa, per il concatenamento.

Vedi anche


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

NomeTipoDescrizione
addressStringUn indirizzo che deve essere visibile sulla mappa.

Indietro

StaticMap: questa istanza della mappa, per il concatenamento.

Vedi anche


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

NomeTipoDescrizione
contentTypeStringIl 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

NomeTipoDescrizione
latitudeNumberLa latitudine del centro.
longitudeNumberLa longitudine del centro.

Indietro

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.
const map = Maps.newStaticMap().setCenter('Times Square, New York, NY');

Parametri

NomeTipoDescrizione
addressStringL'indirizzo del centro.

Indietro

StaticMap: questa istanza della mappa, per il concatenamento.

Vedi anche


setCustomMarkerStyle(imageUrl, useShadow)

Imposta l'immagine del marcatore personalizzato da utilizzare durante la creazione di nuovi marcatori. 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

NomeTipoDescrizione
imageUrlStringSpecifica 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.
useShadowBooleanIndica 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


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

NomeTipoDescrizione
formatStringUn valore costante da Format.

Indietro

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

Parametri

NomeTipoDescrizione
languageStringUn identificatore di lingua BCP-47.

Indietro

StaticMap: questa istanza della mappa, per il concatenamento.

Vedi anche


setMapType(mapType)

Imposta il tipo di mappa da mostrare.

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

Parametri

NomeTipoDescrizione
mapTypeStringUn valore costante da Type.

Indietro

StaticMap: questa istanza della mappa, per il concatenamento.

Vedi anche


setMarkerStyle(size, color, label)

Imposta lo stile del marcatore da utilizzare durante la creazione di nuovi marcatori. 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

NomeTipoDescrizione
sizeStringUn valore costante da MarkerSize.
colorStringUna stringa nel formato "0xrrggbb" o un valore costante di Color.
labelStringUna stringa contenente un singolo carattere A-Z o 0-9.

Indietro

StaticMap: questa istanza della mappa, per il concatenamento.

Vedi anche


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

NomeTipoDescrizione
useMobileTilesBooleanSe 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

NomeTipoDescrizione
weightIntegerLa larghezza delle linee in pixel.
colorStringIl colore della linea, come stringa nel formato "0xrrggbb" o un valore costante di Color.
fillColorStringIl 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


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

NomeTipoDescrizione
widthIntegerLa larghezza dell'immagine in pixel.
heightIntegerL'altezza dell'immagine in pixel.

Indietro

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

Parametri

NomeTipoDescrizione
zoomIntegerUn valore compreso tra 0 e 21 inclusi.

Indietro

StaticMap: questa istanza della mappa, per il concatenamento.

Vedi anche