Class StaticMap

StaticMap

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

En el siguiente ejemplo, se muestra cómo puedes usar esta clase para crear un mapa del New York City's Theatre. Distrito, incluidas las estaciones de tren cercanas, y mostrarlo en una app web sencilla.

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

Métodos

MétodoTipo de datos que se muestraDescripción breve
addAddress(address)StaticMapAgrega una dirección nueva a la definición de ruta de acceso actual.
addMarker(latitude, longitude)StaticMapAgrega un marcador al mapa con un punto (lat/long).
addMarker(address)StaticMapAgrega un marcador al mapa mediante una dirección.
addPath(points)StaticMapAgrega una ruta al mapa mediante un array de puntos.
addPath(polyline)StaticMapAgrega una ruta al mapa usando una polilínea codificada.
addPoint(latitude, longitude)StaticMapAgrega un punto nuevo (lat/long) a la definición de la ruta de acceso actual.
addVisible(latitude, longitude)StaticMapAgrega una ubicación de un punto (lat./long.) que debe estar visible en el mapa.
addVisible(address)StaticMapAgrega la ubicación de una dirección que debe ser visible en el mapa.
beginPath()StaticMapInicia una definición de ruta nueva.
clearMarkers()StaticMapBorra el conjunto actual de marcadores.
clearPaths()StaticMapBorra el conjunto actual de rutas.
clearVisibles()StaticMapBorra el conjunto actual de ubicaciones visibles.
endPath()StaticMapCompleta una definición de ruta de acceso que comienza con startPath().
getAs(contentType)BlobMuestra los datos dentro de este objeto como un BLOB convertido al tipo de contenido especificado.
getBlob()BlobObtiene los datos de la imagen como un Blob.
getMapImage()Byte[]Obtiene los datos de la imagen sin procesar como un array de bytes.
getMapUrl()StringObtiene la URL de la imagen del mapa.
setCenter(latitude, longitude)StaticMapEstablece el centro del mapa con un punto (lat./long).
setCenter(address)StaticMapEstablece el centro del mapa con una dirección.
setCustomMarkerStyle(imageUrl, useShadow)StaticMapEstablece la imagen del marcador personalizada que se usará al crear marcadores nuevos.
setFormat(format)StaticMapEstablece el formato de la imagen del mapa.
setLanguage(language)StaticMapEstablece el idioma que se utilizará para el texto en el mapa (donde está disponible).
setMapType(mapType)StaticMapConfigura el tipo de mapa que se mostrará.
setMarkerStyle(size, color, label)StaticMapEstablece el estilo de marcador que se usará al crear marcadores nuevos.
setMobile(useMobileTiles)StaticMapEstablece si se usarán o no conjuntos de tarjetas especializados para dispositivos móviles.
setPathStyle(weight, color, fillColor)StaticMapEstablece el estilo de ruta que se debe usar al crear rutas nuevas.
setSize(width, height)StaticMapEstablece el ancho y la altura de la imagen del mapa en píxeles.
setZoom(zoom)StaticMapEstablece el factor de zoom, o el nivel de ampliación, que se usa para el mapa.

Documentación detallada

addAddress(address)

Agrega una dirección nueva a la definición de 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

NombreTipoDescripción
addressStringUna dirección para agregar

Volver

StaticMap: Es esta instancia de mapa para el encadenamiento.


addMarker(latitude, longitude)

Agrega un marcador al mapa con 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

NombreTipoDescripción
latitudeNumberLa latitud del marcador nuevo.
longitudeNumberEs la longitud del marcador nuevo.

Volver

StaticMap: Es esta instancia de mapa para el encadenamiento.

Consulta también


addMarker(address)

Agrega un marcador al mapa mediante 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

NombreTipoDescripción
addressStringEs la dirección en la que se colocará el marcador nuevo.

Volver

StaticMap: Es esta instancia de mapa para el encadenamiento.

Consulta también


addPath(points)

Agrega una ruta al mapa mediante un array 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

NombreTipoDescripción
pointsNumber[]Array de pares de latitud y longitud que definen la ruta.

Volver

StaticMap: Es esta instancia de mapa para el encadenamiento.


addPath(polyline)

Agrega una ruta al mapa usando 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

NombreTipoDescripción
polylineStringUna polilínea codificada

Volver

StaticMap: Es esta instancia de mapa para el encadenamiento.


addPoint(latitude, longitude)

Agrega un punto nuevo (lat/long) 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

NombreTipoDescripción
latitudeNumberEs la latitud del punto.
longitudeNumberEs la longitud del punto.

Volver

StaticMap: Es esta instancia de mapa para el encadenamiento.


addVisible(latitude, longitude)

Agrega una ubicación de un 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

NombreTipoDescripción
latitudeNumberEs la latitud del punto.
longitudeNumberEs la longitud del punto.

Volver

StaticMap: Es esta instancia de mapa para el encadenamiento.

Consulta también


addVisible(address)

Agrega la ubicación de una dirección que debe ser 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

NombreTipoDescripción
addressStringUna dirección que debe ser visible en el mapa.

Volver

StaticMap: Es esta instancia de mapa para el encadenamiento.

Consulta también


beginPath()

Inicia una definición de ruta nueva. Las llamadas a addAddress() y addPoint() definen cada nuevo vértice en la ruta. La ruta 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: Es esta instancia de mapa para el encadenamiento.


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: Es esta instancia de mapa para el encadenamiento.


clearPaths()

Borra el conjunto actual de rutas.

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

Volver

StaticMap: Es esta instancia de mapa para el encadenamiento.


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: Es esta instancia de mapa para el encadenamiento.


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: Es esta instancia de mapa para el encadenamiento.


getAs(contentType)

Muestra los datos dentro de este objeto como un BLOB convertido al tipo de contenido especificado. Esta agrega la extensión adecuada al nombre del archivo, por ejemplo, "miarchivo.pdf". Sin embargo, supone que la parte del nombre de archivo que sigue al último punto (si corresponde) es una parte extensión que debe reemplazarse. Por lo tanto, "ShoppingList.12.25.2014" se convierte en “ShoppingList.12.25.pdf”.

Para ver las cuotas diarias de las conversiones, consulta Cuotas para Google Servicios Es posible que los dominios de Google Workspace recién creados estén sujetos temporalmente a restricciones y cuotas.

Parámetros

NombreTipoDescripción
contentTypeStringEl tipo de MIME en el que se convertirá. Para la mayoría de los BLOB, 'application/pdf' es la única opción válida. En el caso de las imágenes en formato BMP, GIF, JPEG o PNG, también se aplica cualquiera de los siguientes valores: 'image/bmp', 'image/gif', 'image/jpeg' o 'image/png'. válido. 'text/markdown' también es válido para Documentos de Google.

Volver

Blob: Los datos como un BLOB.


getBlob()

Obtiene los datos de la imagen como un 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 la imagen sin procesar como un array de bytes.

En general, es preferible usar getBlob(), que permite interacciones más sencillas con otros de Google Cloud.

// 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: Es la 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

NombreTipoDescripción
latitudeNumberEs la latitud del centro.
longitudeNumberEs la longitud del centro.

Volver

StaticMap: Es esta instancia de mapa para el encadenamiento.

Consulta también


setCenter(address)

Establece el centro del mapa con 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

NombreTipoDescripción
addressStringEs la dirección del centro.

Volver

StaticMap: Es esta instancia de mapa para el encadenamiento.

Consulta también


setCustomMarkerStyle(imageUrl, useShadow)

Establece la imagen del marcador personalizada que se usará al crear marcadores nuevos. Los marcadores que ya se no se ven afectadas.

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

NombreTipoDescripción
imageUrlStringEspecifica una URL que se usará como el ícono personalizado del marcador. Las imágenes pueden estar en formato PNG o JPEG o GIF, aunque se recomienda PNG.
useShadowBooleanIndica que el marcador debería tener una sombra generada según la imagen región visible y su opacidad/transparencia.

Volver

StaticMap: Es esta instancia de mapa para el encadenamiento.

Consulta también


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

NombreTipoDescripción
formatStringUn valor constante de Format.

Volver

StaticMap: Es esta instancia de mapa para el encadenamiento.

Consulta también


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

NombreTipoDescripción
languageStringEs un identificador de idioma BCP-47.

Volver

StaticMap: Es esta instancia de mapa para el encadenamiento.

Consulta también


setMapType(mapType)

Configura el tipo de mapa que se mostrará.

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

Parámetros

NombreTipoDescripción
mapTypeStringUn valor constante de Type.

Volver

StaticMap: Es esta instancia de mapa para el encadenamiento.

Consulta también


setMarkerStyle(size, color, label)

Establece el estilo de marcador que se usará al crear marcadores nuevos. Marcadores que ya se agregaron no se ven afectadas.

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

NombreTipoDescripción
sizeStringUn valor constante de MarkerSize.
colorStringUna cadena con el formato "0xrrggbb" o un valor constante de Color.
labelStringCadena que contiene un solo carácter de la A a la Z o del 0 al 9.

Volver

StaticMap: Es esta instancia de mapa para el encadenamiento.

Consulta también


setMobile(useMobileTiles)

Establece si se usarán o no conjuntos de tarjetas especializados para dispositivos móviles.

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

Parámetros

NombreTipoDescripción
useMobileTilesBooleanIndica si se deben usar o no mosaicos de dispositivos móviles.

Volver

StaticMap: Es esta instancia de mapa para el encadenamiento.


setPathStyle(weight, color, fillColor)

Establece el estilo de ruta que se debe usar al crear rutas nuevas. Las rutas que ya se agregaron no se afectado.

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

NombreTipoDescripción
weightIntegerEs el ancho de las líneas en píxeles.
colorStringEl color de la línea, como una cadena en el formato "0xrrggbb" o un valor constante de Color
fillColorStringEl color de relleno, una cadena con el formato "0xrrggbb" o un valor constante de Color

Volver

StaticMap: Es esta instancia de mapa para el encadenamiento.

Consulta también


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

NombreTipoDescripción
widthIntegerEl ancho de la imagen en píxeles.
heightIntegerLa altura de la imagen en píxeles.

Volver

StaticMap: Es esta instancia de mapa para el encadenamiento.

Consulta también


setZoom(zoom)

Establece el factor de zoom, o el nivel de ampliación, que se usa para el mapa.

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

Parámetros

NombreTipoDescripción
zoomIntegerEs un valor de cero a 21 inclusive.

Volver

StaticMap: Es esta instancia de mapa para el encadenamiento.

Consulta también