Class StaticMap

StaticMap

Permite crear y decorar imágenes de mapas estáticos.

En el siguiente ejemplo, se muestra cómo puedes usar esta clase para crear un mapa del distrito teatral de la ciudad de Nueva York, incluidas las estaciones de tren cercanas, y mostrarlo en una app web simple.

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

Consulta también

Métodos

MétodoTipo de datos que se devuelveDescripción breve
addAddress(address)StaticMapAgrega una dirección nueva a la definición de ruta actual.
addMarker(latitude, longitude)StaticMapAgrega un marcador al mapa con un punto (latitud y longitud).
addMarker(address)StaticMapAgrega un marcador al mapa usando una dirección.
addPath(points)StaticMapAgrega una ruta al mapa con un array de puntos.
addPath(polyline)StaticMapAgrega una ruta al mapa con una polilínea codificada.
addPoint(latitude, longitude)StaticMapAgrega un nuevo punto (latitud/longitud) a la definición de ruta actual.
addVisible(latitude, longitude)StaticMapAgrega una ubicación de punto (latitud/longitud) que debe ser visible en el mapa.
addVisible(address)StaticMapAgrega una ubicación de dirección que debe ser visible en el mapa.
beginPath()StaticMapInicia una nueva definición de ruta.
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 se inició con beginPath().
getAs(contentType)BlobDevuelve los datos dentro de este objeto como un blob convertido al tipo de contenido especificado.
getBlob()BlobObtiene los datos de la imagen como un objeto 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 (latitud y longitud).
setCenter(address)StaticMapEstablece el centro del mapa con una dirección.
setCustomMarkerStyle(imageUrl, useShadow)StaticMapEstablece la imagen del marcador personalizado que se usará cuando se creen marcadores nuevos.
setFormat(format)StaticMapEstablece el formato de la imagen del mapa.
setLanguage(language)StaticMapEstablece el idioma que se usará para el texto en el mapa (cuando esté disponible).
setMapType(mapType)StaticMapEstablece el tipo de mapa que se mostrará.
setMarkerStyle(size, color, label)StaticMapEstablece el estilo del marcador que se usará cuando se creen marcadores nuevos.
setMobile(useMobileTiles)StaticMapEstablece si se deben usar o no conjuntos de mosaicos especializados para dispositivos móviles.
setPathStyle(weight, color, fillColor)StaticMapEstablece el estilo de ruta que se usará cuando se creen 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 actual.

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

Parámetros

NombreTipoDescripción
addressStringEs la dirección que se agregará.

Volver

StaticMap: Es esta instancia del mapa, para encadenar.


addMarker(latitude, longitude)

Agrega un marcador al mapa con un punto (latitud y longitud).

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

Parámetros

NombreTipoDescripción
latitudeNumberLatitud del nuevo marcador.
longitudeNumberEs la longitud del marcador nuevo.

Volver

StaticMap: Es esta instancia del mapa, para encadenar.

Consulta también


addMarker(address)

Agrega un marcador al mapa usando una dirección.

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

Parámetros

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

Volver

StaticMap: Es esta instancia del mapa, para encadenar.

Consulta también


addPath(points)

Agrega una ruta al mapa con un array de puntos.

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

Parámetros

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

Volver

StaticMap: Es esta instancia del mapa, para encadenar.


addPath(polyline)

Agrega una ruta al mapa con una polilínea codificada.

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

Parámetros

NombreTipoDescripción
polylineStringEs una polilínea codificada.

Volver

StaticMap: Es esta instancia del mapa, para encadenar.


addPoint(latitude, longitude)

Agrega un nuevo punto (latitud/longitud) a la definición de ruta actual.

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

Parámetros

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

Volver

StaticMap: Es esta instancia del mapa, para encadenar.


addVisible(latitude, longitude)

Agrega una ubicación de punto (latitud/longitud) que debe ser visible en el mapa.

// Creates a map where New York and Boston are visible.
const 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 del mapa, para encadenar.

Consulta también


addVisible(address)

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

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

Parámetros

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

Volver

StaticMap: Es esta instancia del mapa, para encadenar.

Consulta también


beginPath()

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

Volver

StaticMap: Es esta instancia del mapa, para encadenar.


clearMarkers()

Borra el conjunto actual de marcadores.

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

Volver

StaticMap: Es esta instancia del mapa, para encadenar.


clearPaths()

Borra el conjunto actual de rutas.

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

Volver

StaticMap: Es esta instancia del mapa, para encadenar.


clearVisibles()

Borra el conjunto actual de ubicaciones visibles.

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

Volver

StaticMap: Es esta instancia del mapa, para encadenar.


endPath()

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

Volver

StaticMap: Es esta instancia del mapa, para encadenar.


getAs(contentType)

Devuelve 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, "miarchivo.pdf". Sin embargo, supone que la parte del nombre de archivo que sigue al último punto (si hay alguno) es una extensión existente que se debe reemplazar. Por lo tanto, "ShoppingList.12.25.2014" se convierte en "ShoppingList.12.25.pdf".

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

Parámetros

NombreTipoDescripción
contentTypeStringEs el tipo de MIME al que se convertirá el archivo. Para la mayoría de los BLOBs, 'application/pdf' es la única opción válida. Para las imágenes en formato BMP, GIF, JPEG o PNG, también son válidos cualquiera de los valores 'image/bmp', 'image/gif', 'image/jpeg' o 'image/png'. Para un documento de Documentos de Google, 'text/markdown' también es válido.

Volver

Blob: Son los datos como un BLOB.


getBlob()

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

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 simples con otros servicios.

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

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.
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`);

Volver

String: URL de la imagen del mapa.


setCenter(latitude, longitude)

Establece el centro del mapa con un punto (latitud y longitud).

// Creates a map centered on Times Square, using its coordinates.
const 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 del mapa, para encadenar.

Consulta también


setCenter(address)

Establece el centro del mapa con una dirección.

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

Parámetros

NombreTipoDescripción
addressStringDirección del centro

Volver

StaticMap: Es esta instancia del mapa, para encadenar.

Consulta también


setCustomMarkerStyle(imageUrl, useShadow)

Establece la imagen del marcador personalizado que se usará cuando se creen 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".
const map = Maps.newStaticMap().setCustomMarkerStyle(
    'http://www.example.com/marker.png',
    false,
);

Parámetros

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

Volver

StaticMap: Es esta instancia del mapa, para encadenar.

Consulta también


setFormat(format)

Establece el formato de la imagen del mapa.

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

Parámetros

NombreTipoDescripción
formatStringEs un valor constante de Format.

Volver

StaticMap: Es esta instancia del mapa, para encadenar.

Consulta también


setLanguage(language)

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

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

Parámetros

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

Volver

StaticMap: Es esta instancia del mapa, para encadenar.

Consulta también


setMapType(mapType)

Establece el tipo de mapa que se mostrará.

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

Parámetros

NombreTipoDescripción
mapTypeStringEs un valor constante de Type.

Volver

StaticMap: Es esta instancia del mapa, para encadenar.

Consulta también


setMarkerStyle(size, color, label)

Establece el estilo del marcador que se usará cuando se creen 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".
const map = Maps.newStaticMap().setMarkerStyle(
    Maps.StaticMap.MarkerSize.MID,
    Maps.StaticMap.Color.BLACK,
    '1',
);

Parámetros

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

Volver

StaticMap: Es esta instancia del mapa, para encadenar.

Consulta también


setMobile(useMobileTiles)

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

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

Parámetros

NombreTipoDescripción
useMobileTilesBooleanIndica si se deben usar tarjetas para dispositivos móviles.

Volver

StaticMap: Es esta instancia del mapa, para encadenar.


setPathStyle(weight, color, fillColor)

Establece el estilo de ruta que se usará cuando se creen rutas nuevas. Las rutas de acceso 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.
const map = Maps.newStaticMap().setPathStyle(
    1,
    Maps.StaticMap.Color.BLACK,
    'red',
);

Parámetros

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

Volver

StaticMap: Es esta instancia del mapa, para encadenar.

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.
const 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 del mapa, para encadenar.

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

Parámetros

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

Volver

StaticMap: Es esta instancia del mapa, para encadenar.

Consulta también