Permite la creación y decoración de 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étodo | Tipo de datos que se muestra | Descripción breve |
---|---|---|
add | Static | Agrega una dirección nueva a la definición de ruta actual. |
add | Static | Agrega un marcador al mapa con un punto (lat/lng). |
add | Static | Agrega un marcador al mapa con una dirección. |
add | Static | Agrega una ruta al mapa con un array de puntos. |
add | Static | Agrega una ruta al mapa con una polilínea codificada. |
add | Static | Agrega un punto nuevo (lat/lng) a la definición de ruta actual. |
add | Static | Agrega una ubicación de punto (lat/lng) que debe ser visible en el mapa. |
add | Static | Agrega una ubicación de dirección que debe ser visible en el mapa. |
begin | Static | Inicia una nueva definición de ruta. |
clear | Static | Borra el conjunto de marcadores actual. |
clear | Static | Borra el conjunto de rutas actual. |
clear | Static | Borra el conjunto actual de ubicaciones visibles. |
end | Static | Completa una definición de ruta de acceso que se inició con beginPath(). |
get | Blob | Muestra los datos dentro de este objeto como un blob convertido al tipo de contenido especificado. |
get | Blob | Obtiene los datos de la imagen como Blob . |
get | Byte[] | Obtiene los datos de imagen sin procesar como un array de bytes. |
get | String | Obtiene la URL de la imagen del mapa. |
set | Static | Establece el centro del mapa con un punto (latitud/longitud). |
set | Static | Establece el centro del mapa con una dirección. |
set | Static | Establece la imagen de marcador personalizado que se usará cuando se creen marcadores nuevos. |
set | Static | Establece el formato de la imagen del mapa. |
set | Static | Establece el idioma que se usará para el texto en el mapa (si está disponible). |
set | Static | Establece el tipo de mapa que se mostrará. |
set | Static | Establece el estilo de marcador que se usará cuando se creen marcadores nuevos. |
set | Static | Establece si se deben usar o no conjuntos de tarjetas especializadas para dispositivos móviles. |
set | Static | Establece el estilo de ruta que se usará cuando se creen rutas nuevas. |
set | Static | Establece el ancho y la altura de la imagen del mapa en píxeles. |
set | Static | Establece el factor de zoom, o nivel de ampliación, que se usa para el mapa. |
Documentación detallada
add Address(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
Nombre | Tipo | Descripción |
---|---|---|
address | String | Una dirección para agregar. |
Volver
Static
: Es la instancia de este mapa para encadenar.
add Marker(latitude, longitude)
Agrega un marcador al mapa con un punto (lat/lng).
// Creates a map and adds a marker at the specified coordinates. const 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 marcador nuevo. |
Volver
Static
: Es la instancia de este mapa para encadenar.
Consulta también
add Marker(address)
Agrega un marcador al mapa con 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
Nombre | Tipo | Descripción |
---|---|---|
address | String | Es la dirección en la que se colocará el nuevo marcador. |
Volver
Static
: Es la instancia de este mapa para encadenar.
Consulta también
add Path(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
Nombre | Tipo | Descripción |
---|---|---|
points | Number[] | Es un array de pares de latitud y longitud que definen la ruta. |
Volver
Static
: Es la instancia de mapa para encadenar.
add Path(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
Nombre | Tipo | Descripción |
---|---|---|
polyline | String | Es una polilínea codificada. |
Volver
Static
: Es la instancia de mapa para encadenar.
add Point(latitude, longitude)
Agrega un punto nuevo (lat/lng) 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
Nombre | Tipo | Descripción |
---|---|---|
latitude | Number | Es la latitud del punto. |
longitude | Number | Es la longitud del punto. |
Volver
Static
: Es la instancia de mapa para encadenar.
add Visible(latitude, longitude)
Agrega una ubicación de punto (lat/lng) 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
Nombre | Tipo | Descripción |
---|---|---|
latitude | Number | Es la latitud del punto. |
longitude | Number | Es la longitud del punto. |
Volver
Static
: Es la instancia de este mapa para encadenar.
Consulta también
add Visible(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
Nombre | Tipo | Descripción |
---|---|---|
address | String | Es una dirección que debe ser visible en el mapa. |
Volver
Static
: Es la instancia de mapa para encadenar.
Consulta también
begin Path()
Inicia una nueva definición de ruta. Las llamadas a add
y add
definen cada vértice nuevo en la ruta. La ruta se completa cuando se llama a end
.
// 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
Static
: Es la instancia de este mapa para encadenar.
clear Markers()
Borra el conjunto de marcadores actual.
const map = Maps.newStaticMap(); // ... // Do something interesting here ... // ... // Remove all markers on the map. map.clearMarkers();
Volver
Static
: Es la instancia de este mapa para encadenar.
clear Paths()
Borra el conjunto de rutas actual.
const map = Maps.newStaticMap(); // ... // Do something interesting here ... // ... // Remove all paths on the map. map.clearPaths();
Volver
Static
: Es la instancia de este mapa para encadenar.
clear Visibles()
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
Static
: Es la instancia de mapa para encadenar.
end Path()
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
Static
: Es la instancia de mapa para encadenar.
get As(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, "miarchivo.pdf". Sin embargo, se da por sentado que la parte del nombre de archivo que sigue al último punto (si corresponde) 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 de 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
Nombre | Tipo | Descripción |
---|---|---|
content | String | Es el tipo de MIME al que se debe realizar la conversión. 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 '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
: Los datos como un BLOB.
get Blob()
Obtiene los datos de la imagen como 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.
get Map Image()
Obtiene los datos de imagen sin procesar como un array de bytes.
En general, se prefiere usar get
, 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.
get Map Url()
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
: Es la URL de la imagen del mapa.
set Center(latitude, longitude)
Establece el centro del mapa con un punto (latitud/longitud).
// Creates a map centered on Times Square, using its coordinates. const map = Maps.newStaticMap().setCenter(40.759011, -73.984472);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
latitude | Number | Es la latitud del centro. |
longitude | Number | Es la longitud del centro. |
Volver
Static
: Es la instancia de este mapa para encadenar.
Consulta también
set Center(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
Nombre | Tipo | Descripción |
---|---|---|
address | String | La dirección del centro |
Volver
Static
: Es la instancia de este mapa para encadenar.
Consulta también
set Custom Marker Style(imageUrl, useShadow)
Establece la imagen de 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
Nombre | Tipo | Descripción |
---|---|---|
image | String | Especifica una URL para usar como el ícono personalizado del marcador. Las imágenes pueden tener formato PNG, JPEG o GIF, aunque se recomienda PNG. |
use | Boolean | Indica que se debe generar una sombra para el marcador, según la región visible de la imagen y su opacidad o transparencia. |
Volver
Static
: Es la instancia de mapa para encadenar.
Consulta también
set Format(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
Nombre | Tipo | Descripción |
---|---|---|
format | String | Un valor constante de Format . |
Volver
Static
: Es la instancia de este mapa para encadenar.
Consulta también
set Language(language)
Establece el idioma que se usará para el texto en el mapa (si está disponible).
// Creates a map with the language set to French. const map = Maps.newStaticMap().setLanguage('fr');
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
language | String | Un identificador de idioma BCP-47. |
Volver
Static
: Es la instancia de este mapa para encadenar.
Consulta también
set Map Type(mapType)
set Marker Style(size, color, label)
Establece el estilo de 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
Nombre | Tipo | Descripción |
---|---|---|
size | String | Un valor constante de Marker . |
color | String | Es una cadena con el formato "0xrrggbb" o un valor constante de Color . |
label | String | Es una cadena que contiene un solo carácter de A a Z o de 0 a 9. |
Volver
Static
: Es la instancia de este mapa para encadenar.
Consulta también
set Mobile(useMobileTiles)
Establece si se deben usar o no conjuntos de tarjetas especializadas para dispositivos móviles.
// Creates a map that uses mobile-friendly tiles. const map = Maps.newStaticMap().setMobile(true);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
use | Boolean | Si se usarán tarjetas para dispositivos móviles o no. |
Volver
Static
: Es la instancia de mapa para encadenar.
set Path Style(weight, color, fillColor)
Establece el estilo de ruta que se usará cuando se creen 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. const map = Maps.newStaticMap().setPathStyle( 1, Maps.StaticMap.Color.BLACK, 'red', );
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
weight | Integer | Es el ancho de las líneas en píxeles. |
color | String | Es el color de la línea, como una cadena en el formato "0xrrggbb" o un valor constante de Color . |
fill | String | El color de relleno, una cadena con el formato "0xrrggbb" o un valor constante de Color . |
Volver
Static
: Es la instancia de este mapa para encadenar.
Consulta también
set Size(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
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
Static
: Es la instancia de mapa para encadenar.
Consulta también
set Zoom(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. const map = Maps.newStaticMap().setZoom(10);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
zoom | Integer | Un valor de cero a 21 inclusive. |
Volver
Static
: Es la instancia de este mapa para encadenar.