Permite crear y decorar imágenes de mapas estáticas.
En el siguiente ejemplo, se muestra cómo puedes usar esta clase para crear un mapa del distrito Theatre de la ciudad de Nueva York, 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é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 con un punto (lat/long). |
addMarker(address) | StaticMap | Agrega un marcador al mapa con una dirección. |
addPath(points) | StaticMap | Agrega una ruta al mapa usando un array de puntos. |
addPath(polyline) | StaticMap | Agrega una ruta al mapa usando una polilínea codificada. |
addPoint(latitude, longitude) | StaticMap | Agrega un nuevo punto (lat/long) a la definición de la ruta actual. |
addVisible(latitude, longitude) | StaticMap | Agrega una ubicación de punto (lat/long) que debe ser 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 nueva definición de ruta de acceso. |
clearMarkers() | StaticMap | Borra el conjunto actual de marcadores. |
clearPaths() | StaticMap | Borra el conjunto actual de rutas. |
clearVisibles() | StaticMap | Borra el conjunto actual de ubicaciones visibles. |
endPath() | StaticMap | Completa una definición de ruta de acceso que comenzó 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 un Blob . |
getMapImage() | Byte[] | Obtiene los datos de imagen sin procesar como un array de bytes. |
getMapUrl() | String | Obtiene la URL de la imagen del mapa. |
setCenter(latitude, longitude) | StaticMap | Establece el centro del mapa mediante un punto (lat/long). |
setCenter(address) | StaticMap | Establece el centro del mapa mediante una dirección. |
setCustomMarkerStyle(imageUrl, useShadow) | StaticMap | Establece la imagen de marcador personalizada 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 del 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 o no conjuntos de mosaicos especializados para dispositivos móviles. |
setPathStyle(weight, color, fillColor) | StaticMap | Establece el estilo de ruta que se usará al crear rutas nuevas. |
setSize(width, height) | StaticMap | Establece el ancho y el alto de la imagen del mapa en píxeles. |
setZoom(zoom) | StaticMap | Establece el factor de zoom o 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 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 |
Devolvedor
StaticMap
: Esta instancia de mapa se usa para encadenar.
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
Nombre | Tipo | Descripción |
---|---|---|
latitude | Number | La latitud del nuevo marcador. |
longitude | Number | Es la longitud del marcador nuevo. |
Devolvedor
StaticMap
: Esta instancia de mapa se usa para encadenar.
Consulta también
addMarker(address)
Agrega un marcador al mapa con 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. |
Devolvedor
StaticMap
: Esta instancia de mapa se usa para encadenar.
Consulta también
addPath(points)
Agrega una ruta al mapa usando 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
Nombre | Tipo | Descripción |
---|---|---|
points | Number[] | Un array de pares de latitud y longitud que definen el trazado. |
Devolvedor
StaticMap
: Esta instancia de mapa se usa para encadenar.
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
Nombre | Tipo | Descripción |
---|---|---|
polyline | String | Polilínea codificada |
Devolvedor
StaticMap
: Esta instancia de mapa se usa para encadenar.
addPoint(latitude, longitude)
Agrega un nuevo punto (lat/long) a la definición de la ruta 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 | Es la longitud del punto. |
Devolvedor
StaticMap
: Esta instancia de mapa se usa para encadenar.
addVisible(latitude, longitude)
Agrega una ubicación de punto (lat/long) que debe ser 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 | Es la longitud del punto. |
Devolvedor
StaticMap
: Esta instancia de mapa se usa para encadenar.
Consulta también
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 aparecer en el mapa. |
Devolvedor
StaticMap
: Esta instancia de mapa se usa para encadenar.
Consulta también
beginPath()
Inicia una nueva definición de ruta de acceso. 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. var map = Maps.newStaticMap() .beginPath() .addAddress('New York, NY') .addAddress('Boston, MA') .endPath();
Devolvedor
StaticMap
: Esta instancia de mapa se usa 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();
Devolvedor
StaticMap
: Esta instancia de mapa se usa para encadenar.
clearPaths()
Borra el conjunto actual de rutas.
var map = Maps.newStaticMap(); // ... // Do something interesting here ... // ... // Remove all paths on the map. map.clearPaths();
Devolvedor
StaticMap
: Esta instancia de mapa se usa 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();
Devolvedor
StaticMap
: Esta instancia de mapa se usa para encadenar.
endPath()
Completa una definición de ruta de acceso que comenzó 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();
Devolvedor
StaticMap
: Esta instancia de mapa se usa 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 de archivo, por ejemplo, “myfile.pdf”. Sin embargo, se supone que la parte del nombre de archivo que sigue al último punto (si existe) es una extensión existente que se debe reemplazar. En consecuencia, “ShoppingList.12.25.2014” se convierte en “ShoppingList.12.25.pdf”.
Para ver las cuotas diarias de las conversiones, consulta Cuotas de los servicios de Google. Los dominios de Google Workspace creados recientemente pueden estar sujetos a cuotas más estrictas de forma temporal.
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. En el caso de las imágenes en formato BMP, GIF, JPEG o PNG, también es válido cualquiera de los valores 'image/bmp' , 'image/gif' , 'image/jpeg' o 'image/png' . |
Devolvedor
Blob
: Son 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.
Devolvedor
Blob
: Es una imagen del mapa en el formato de imagen seleccionado.
getMapImage()
Obtiene los datos de 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. var map = Maps.newStaticMap().setCenter('Times Square, New York, NY'); DocsList.createFile(Utilities.newBlob(map.getMapImage(), 'image/png', 'map.png'));
Devolvedor
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");
Devolvedor
String
: URL: Es la URL de la imagen del mapa.
setCenter(latitude, longitude)
Establece el centro del mapa mediante 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 | Es la longitud del centro. |
Devolvedor
StaticMap
: Esta instancia de mapa se usa para encadenar.
Consulta también
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. |
Devolvedor
StaticMap
: Esta instancia de mapa se usa para encadenar.
Consulta también
setCustomMarkerStyle(imageUrl, useShadow)
Establece la imagen de marcador personalizada que se usará al crear marcadores nuevos. Los marcadores que ya se agregaron no se ven 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 ícono 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/transparencia. |
Devolvedor
StaticMap
: Esta instancia de mapa se usa 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. var map = Maps.newStaticMap().setFormat(Maps.StaticMap.Format.PNG);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
format | String | Un valor constante de Format . |
Devolvedor
StaticMap
: Esta instancia de mapa se usa para encadenar.
Consulta también
setLanguage(language)
Establece el idioma que se utilizará para el texto del 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 | Es un identificador de idioma según la norma BCP-47. |
Devolvedor
StaticMap
: Esta instancia de mapa se usa para encadenar.
Consulta también
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 . |
Devolvedor
StaticMap
: Esta instancia de mapa se usa para encadenar.
Consulta también
setMarkerStyle(size, color, label)
Establece el estilo del marcador que se usará al crear marcadores nuevos. Los marcadores que ya se agregaron no se ven 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 cadena con el formato "0xrrggbb" o un valor constante de Color . |
label | String | Cadena que contiene un solo carácter de la A a la Z o de 0 a 9. |
Devolvedor
StaticMap
: Esta instancia de mapa se usa 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. var map = Maps.newStaticMap().setMobile(true);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
useMobileTiles | Boolean | Indica si se deben usar o no mosaicos para dispositivos móviles. |
Devolvedor
StaticMap
: Esta instancia de mapa se usa para encadenar.
setPathStyle(weight, color, fillColor)
Establece el estilo de ruta que se usará al crear rutas nuevas. Las rutas que ya se agregaron no se verán 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 | El ancho de las líneas en píxeles. |
color | String | Es el color de la línea, como una cadena en formato "0xrrggbb" o un valor constante de Color . |
fillColor | String | Es el color de relleno, una string con el formato "0xrrggbb" o un valor constante de Color . |
Devolvedor
StaticMap
: Esta instancia de mapa se usa para encadenar.
Consulta también
setSize(width, height)
Establece el ancho y el alto 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. |
Devolvedor
StaticMap
: Esta instancia de mapa se usa para encadenar.
Consulta también
setZoom(zoom)
Establece el factor de zoom o 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
Nombre | Tipo | Descripción |
---|---|---|
zoom | Integer | Es un valor de cero a 21 inclusive. |
Devolvedor
StaticMap
: Esta instancia de mapa se usa para encadenar.