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

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 (lat/lng).
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 (lat/lng) alla definizione del percorso corrente.
addVisible(latitude, longitude)StaticMapAggiunge un punto (lat/lng) posizione che deve essere visibile sulla mappa.
addVisible(address)StaticMapAggiunge una posizione dell'indirizzo che deve essere visibile sulla mappa.
beginPath()StaticMapAvvia una nuova definizione del percorso.
clearMarkers()StaticMapCancella l'insieme di indicatori corrente.
clearPaths()StaticMapCancella l'insieme di percorsi corrente.
clearVisibles()StaticMapCancella l'insieme di posizioni visibili corrente.
endPath()StaticMapCompleta una definizione del percorso iniziata con startPath().
getAs(contentType)BlobRestituisce i dati all'interno di questo oggetto come blob convertito nel tipo di contenuto specificato.
getBlob()BlobRecupera i dati immagine come Blob.
getMapImage()Byte[]Ottiene i dati di immagine non elaborati come un array di byte.
getMapUrl()StringOttiene l'URL dell'immagine della mappa.
setCenter(latitude, longitude)StaticMapConsente di impostare il centro della mappa utilizzando un punto (lat/lng).
setCenter(address)StaticMapImposta il centro della mappa utilizzando un indirizzo.
setCustomMarkerStyle(imageUrl, useShadow)StaticMapConsente di impostare l'immagine dell'indicatore personalizzato da utilizzare per la creazione di nuovi indicatori.
setFormat(format)StaticMapConsente di impostare il formato dell'immagine della mappa.
setLanguage(language)StaticMapImposta la lingua da utilizzare per il testo sulla mappa (dove disponibile).
setMapType(mapType)StaticMapConsente di impostare il tipo di mappa da visualizzare.
setMarkerStyle(size, color, label)StaticMapConsente di impostare lo stile degli indicatori da utilizzare per la creazione di nuovi indicatori.
setMobile(useMobileTiles)StaticMapConsente di impostare se utilizzare o meno insiemi di riquadri specializzati per i dispositivi mobili.
setPathStyle(weight, color, fillColor)StaticMapImposta lo stile del percorso da utilizzare quando si creano nuovi percorsi.
setSize(width, height)StaticMapConsente di impostare la larghezza e l'altezza dell'immagine della mappa in pixel.
setZoom(zoom)StaticMapConsente 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

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

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

NomeTipoDescrizione
addressStringL'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

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

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

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

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

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

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

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

NomeTipoDescrizione
addressStringL'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

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

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

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

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

NomeTipoDescrizione
sizeStringUn valore costante da MarkerSize.
colorStringUna stringa nel formato "0xrrggbb" o un valore costante da Color.
labelStringUna 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

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

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

NomeTipoDescrizione
widthIntegerLa larghezza dell'immagine in pixel.
heightIntegerL'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

NomeTipoDescrizione
zoomIntegerUn valore compreso tra 0 e 21 inclusi.

Invio

StaticMap - Questa istanza della mappa, per il concatenamento.

Vedi anche