Class StaticMap

StaticMap

Permite la creación y decoración de imágenes de mapa estáticas.

El siguiente ejemplo muestra cómo puedes usar esta clase para crear un mapa del distrito de los teatros de la ciudad de Nueva York, incluidas las estaciones de tren cercanas, y mostrarlo en una aplicación web simple.

// 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";

Consulta también

• API de Google Static Maps

Métodos

Método	Tipo de datos que se muestra	Descripción breve
addAddress(address)	StaticMap	Agrega una dirección nueva a la definición de la ruta de acceso actual.
addMarker(latitude, longitude)	StaticMap	Agrega un marcador al mapa usando un punto (lat./long).
addMarker(address)	StaticMap	Agrega un marcador al mapa usando una dirección.
addPath(points)	StaticMap	Agrega una ruta de acceso al mapa con un arreglo de puntos.
addPath(polyline)	StaticMap	Agrega una ruta de acceso al mapa mediante una polilínea codificada.
addPoint(latitude, longitude)	StaticMap	Agrega un nuevo punto (lat/lng) a la definición de la ruta de acceso actual.
addVisible(latitude, longitude)	StaticMap	Agrega una ubicación de punto (lat./long.) que debe estar visible en el mapa.
addVisible(address)	StaticMap	Agrega una ubicación de dirección que debe estar visible en el mapa.
beginPath()	StaticMap	Inicia una definición de ruta nueva.
clearMarkers()	StaticMap	Borra el conjunto actual de marcadores.
clearPaths()	StaticMap	Borra el conjunto de rutas actual.
clearVisibles()	StaticMap	Borra el conjunto actual de ubicaciones visibles.
endPath()	StaticMap	Completa una definición de ruta de acceso que comienza con startPath().
getAs(contentType)	Blob	Muestra los datos dentro de este objeto como un BLOB convertido al tipo de contenido especificado.
getBlob()	Blob	Obtiene los datos de la imagen como Blob.
getMapImage()	Byte[]	Obtiene los datos de imagen sin procesar como un arreglo de bytes.
getMapUrl()	String	Obtiene la URL de la imagen del mapa.
setCenter(latitude, longitude)	StaticMap	Establece el centro del mapa con un punto (lat./long.).
setCenter(address)	StaticMap	Establece el centro del mapa mediante una dirección.
setCustomMarkerStyle(imageUrl, useShadow)	StaticMap	Establece la imagen del marcador personalizado que se usará al crear marcadores nuevos.
setFormat(format)	StaticMap	Establece el formato de la imagen del mapa.
setLanguage(language)	StaticMap	Establece el idioma que se utilizará para el texto en el mapa (donde esté disponible).
setMapType(mapType)	StaticMap	Establece el tipo de mapa que se mostrará.
setMarkerStyle(size, color, label)	StaticMap	Establece el estilo del marcador que se usará al crear marcadores nuevos.
setMobile(useMobileTiles)	StaticMap	Establece si se deben usar conjuntos de mosaicos especializados para dispositivos móviles.
setPathStyle(weight, color, fillColor)	StaticMap	Configura el estilo de la ruta que se usará cuando se creen rutas nuevas.
setSize(width, height)	StaticMap	Establece el ancho y la altura de la imagen del mapa en píxeles.
setZoom(zoom)	StaticMap	Establece el factor de zoom, o nivel de ampliación, utilizado para el mapa.

Documentación detallada

addAddress(address)

Agrega una dirección nueva a la definición de la ruta de acceso actual.

// 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();

Parámetros

Nombre	Tipo	Descripción
address	String	Una dirección para agregar.

Volver

StaticMap: Esta instancia de mapa, para encadenar.

---

addMarker(latitude, longitude)

Agrega un marcador al mapa usando un punto (lat./long).

// Creates a map and adds a marker at the specified coordinates.
var map = Maps.newStaticMap().addMarker(40.741799, -74.004207);

Parámetros

Nombre	Tipo	Descripción
latitude	Number	La latitud del nuevo marcador.
longitude	Number	La longitud del nuevo marcador.

Volver

StaticMap: Esta instancia de mapa, para encadenar.

Consulta también

• API de Google Static Maps

---

addMarker(address)

Agrega un marcador al mapa usando una dirección.

// Creates a map and adds a marker at the specified address.
var map = Maps.newStaticMap().addMarker('76 9th Ave, New York NY');

Parámetros

Nombre	Tipo	Descripción
address	String	La dirección en la que se colocará el marcador nuevo

Volver

StaticMap: Esta instancia de mapa, para encadenar.

Consulta también

• API de Google Static Maps

---

addPath(points)

Agrega una ruta de acceso al mapa con un arreglo de puntos.

// 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]);

Parámetros

Nombre	Tipo	Descripción
points	Number[]	Una matriz de pares de latitud y longitud que definen la ruta.

Volver

StaticMap: Esta instancia de mapa, para encadenar.

---

addPath(polyline)

Agrega una ruta de acceso al mapa mediante una polilínea codificada.

// 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);

Parámetros

Nombre	Tipo	Descripción
polyline	String	Una polilínea codificada

Volver

StaticMap: Esta instancia de mapa, para encadenar.

---

addPoint(latitude, longitude)

Agrega un nuevo punto (lat/lng) a la definición de la ruta de acceso actual.

// 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();

Parámetros

Nombre	Tipo	Descripción
latitude	Number	Es la latitud del punto.
longitude	Number	La longitud del punto.

Volver

StaticMap: Esta instancia de mapa, para encadenar.

---

addVisible(latitude, longitude)

Agrega una ubicación de punto (lat./long.) que debe estar visible en el mapa.

// Creates a map where New York and Boston are visible.
var map = Maps.newStaticMap()
    .addVisible(40.714353, -74.005973);
    .addVisible(42.358431, -71.059773)

Parámetros

Nombre	Tipo	Descripción
latitude	Number	Es la latitud del punto.
longitude	Number	La longitud del punto.

Volver

StaticMap: Esta instancia de mapa, para encadenar.

Consulta también

• API de Google Static Maps

---

addVisible(address)

Agrega una ubicación de dirección que debe estar visible en el mapa.

// Creates a map where New York and Boston are visible.
var map = Maps.newStaticMap()
    .addVisible('New York, NY')
    .addVisible('Boston, MA');

Parámetros

Nombre	Tipo	Descripción
address	String	Una dirección que debe estar visible en el mapa.

Volver

StaticMap: Esta instancia de mapa, para encadenar.

Consulta también

• API de Google Static Maps

---

beginPath()

Inicia una definición de ruta nueva. Las llamadas a addAddress() y addPoint() definen cada vértice nuevo en la ruta. La ruta de acceso se completa cuando se llama a 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();

Volver

StaticMap: Esta instancia de mapa, para encadenar.

---

clearMarkers()

Borra el conjunto actual de marcadores.

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

Volver

StaticMap: Esta instancia de mapa, para encadenar.

---

clearPaths()

Borra el conjunto de rutas actual.

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

Volver

StaticMap: Esta instancia de mapa, para encadenar.

---

clearVisibles()

Borra el conjunto actual de ubicaciones visibles.

var map = Maps.newStaticMap();
// ...
// Do something interesting here ...
// ...
// Remove all visible locations created with addVisible().
map.clearVisibles();

Volver

StaticMap: Esta instancia de mapa, para encadenar.

---

endPath()

Completa una definición de ruta de acceso que comienza 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();

Volver

StaticMap: Esta instancia de mapa, para encadenar.

---

getAs(contentType)

Muestra los datos dentro de este objeto como un BLOB convertido al tipo de contenido especificado. Este método agrega la extensión adecuada al nombre del archivo, por ejemplo, &myt.myfile.pdf". Sin embargo, se supone que la parte del nombre de archivo que sigue al último período (si existe) es una extensión existente que se debe reemplazar. En consecuencia, "ShoppingList.15.15.2014" pasa a ser "ShoppingList.12.25.pdf".

Si quieres ver las cuotas diarias para conversiones, consulta Cuotas para servicios de Google. Es posible que los dominios de Google Workspace recién creados estén sujetos a cuotas más estrictas.

Parámetros

Nombre	Tipo	Descripción
contentType	String	El tipo de MIME al que se realizará la conversión. Para la mayoría de los BLOB, 'application/pdf' es la única opción válida. Para imágenes en formato BMP, GIF, JPEG o PNG, también son válidos 'image/bmp', 'image/gif', 'image/jpeg' o 'image/png'.

Volver

Blob: los datos como un BLOB

---

getBlob()

Obtiene los datos de la imagen como 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.

Volver

Blob: Es una imagen del mapa en el formato de imagen seleccionado.

---

getMapImage()

Obtiene los datos de imagen sin procesar como un arreglo de bytes.

En general, se recomienda usar getBlob(), que permite interacciones más simples con otros servicios.

// 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'));

Volver

Byte[]: Es una imagen del mapa en el formato de imagen seleccionado.

---

getMapUrl()

Obtiene la URL de la imagen del mapa.

// 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");

Volver

String: URL de la imagen del mapa.

---

setCenter(latitude, longitude)

Establece el centro del mapa con un punto (lat./long.).

// Creates a map centered on Times Square, using its coordinates.
var map = Maps.newStaticMap().setCenter(40.759011, -73.984472);

Parámetros

Nombre	Tipo	Descripción
latitude	Number	La latitud del centro.
longitude	Number	La longitud del centro.

Volver

StaticMap: Esta instancia de mapa, para encadenar.

Consulta también

• API de Google Static Maps

---

setCenter(address)

Establece el centro del mapa mediante una dirección.

// Creates a map centered on Times Square, using its address.
var map = Maps.newStaticMap().setCenter('Times Square, New York, NY');

Parámetros

Nombre	Tipo	Descripción
address	String	Es la dirección del centro.

Volver

StaticMap: Esta instancia de mapa, para encadenar.

Consulta también

• API de Google Static Maps

---

setCustomMarkerStyle(imageUrl, useShadow)

Establece la imagen del marcador personalizado que se usará al crear marcadores nuevos. Los marcadores que ya se agregaron no se verán afectados.

// 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);

Parámetros

Nombre	Tipo	Descripción
imageUrl	String	Especifica una URL para utilizar como el icono personalizado del marcador. Las imágenes pueden estar en formato PNG, JPEG o GIF, aunque se recomienda PNG.
useShadow	Boolean	Indica que el marcador debe tener una sombra generada, según la región visible de la imagen y su opacidad y transparencia.

Volver

StaticMap: Esta instancia de mapa, para encadenar.

Consulta también

• API de Google Static Maps

---

setFormat(format)

Establece el formato de la imagen del mapa.

// Creates a map with the image format set to PNG.
var map = Maps.newStaticMap().setFormat(Maps.StaticMap.Format.PNG);

Parámetros

Nombre	Tipo	Descripción
format	String	Un valor constante de Format

Volver

StaticMap: Esta instancia de mapa, para encadenar.

Consulta también

• API de Google Static Maps

---

setLanguage(language)

Establece el idioma que se utilizará para el texto en el mapa (donde esté disponible).

// Creates a map with the language set to French.
var map = Maps.newStaticMap().setLanguage('fr');

Parámetros

Nombre	Tipo	Descripción
language	String	Un identificador de idioma BCP-47.

Volver

StaticMap: Esta instancia de mapa, para encadenar.

Consulta también

• Compatibilidad de idiomas en las API de Google Maps

---

setMapType(mapType)

Establece el tipo de mapa que se mostrará.

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

Parámetros

Nombre	Tipo	Descripción
mapType	String	Un valor constante de Type

Volver

StaticMap: Esta instancia de mapa, para encadenar.

Consulta también

• API de Google Static Maps

---

setMarkerStyle(size, color, label)

Establece el estilo del marcador que se usará al crear marcadores nuevos. Los marcadores que ya se agregaron no se verán afectados.

// 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');

Parámetros

Nombre	Tipo	Descripción
size	String	Un valor constante de MarkerSize
color	String	Una string con el formato"0xrrggbb"o un valor constante de Color.
label	String	String que contiene un solo carácter A-Z o 0-9.

Volver

StaticMap: Esta instancia de mapa, para encadenar.

Consulta también

• API de Google Static Maps

---

setMobile(useMobileTiles)

Establece si se deben usar conjuntos de mosaicos especializados para dispositivos móviles.

// Creates a map that uses mobile-friendly tiles.
var map = Maps.newStaticMap().setMobile(true);

Parámetros

Nombre	Tipo	Descripción
useMobileTiles	Boolean	Indica si se deben usar o no mosaicos móviles.

Volver

StaticMap: Esta instancia de mapa, para encadenar.

---

setPathStyle(weight, color, fillColor)

Configura el estilo de la ruta que se usará cuando se creen rutas nuevas. Las rutas que ya se agregaron no se ven afectadas.

// 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');

Parámetros

Nombre	Tipo	Descripción
weight	Integer	Ancho de líneas en píxeles
color	String	El color de línea, como una string en el formato"0xrrggbb"o un valor constante de Color.
fillColor	String	El color de relleno, una string en el formato "0xrrggbb" o un valor constante de Color.

Volver

StaticMap: Esta instancia de mapa, para encadenar.

Consulta también

• API de Google Static Maps

---

setSize(width, height)

Establece el ancho y la altura de la imagen del mapa en píxeles.

// Creates a map 400px wide by 300px high.
var map = Maps.newStaticMap().setSize(400, 300);

Parámetros

Nombre	Tipo	Descripción
width	Integer	El ancho de la imagen en píxeles.
height	Integer	La altura de la imagen en píxeles.

Volver

StaticMap: Esta instancia de mapa, para encadenar.

Consulta también

• API de Google Static Maps

---

setZoom(zoom)

Establece el factor de zoom, o nivel de ampliación, utilizado para el mapa.

// Creates a map with a zoom factor of 10.
var map = Maps.newStaticMap().setZoom(10);

Parámetros

Nombre	Tipo	Descripción
zoom	Integer	Un valor de cero a 21, inclusive.

Volver

StaticMap: Esta instancia de mapa, para encadenar.

Consulta también

• API de Google Static Maps