Permite a criação e decoração de imagens estáticas de mapas.
O exemplo abaixo mostra como você pode usar essa classe para criar um mapa do distrito de teatros de Nova York, incluindo estações de trem próximas, e exibi-lo em um app da Web simples.
// 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";
Veja também
Métodos
Método | Tipo de retorno | Breve descrição |
---|---|---|
addAddress(address) | StaticMap | Adiciona um novo endereço à definição de caminho atual. |
addMarker(latitude, longitude) | StaticMap | Adiciona um marcador ao mapa usando um ponto (lat/lng). |
addMarker(address) | StaticMap | Adiciona um marcador ao mapa usando um endereço. |
addPath(points) | StaticMap | Adiciona um caminho ao mapa usando uma matriz de pontos. |
addPath(polyline) | StaticMap | Adiciona um caminho ao mapa usando uma polilinha codificada. |
addPoint(latitude, longitude) | StaticMap | Adiciona um novo ponto (lat/lng) à definição do caminho atual. |
addVisible(latitude, longitude) | StaticMap | Adiciona um local de ponto (lat/lng) que precisa estar visível no mapa. |
addVisible(address) | StaticMap | Adiciona um endereço que precisa estar visível no mapa. |
beginPath() | StaticMap | Inicia uma nova definição de caminho. |
clearMarkers() | StaticMap | Limpa o conjunto atual de marcadores. |
clearPaths() | StaticMap | Limpa o conjunto atual de caminhos. |
clearVisibles() | StaticMap | Limpa o conjunto atual de locais visíveis. |
endPath() | StaticMap | Completa uma definição de caminho iniciada com beginPath(). |
getAs(contentType) | Blob | Retorne os dados dentro desse objeto como um blob convertido para o tipo de conteúdo especificado. |
getBlob() | Blob | Recebe os dados da imagem como um Blob . |
getMapImage() | Byte[] | Recebe os dados brutos de imagem como uma matriz de bytes. |
getMapUrl() | String | Extrai o URL da imagem do mapa. |
setCenter(latitude, longitude) | StaticMap | Define o centro do mapa usando um ponto (lat/lng). |
setCenter(address) | StaticMap | Define o centro do mapa usando um endereço. |
setCustomMarkerStyle(imageUrl, useShadow) | StaticMap | Define a imagem do marcador personalizado a ser usada para criar novos marcadores. |
setFormat(format) | StaticMap | Define o formato da imagem do mapa. |
setLanguage(language) | StaticMap | Define o idioma a ser usado para texto no mapa (quando disponível). |
setMapType(mapType) | StaticMap | Define o tipo de mapa a ser mostrado. |
setMarkerStyle(size, color, label) | StaticMap | Define o estilo do marcador a ser usado ao criar novos marcadores. |
setMobile(useMobileTiles) | StaticMap | Define se conjuntos de blocos especializados para dispositivos móveis serão usados. |
setPathStyle(weight, color, fillColor) | StaticMap | Define o estilo de caminho a ser usado ao criar novos caminhos. |
setSize(width, height) | StaticMap | Define a largura e a altura da imagem do mapa em pixels. |
setZoom(zoom) | StaticMap | Define o fator de zoom ou nível de ampliação usado para o mapa. |
Documentação detalhada
addAddress(address)
Adiciona um novo endereço à definição de caminho atual.
// 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
Nome | Tipo | Descrição |
---|---|---|
address | String | Um endereço a ser adicionado. |
Retorno
StaticMap
: esta instância de mapa para encadeamento.
addMarker(latitude, longitude)
Adiciona um marcador ao mapa usando um ponto (lat/lng).
// Creates a map and adds a marker at the specified coordinates. var map = Maps.newStaticMap().addMarker(40.741799, -74.004207);
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
latitude | Number | A latitude do novo marcador. |
longitude | Number | A longitude do novo marcador. |
Retorno
StaticMap
: esta instância de mapa para encadeamento.
Veja também
addMarker(address)
Adiciona um marcador ao mapa usando um endereço.
// Creates a map and adds a marker at the specified address. var map = Maps.newStaticMap().addMarker('76 9th Ave, New York NY');
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
address | String | O endereço em que o novo marcador será colocado. |
Retorno
StaticMap
: esta instância de mapa para encadeamento.
Veja também
addPath(points)
Adiciona um caminho ao mapa usando uma matriz de pontos.
// 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
Nome | Tipo | Descrição |
---|---|---|
points | Number[] | Uma matriz de pares de latitude/longitude que definem o caminho. |
Retorno
StaticMap
: esta instância de mapa para encadeamento.
addPath(polyline)
Adiciona um caminho ao mapa usando uma polilinha 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
Nome | Tipo | Descrição |
---|---|---|
polyline | String | Uma polilinha codificada. |
Retorno
StaticMap
: esta instância de mapa para encadeamento.
addPoint(latitude, longitude)
Adiciona um novo ponto (lat/lng) à definição do caminho atual.
// 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
Nome | Tipo | Descrição |
---|---|---|
latitude | Number | A latitude do ponto. |
longitude | Number | A longitude do ponto. |
Retorno
StaticMap
: esta instância de mapa para encadeamento.
addVisible(latitude, longitude)
Adiciona um local de ponto (lat/lng) que precisa estar visível no 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
Nome | Tipo | Descrição |
---|---|---|
latitude | Number | A latitude do ponto. |
longitude | Number | A longitude do ponto. |
Retorno
StaticMap
: esta instância de mapa para encadeamento.
Veja também
addVisible(address)
Adiciona um endereço que precisa estar visível no mapa.
// Creates a map where New York and Boston are visible. var map = Maps.newStaticMap() .addVisible('New York, NY') .addVisible('Boston, MA');
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
address | String | Um endereço que precisa estar visível no mapa. |
Retorno
StaticMap
: esta instância de mapa para encadeamento.
Veja também
beginPath()
Inicia uma nova definição de caminho. As chamadas para addAddress()
e addPoint()
definem cada
novo vértice no caminho. O caminho é concluído quando endPath()
é chamado.
// 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();
Retorno
StaticMap
: esta instância de mapa para encadeamento.
clearMarkers()
Limpa o conjunto atual de marcadores.
var map = Maps.newStaticMap(); // ... // Do something interesting here ... // ... // Remove all markers on the map. map.clearMarkers();
Retorno
StaticMap
: esta instância de mapa para encadeamento.
clearPaths()
Limpa o conjunto atual de caminhos.
var map = Maps.newStaticMap(); // ... // Do something interesting here ... // ... // Remove all paths on the map. map.clearPaths();
Retorno
StaticMap
: esta instância de mapa para encadeamento.
clearVisibles()
Limpa o conjunto atual de locais visíveis.
var map = Maps.newStaticMap(); // ... // Do something interesting here ... // ... // Remove all visible locations created with addVisible(). map.clearVisibles();
Retorno
StaticMap
: esta instância de mapa para encadeamento.
endPath()
Completa uma definição de caminho iniciada com beginPath().
// 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();
Retorno
StaticMap
: esta instância de mapa para encadeamento.
getAs(contentType)
Retorne os dados dentro desse objeto como um blob convertido para o tipo de conteúdo especificado. Esse método adiciona a extensão apropriada ao nome do arquivo, por exemplo, "meuarquivo.pdf". No entanto, ela pressupõe que a parte do nome do arquivo que segue o último ponto (se houver) é uma extensão que precisa ser substituída. Consequentemente, "ShoppingList.12.25.2014" se torna "ShoppingList.12.25.pdf".
Para ver as cotas diárias de conversões, consulte Cotas para Serviços do Google. Os domínios do Google Workspace recém-criados podem estar temporariamente sujeitos a cotas mais rigorosas.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
contentType | String | O tipo MIME para conversão. Para a maioria dos blobs, 'application/pdf' é a única opção válida. Para imagens no formato BMP, GIF, JPEG ou PNG, qualquer elemento 'image/bmp' , 'image/gif' , 'image/jpeg' ou 'image/png' também é
válido. |
Retorno
Blob
: os dados como um blob.
getBlob()
Recebe os dados da imagem como um 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.
Retorno
Blob
: uma imagem do mapa no formato selecionado.
getMapImage()
Recebe os dados brutos de imagem como uma matriz de bytes.
Em geral, prefira usar getBlob()
, que permite interações mais simples com outros
serviços.
// 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'));
Retorno
Byte[]
: uma imagem do mapa no formato selecionado.
getMapUrl()
Extrai o URL da imagem do 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");
Retorno
String
: URL da imagem do mapa.
setCenter(latitude, longitude)
Define o centro do mapa usando um ponto (lat/lng).
// Creates a map centered on Times Square, using its coordinates. var map = Maps.newStaticMap().setCenter(40.759011, -73.984472);
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
latitude | Number | A latitude do centro. |
longitude | Number | A longitude do centro. |
Retorno
StaticMap
: esta instância de mapa para encadeamento.
Veja também
setCenter(address)
Define o centro do mapa usando um endereço.
// Creates a map centered on Times Square, using its address. var map = Maps.newStaticMap().setCenter('Times Square, New York, NY');
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
address | String | O endereço do centro. |
Retorno
StaticMap
: esta instância de mapa para encadeamento.
Veja também
setCustomMarkerStyle(imageUrl, useShadow)
Define a imagem do marcador personalizado a ser usada para criar novos marcadores. Os marcadores que já foram adicionados não são afetados.
// 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
Nome | Tipo | Descrição |
---|---|---|
imageUrl | String | Especifica um URL a ser usado como o ícone personalizado do marcador. As imagens podem estar nos formatos PNG, JPEG ou GIF, embora PNG seja o recomendado. |
useShadow | Boolean | Indica que o marcador precisa ter uma sombra gerada com base na região visível da imagem e na opacidade/transparência dela. |
Retorno
StaticMap
: esta instância de mapa para encadeamento.
Veja também
setFormat(format)
setLanguage(language)
Define o idioma a ser usado para texto no mapa (quando disponível).
// Creates a map with the language set to French. var map = Maps.newStaticMap().setLanguage('fr');
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
language | String | Identificador de idioma BCP-47. |
Retorno
StaticMap
: esta instância de mapa para encadeamento.
Veja também
setMapType(mapType)
setMarkerStyle(size, color, label)
Define o estilo do marcador a ser usado ao criar novos marcadores. Os marcadores que já foram adicionados não são afetados.
// 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
Nome | Tipo | Descrição |
---|---|---|
size | String | Um valor constante de MarkerSize . |
color | String | Uma string no formato "0xrrggbb" ou um valor constante de Color . |
label | String | String com um único caractere de A a Z ou de 0 a 9. |
Retorno
StaticMap
: esta instância de mapa para encadeamento.
Veja também
setMobile(useMobileTiles)
Define se conjuntos de blocos especializados para dispositivos móveis serão usados.
// Creates a map that uses mobile-friendly tiles. var map = Maps.newStaticMap().setMobile(true);
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
useMobileTiles | Boolean | Define se os blocos de dispositivos móveis serão usados ou não. |
Retorno
StaticMap
: esta instância de mapa para encadeamento.
setPathStyle(weight, color, fillColor)
Define o estilo de caminho a ser usado ao criar novos caminhos. Os caminhos que já foram adicionados não são afetados.
// 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
Nome | Tipo | Descrição |
---|---|---|
weight | Integer | A largura das linhas em pixels. |
color | String | A cor da linha, como uma string no formato "0xrrggbb" ou um valor constante de
Color . |
fillColor | String | A cor de preenchimento, uma string no formato "0xrrggbb" ou um valor constante de
Color . |
Retorno
StaticMap
: esta instância de mapa para encadeamento.
Veja também
setSize(width, height)
Define a largura e a altura da imagem do mapa em pixels.
// Creates a map 400px wide by 300px high. var map = Maps.newStaticMap().setSize(400, 300);
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
width | Integer | A largura da imagem, em pixels. |
height | Integer | A altura da imagem, em pixels. |
Retorno
StaticMap
: esta instância de mapa para encadeamento.
Veja também
setZoom(zoom)
Define o fator de zoom ou nível de ampliação usado para o mapa.
// Creates a map with a zoom factor of 10. var map = Maps.newStaticMap().setZoom(10);
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
zoom | Integer | Um valor de 0 a 21. |
Retorno
StaticMap
: esta instância de mapa para encadeamento.