Maps

Classe MapElement

Classe google.maps.MapElement

MapElement é uma subclasse HTMLElement para renderizar mapas. Depois de carregar a biblioteca maps, um mapa pode ser criado em HTML. Exemplo:

O 
<gmp-map center="37.4220656,-122.0840897" zoom="10" map-id="DEMO_MAP_ID">
  <button slot="control-block-start-inline-end">Custom Control</button>
</gmp-map>
usa internamente o Map, que pode ser acessado com a propriedade MapElement.innerMap.

Elemento personalizado:
<gmp-map center="lat,lng" heading-interaction-disabled internal-usage-attribution-ids="id1 id2" map-id="string" rendering-type="vector" tilt-interaction-disabled zoom="number"></gmp-map>

Essa classe estende HTMLElement.

Essa classe implementa MapElementOptions.

Acesse ligando para const {MapElement} = await google.maps.importLibrary("maps").
Consulte Bibliotecas na API Maps JavaScript.
MapElement
MapElement([options])
Parâmetros:
center
Tipo:LatLng|LatLngLiteral optional
A latitude/longitude central do mapa.
Atributo HTML:
  • <gmp-map center="lat,lng"></gmp-map>
headingInteractionDisabled
Tipo:boolean optional
Padrão:false
Indica se o mapa deve permitir o controle do usuário sobre a rotação da câmera. Essa opção só entra em vigor quando o mapa é vetorial. Se não estiver definido no código, a configuração da nuvem para o ID do mapa será usada (se disponível).
Atributo HTML:
  • <gmp-map heading-interaction-disabled></gmp-map>
innerMap
Tipo:Map
Uma referência ao Map que o MapElement usa internamente.
internalUsageAttributionIds
Tipo:Iterable<string> optional
Padrão:null
Adiciona um ID de atribuição de uso ao inicializador, o que ajuda o Google a entender quais bibliotecas e exemplos são úteis para os desenvolvedores, como o uso de uma biblioteca de clustering de marcadores. Para desativar o envio do ID de atribuição de uso, exclua essa propriedade ou substitua o valor por uma string vazia. Somente valores únicos serão enviados. As mudanças nesse valor após a instanciação podem ser ignoradas.
Atributo HTML:
  • <gmp-map internal-usage-attribution-ids="id1 id2"></gmp-map>
mapId
Tipo:string optional
O ID do mapa. Não é possível definir ou mudar esse parâmetro depois que um mapa é instanciado. O Map.DEMO_MAP_ID pode ser usado para testar recursos que exigem um ID do mapa, mas não precisam ser ativados na nuvem.
Atributo HTML:
  • <gmp-map map-id="string"></gmp-map>
renderingType
Tipo:RenderingType optional
Padrão:RenderingType.VECTOR
Se o mapa deve ser rasterizado ou vetorial. Não é possível definir ou mudar esse parâmetro depois que um mapa é instanciado. Se não estiver definido, a configuração da nuvem para o ID do mapa vai determinar o tipo de renderização (se disponível). Os mapas vetoriais podem não estar disponíveis para todos os dispositivos e navegadores. Se necessário, o mapa será convertido para rasterizado.
Atributo HTML:
  • <gmp-map rendering-type="vector"></gmp-map>
  • <gmp-map rendering-type="raster"></gmp-map>
tiltInteractionDisabled
Tipo:boolean optional
Padrão:false
Indica se o mapa deve permitir o controle do usuário sobre a inclinação da câmera. Essa opção só entra em vigor quando o mapa é vetorial. Se não estiver definido no código, a configuração da nuvem para o ID do mapa será usada (se disponível).
Atributo HTML:
  • <gmp-map tilt-interaction-disabled></gmp-map>
zoom
Tipo:number optional
O nível de zoom do mapa. Os valores de zoom válidos são números de zero até o nível máximo de zoom aceito. Valores de zoom maiores correspondem a uma resolução mais alta.
Atributo HTML:
  • <gmp-map zoom="number"></gmp-map>
control-block-end-inline-center
Coloca o elemento encaixado na posição ControlPosition.BLOCK_END_INLINE_CENTER.
control-block-end-inline-end
Coloca o elemento encaixado na posição ControlPosition.BLOCK_END_INLINE_END.
control-block-end-inline-start
Coloca o elemento encaixado na posição ControlPosition.BLOCK_END_INLINE_START.
control-block-start-inline-center
Coloca o elemento encaixado na posição ControlPosition.BLOCK_START_INLINE_CENTER.
control-block-start-inline-end
Coloca o elemento encaixado na posição ControlPosition.BLOCK_START_INLINE_END.
control-block-start-inline-start
Coloca o elemento encaixado na posição ControlPosition.BLOCK_START_INLINE_START.
control-inline-end-block-center
Coloca o elemento encaixado na posição ControlPosition.INLINE_END_BLOCK_CENTER.
control-inline-end-block-end
Coloca o elemento encaixado na posição ControlPosition.INLINE_END_BLOCK_END.
control-inline-end-block-start
Coloca o elemento encaixado na posição ControlPosition.INLINE_END_BLOCK_START.
control-inline-start-block-center
Coloca o elemento encaixado na posição ControlPosition.INLINE_START_BLOCK_CENTER.
control-inline-start-block-end
Coloca o elemento encaixado na posição ControlPosition.INLINE_START_BLOCK_END.
control-inline-start-block-start
Coloca o elemento encaixado na posição ControlPosition.INLINE_START_BLOCK_START.
default
É possível criar componentes reutilizáveis em torno dos componentes da Web JavaScript do Maps, como AdvancedMarkerElement, usando elementos personalizados. Por padrão, todos os elementos personalizados adicionados diretamente ao MapElement serão inseridos e renderizados em MapPanes.overlayMouseTarget. No entanto, os componentes da Web da API Maps JavaScript podem ser realocados para os slots internos do MapElement.
BetaaddEventListener
addEventListener(type, listener[, options])
Parâmetros:
  • type:  string uma string que diferencia maiúsculas de minúsculas e representa o tipo de evento a ser detectado.
  • listener:  EventListener|EventListenerObject o objeto que recebe uma notificação. Precisa ser uma função ou um objeto com o método handleEvent.
  • options:  boolean|AddEventListenerOptions optional consulte opções. Os eventos personalizados só são compatíveis com capture e passive.
Valor de retorno:void
Configura uma função que será chamada sempre que o evento especificado for entregue ao destino. Consulte addEventListener.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Parâmetros:
  • type:  string uma string que especifica o tipo de evento para o qual um listener de eventos será removido.
  • listener:  EventListener|EventListenerObject o listener de eventos do manipulador de eventos a ser removido do destino do evento.
  • options:  boolean|EventListenerOptions optional consulte opções.
Valor de retorno:void
Remove do destino um listener de eventos registrado anteriormente com addEventListener. Consulte removeEventListener.
gmp-zoomchange
function(event)
Argumentos: 
Este evento é acionado quando a propriedade de zoom do mapa é alterada.

Interface MapElementOptions

Interface google.maps.MapElementOptions

Objeto MapElementOptions usado para definir as propriedades que podem ser definidas em um MapElement.
center optional
Tipo:LatLng|LatLngLiteral optional
Consulte MapElement.center.
headingInteractionDisabled optional
Tipo:boolean optional
Consulte MapElement.headingInteractionDisabled.
internalUsageAttributionIds optional
Tipo:Iterable<string> optional
Consulte MapElement.internalUsageAttributionIds.
mapId optional
Tipo:string optional
Consulte MapElement.mapId.
renderingType optional
Tipo:RenderingType optional
Consulte MapElement.renderingType.
tiltInteractionDisabled optional
Tipo:boolean optional
Consulte MapElement.tiltInteractionDisabled.
zoom optional
Tipo:number optional
Consulte MapElement.zoom.

Classe ZoomChangeEvent

Classe google.maps.ZoomChangeEvent

Esse evento é criado com base na mudança de zoom do monitoramento.

Essa classe estende Event.

Acesse ligando para const {ZoomChangeEvent} = await google.maps.importLibrary("maps").
Consulte Bibliotecas na API Maps JavaScript.

Classe Map

Classe google.maps.Map

Essa classe estende MVCObject.

Acesse ligando para const {Map} = await google.maps.importLibrary("maps").
Consulte Bibliotecas na API Maps JavaScript.
Map
Map(mapDiv[, opts])
Parâmetros:
  • mapDiv:  HTMLElement O mapa será renderizado para preencher esse elemento.
  • opts:  MapOptions optional opções
Cria um novo mapa dentro do contêiner HTML informado, que normalmente é um elemento DIV.
DEMO_MAP_ID ID do mapa que pode ser usado em exemplos de código que exigem um ID de mapa. Esse ID de mapa não foi criado para uso em aplicativos de produção e não pode ser usado em recursos que exigem configuração na nuvem, como a estilização na nuvem.
controls
Controles adicionais a serem anexados ao mapa. Para adicionar um controle ao mapa, inclua o <div> do controle no MVCArray correspondente ao ControlPosition em que ele deve ser renderizado.
data
Tipo:Data
Uma instância de Data vinculada ao mapa. Adicione recursos a esse objeto Data para mostrá-los convenientemente no mapa.
mapTypes
Um registro de instâncias MapType por ID de string.
overlayMapTypes
Tipo:MVCArray<MapType optional>
Tipos de mapa adicionais a serem superpostos. Os tipos de mapa de sobreposição aparecem sobre o mapa base em que estão anexados, na ordem em que aparecem na matriz overlayMapTypes. As sobreposições com valores de índice mais altos aparecem na frente das sobreposições com valores de índice menores.
fitBounds
fitBounds(bounds[, padding])
Parâmetros:
  • bounds:  limites de LatLngBounds|LatLngBoundsLiteral a serem mostrados.
  • padding:  number|Padding optional padding em pixels. Os limites serão ajustados na parte do mapa que permanecer após a remoção do padding. Um valor numérico vai gerar o mesmo padding nos quatro lados. Forneça 0 aqui para tornar um fitBounds idempotente no resultado de getBounds.
Valor de retorno:nenhum
Define a janela de visualização para que contenha os limites fornecidos.
Observação:quando o mapa é definido como display: none, a função fitBounds lê o tamanho do mapa como 0x0 e, portanto, não faz nada. Para mudar a janela de visualização enquanto o mapa está oculto, defina o mapa como visibility: hidden. Assim, a div do mapa terá um tamanho real. Para mapas vetoriais, esse método define a inclinação e o rumo do mapa como os valores padrão zero. Chamar esse método pode causar uma animação suave à medida que o mapa faz uma transição e um zoom para se ajustar aos limites. A animação desse método depende de uma heurística interna.
getBounds
getBounds()
Parâmetros:nenhum
Valor de retorno:LatLngBounds|undefined os limites de latitude/longitude da janela de visualização atual.
Retorna os limites de latitude/longitude da janela de visualização atual. Se mais de uma cópia do mundo estiver visível, o intervalo de limites em longitude será de -180 a 180 graus, inclusive. Se o mapa ainda não tiver sido inicializado ou se o centro e o zoom não tiverem sido definidos, o resultado será undefined. Para mapas vetoriais com inclinação ou orientação diferentes de zero, os limites de latitude/longitude retornados representam a menor caixa delimitadora que inclui a região visível da janela de visualização do mapa. Consulte MapCanvasProjection.getVisibleRegion para saber a região visível exata da janela de visualização do mapa.
getCenter
getCenter()
Parâmetros:nenhum
Valor de retorno:LatLng|undefined
Retorna a posição mostrada no centro do mapa. O objeto LatLng não está encapsulado. Consulte LatLng para saber mais. Se o centro ou os limites não tiverem sido definidos, o resultado será undefined.
getClickableIcons
getClickableIcons()
Parâmetros:nenhum
Valor de retorno:boolean|undefined
Retorna a capacidade de clicar nos ícones do mapa. Um ícone de mapa representa um ponto de interesse, também conhecido como PDI. Se o valor retornado for true, os ícones serão clicáveis no mapa.
BetagetDatasetFeatureLayer
getDatasetFeatureLayer(datasetId)
Parâmetros:
  • datasetId:  string
Valor de retorno:FeatureLayer
Retorna o FeatureLayer do datasetId especificado. Os IDs de conjuntos de dados precisam ser configurados no console do Google Cloud. Se o ID do conjunto de dados não estiver associado ao estilo do mapa ou se o estilo baseado em dados não estiver disponível (sem ID do mapa, sem blocos vetoriais, sem camadas de recursos de estilo baseado em dados ou conjuntos de dados configurados no estilo do mapa), um erro será registrado, e o FeatureLayer.isAvailable resultante será falso.
getDiv
getDiv()
Parâmetros:nenhum
Valor de retorno:HTMLElement o mapDiv do mapa.
getFeatureLayer
getFeatureLayer(featureType)
Parâmetros:
Valor de retorno:FeatureLayer
Retorna o FeatureLayer do FeatureType específico. Um FeatureLayer precisa ser ativado no console do Google Cloud. Se um FeatureLayer do FeatureType especificado não existir no mapa ou se o estilo baseado em dados não estiver disponível (sem ID do mapa, sem blocos vetoriais e sem FeatureLayer ativado no estilo do mapa), isso vai registrar um erro, e o FeatureLayer.isAvailable resultante será falso.
getHeading
getHeading()
Parâmetros:nenhum
Valor de retorno:number|undefined
Retorna a bússola do mapa. O valor da orientação é medido em graus (sentido horário) a partir da direção cardeal norte. Se o mapa ainda não tiver sido inicializado, o resultado será undefined.
getHeadingInteractionEnabled
getHeadingInteractionEnabled()
Parâmetros:nenhum
Valor de retorno:boolean|null
Retorna se as interações de cabeçalho estão ativadas. Essa opção só entra em vigor quando o mapa é vetorial. Se não estiver definido no código, a configuração da nuvem para o ID do mapa será usada (se disponível).
getInternalUsageAttributionIds
getInternalUsageAttributionIds()
Parâmetros:nenhum
Valor de retorno:Iterable<string>|null
Retorna a lista de IDs de atribuição de uso, que ajudam o Google a entender quais bibliotecas e amostras são úteis para os desenvolvedores, como o uso de uma biblioteca de clustering de marcadores.
getMapCapabilities
getMapCapabilities()
Parâmetros:nenhum
Valor de retorno:MapCapabilities
Informa ao caller os recursos disponíveis no mapa com base no ID fornecido.
getMapTypeId
getMapTypeId()
Parâmetros:nenhum
Valor de retorno:MapTypeId|string|undefined
getProjection
getProjection()
Parâmetros:nenhum
Valor de retorno:Projection|undefined
Retorna o Projection atual. Se o mapa ainda não tiver sido inicializado, o resultado será undefined. Detecte o evento projection_changed e verifique o valor dele para garantir que não seja undefined.
getRenderingType
getRenderingType()
Parâmetros:nenhum
Valor de retorno:RenderingType
Retorna o RenderingType atual do mapa.
getStreetView
getStreetView()
Parâmetros:nenhum
Valor de retorno:StreetViewPanorama o panorama vinculado ao mapa.
Retorna o StreetViewPanorama padrão vinculado ao mapa, que pode ser um panorama padrão incorporado ao mapa ou o panorama definido usando setStreetView(). As mudanças no streetViewControl do mapa serão refletidas na exibição de um panorama vinculado.
getTilt
getTilt()
Parâmetros:nenhum
Valor de retorno:number|undefined
Retorna o ângulo de incidência atual do mapa, em graus do plano da janela de visualização para o plano do mapa. Para mapas raster, o resultado será 0 para imagens capturadas diretamente acima ou 45 para imagens em 45°. Esse método não retorna o valor definido por setTilt. Consulte setTilt para mais detalhes.
getTiltInteractionEnabled
getTiltInteractionEnabled()
Parâmetros:nenhum
Valor de retorno:boolean|null
Retorna se as interações de inclinação estão ativadas. Essa opção só entra em vigor quando o mapa é vetorial. Se não estiver definido no código, a configuração da nuvem para o ID do mapa será usada (se disponível).
getZoom
getZoom()
Parâmetros:nenhum
Valor de retorno:number|undefined
Retorna o zoom do mapa. Se o zoom não tiver sido definido, o resultado será undefined.
moveCamera
moveCamera(cameraOptions)
Parâmetros:
Valor de retorno:nenhum
Define imediatamente as opções de câmera de destino para a câmera do mapa, sem animação.
panBy
panBy(x, y)
Parâmetros:
  • x:  number número de pixels para mover o mapa na direção x.
  • y:  number número de pixels para mover o mapa na direção y.
Valor de retorno:nenhum
Altera o centro do mapa de acordo com a distância especificada em pixels. Se a distância for menor do que a largura e a altura do mapa, a transição será animada suavemente. O sistema de coordenadas do mapa aumenta do oeste para o leste (para valores x) e do norte para o sul (para valores y).
panTo
panTo(latLng)
Parâmetros:
Valor de retorno:nenhum
Muda o centro do mapa para o LatLng especificado. Se a alteração for menor do que a largura e a altura do mapa, a transição será animada suavemente.
panToBounds
panToBounds(latLngBounds[, padding])
Parâmetros:
  • latLngBounds:  LatLngBounds|LatLngBoundsLiteral os limites para mover o mapa.
  • padding:  number|Padding optional padding em pixels. Um valor numérico vai gerar o mesmo padding nos quatro lados. O valor padrão é 0.
Valor de retorno:nenhum
Move o mapa pela quantidade mínima necessária para conter o LatLngBounds especificado. Não há garantia de onde os limites vão ficar no mapa, exceto que o mapa será movido para mostrar o máximo possível dos limites dentro de {currentMapSizeInPx} - {padding}. Para mapas rasterizados e vetoriais, o zoom, a inclinação e a direção do mapa não serão alterados.
setCenter
setCenter(latlng)
Parâmetros:
Valor de retorno:nenhum
setClickableIcons
setClickableIcons(value)
Parâmetros:
  • value:  boolean
Valor de retorno:nenhum
Controla se os ícones do mapa são clicáveis ou não. Um ícone de mapa representa um ponto de interesse, também conhecido como PDI. Para desativar a capacidade de clicar nos ícones do mapa, transmita um valor de false para esse método.
setHeading
setHeading(heading)
Parâmetros:
  • heading:  number
Valor de retorno:nenhum
Define a direção da bússola para o mapa, medida em graus a partir da direção cardeal norte. Para mapas rasterizados, esse método só se aplica a imagens aéreas.
setHeadingInteractionEnabled
setHeadingInteractionEnabled(headingInteractionEnabled)
Parâmetros:
  • headingInteractionEnabled:  boolean
Valor de retorno:nenhum
Define se as interações de cabeçalho estão ativadas. Essa opção só entra em vigor quando o mapa é vetorial. Se não estiver definido no código, a configuração da nuvem para o ID do mapa será usada (se disponível).
setMapTypeId
setMapTypeId(mapTypeId)
Parâmetros:
Valor de retorno:nenhum
setOptions
setOptions(options)
Parâmetros:
Valor de retorno:nenhum
setRenderingType
setRenderingType(renderingType)
Parâmetros:
Valor de retorno:nenhum
Define o RenderingType atual do mapa.
setStreetView
setStreetView(panorama)
Parâmetros:
Valor de retorno:nenhum
Vincula um StreetViewPanorama ao mapa. Esse panorama substitui o StreetViewPanorama padrão, permitindo que o mapa seja vinculado a um panorama externo fora dele. Definir o panorama como null vincula o panorama incorporado padrão de volta ao mapa.
setTilt
setTilt(tilt)
Parâmetros:
  • tilt:  number
Valor de retorno:nenhum
Para mapas vetoriais, define o ângulo de incidência do mapa. Os valores permitidos são restritos dependendo do nível de zoom do mapa.

Para mapas rasterizados, controla o comportamento de troca automática do ângulo de incidência do mapa. Os únicos valores permitidos são 0 e 45. setTilt(0) faz com que o mapa sempre use uma visualização aérea de 0°, independente do nível de zoom e da janela de visualização. setTilt(45) faz com que o ângulo de inclinação mude automaticamente para 45 sempre que imagens em 45° estiverem disponíveis para o nível de zoom e a janela de visualização atuais, e volte para 0 quando não estiverem disponíveis (esse é o comportamento padrão). As imagens em 45° estão disponíveis apenas para os tipos de mapa satellite e hybrid, em alguns locais e níveis de zoom. Observação:getTilt retorna o ângulo de inclinação atual, não o valor definido por setTilt. Como getTilt e setTilt se referem a coisas diferentes, não bind() a propriedade tilt. Isso pode gerar efeitos imprevisíveis.
setTiltInteractionEnabled
setTiltInteractionEnabled(tiltInteractionEnabled)
Parâmetros:
  • tiltInteractionEnabled:  boolean
Valor de retorno:nenhum
Define se as interações de inclinação estão ativadas. Essa opção só entra em vigor quando o mapa é vetorial. Se não estiver definido no código, a configuração da nuvem para o ID do mapa será usada (se disponível).
setZoom
setZoom(zoom)
Parâmetros:
  • zoom:  number. Valores de zoom maiores correspondem a uma resolução mais alta.
Valor de retorno:nenhum
Define o zoom do mapa.
Herdado:addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
bounds_changed
function()
Argumentos:  nenhum
Este evento é disparado quando os limites da janela de visualização são alterados.
center_changed
function()
Argumentos:  nenhum
Este evento é disparado quando a propriedade do centro do mapa é alterada.
click
function(event)
Argumentos: 
Esse evento é acionado quando o usuário clica no mapa. Um MapMouseEvent com propriedades para o local clicado é retornado, a menos que um ícone de lugar tenha sido clicado. Nesse caso, um IconMouseEvent com um ID de lugar é retornado. IconMouseEvent e MapMouseEvent são idênticos, exceto que IconMouseEvent tem o campo ID do lugar. O evento sempre pode ser tratado como um MapMouseEvent quando o ID do lugar não é importante. O evento de clique não é disparado se um marcador ou uma janela de informações for clicado.
contextmenu
function(event)
Argumentos: 
Este evento é disparado quando o evento contextmenu do DOM é disparado no recipiente do mapa.
dblclick
function(event)
Argumentos: 
Este evento é disparado quando o usuário clica duas vezes no mapa. Às vezes, o evento de clique é acionado uma vez e, às vezes, duas vezes, logo antes deste.
drag
function()
Argumentos:  nenhum
Este evento é disparado repetidamente enquanto o usuário arrasta o mapa.
dragend
function()
Argumentos:  nenhum
Este evento é acionado quando o usuário para de arrastar o mapa. Observação: o evento "dragend" NÃO é disparado quando o usuário para de mover o mapa usando o teclado. Use o evento Map.idle para determinar quando o usuário parou de movimentar ou arrastar o mapa.
dragstart
function()
Argumentos:  nenhum
Este evento é acionado quando o usuário começa a arrastar o mapa.
heading_changed
function()
Argumentos:  nenhum
Este evento é acionado quando a propriedade de orientação do mapa é alterada.
idle
function()
Argumentos:  nenhum
Este evento é disparado quando o mapa fica inativo após sofrer um deslocamento ou alteração de zoom.
isfractionalzoomenabled_changed
function()
Argumentos:  nenhum
Esse evento é disparado quando a propriedade "isFractionalZoomEnabled" muda.
mapcapabilities_changed
function()
Argumentos:  nenhum
Esse evento é disparado quando as funcionalidades do mapa mudam.
maptypeid_changed
function()
Argumentos:  nenhum
Este evento é disparado quando a propriedade mapTypeId é alterada.
mousemove
function(event)
Argumentos: 
Este evento é disparado sempre que o mouse do usuário é movido sobre o recipiente do mapa.
mouseout
function(event)
Argumentos: 
Este evento é disparado quando o mouse do usuário é retirado do recipiente do mapa.
mouseover
function(event)
Argumentos: 
Este evento é disparado quando o mouse do usuário é colocado no recipiente do mapa.
projection_changed
function()
Argumentos:  nenhum
Este evento é disparado quando a projeção é alterada.
renderingtype_changed
function()
Argumentos:  nenhum
Esse evento é disparado quando o renderingType muda.
tilesloaded
function()
Argumentos:  nenhum
Este evento é disparado quando os blocos visíveis são totalmente carregados.
tilt_changed
function()
Argumentos:  nenhum
Este evento é acionado quando a propriedade de inclinação do mapa é alterada.
zoom_changed
function()
Argumentos:  nenhum
Este evento é acionado quando a propriedade de zoom do mapa é alterada.
rightclick
function(event)
Argumentos: 
Esse evento é disparado quando o usuário clica com o botão direito do mouse no mapa.

Interface MapOptions

Interface google.maps.MapOptions

Objeto MapOptions usado para definir as propriedades que podem ser definidas em um mapa.
backgroundColor optional
Tipo:string optional
Cor usada para o plano de fundo da div do mapa. Essa cor será visível quando os blocos ainda não forem carregados conforme o usuário move a tela. Esta opção pode ser configurada somente quando o mapa é inicializado.
cameraControl optional
Tipo:boolean optional
O estado ativado/desativado do controle da câmera.
cameraControlOptions optional
Tipo:CameraControlOptions optional
As opções de exibição do controle da câmera.
center optional
Tipo:LatLng|LatLngLiteral optional
O centro inicial do mapa.
clickableIcons optional
Tipo:boolean optional
Padrão:true
Quando false, os ícones do mapa não são clicáveis. Um ícone de mapa representa um ponto de interesse, também conhecido como PDI.
colorScheme optional
Tipo:ColorScheme|string optional
Padrão:ColorScheme.LIGHT
O esquema de cores inicial do mapa. Esta opção pode ser configurada somente quando o mapa é inicializado.
controlSize optional
Tipo:number optional
Tamanho em pixels dos controles que aparecem no mapa. Esse valor precisa ser fornecido diretamente ao criar o mapa. Atualizá-lo depois pode colocar os controles em um estado undefined. Governa apenas os controles feitos pela própria API Maps. Não dimensiona controles personalizados criados por desenvolvedores.
disableDefaultUI optional
Tipo:boolean optional
Ativa/desativa todos os botões padrão da interface. Pode ser substituída individualmente. Não desativa os controles do teclado, que são controlados separadamente pela opção MapOptions.keyboardShortcuts. Não desativa os controles por gestos, que são controlados separadamente pela opção MapOptions.gestureHandling.
disableDoubleClickZoom optional
Tipo:boolean optional
Ativa/desativa o zoom e a centralização com clique duplo. Ativado por padrão.

Observação: essa propriedade não é recomendada. Para desativar o zoom com um duplo clique, use a propriedade gestureHandling e defina como "none".
draggable optional
Tipo:boolean optional
Se false, impede que o mapa seja arrastado. O recurso de arrastar está ativado por padrão.
draggableCursor optional
Tipo:string optional
O nome ou URL do cursor a ser exibido ao passar o mouse sobre um mapa arrastável. Essa propriedade usa o atributo cursor do CSS para mudar o ícone. Assim como na propriedade CSS, é necessário especificar pelo menos um cursor substituto que não seja um URL. Por exemplo, draggableCursor: 'url(http://www.example.com/icon.png), auto;'.
draggingCursor optional
Tipo:string optional
O nome ou URL do cursor a ser exibido quando o mapa estiver sendo arrastado. Essa propriedade usa o atributo cursor do CSS para mudar o ícone. Assim como na propriedade CSS, é necessário especificar pelo menos um cursor substituto que não seja um URL. Por exemplo, draggingCursor: 'url(http://www.example.com/icon.png), auto;'.
fullscreenControl optional
Tipo:boolean optional
O estado ativado/desativado do controle de tela cheia.
fullscreenControlOptions optional
As opções de exibição do controle de tela cheia.
gestureHandling optional
Tipo:string optional
Essa configuração controla como a API processa gestos no mapa. Valores permitidos:
  • "cooperative": eventos de rolagem e gestos de toque com um dedo rolam a página, mas não aplicam zoom nem movimentam o mapa. Os gestos de toque com dois dedos movimentam e ampliam o mapa. Os eventos de rolagem com uma tecla Ctrl ou ⌘ pressionada aplicam zoom no mapa.
    Nesse modo, o mapa coopera com a página.
  • "greedy": todos os gestos de toque e eventos de rolagem movem ou aplicam zoom no mapa.
  • "none": o mapa não pode ser movido nem ampliado por gestos do usuário.
  • "auto": (padrão) o processamento de gestos é cooperativo ou greedy, dependendo se a página pode ser rolada ou está em um iframe.
heading optional
Tipo:number optional
A orientação de imagens aéreas em graus medida no sentido horário a partir da direção cardeal norte. As orientações são ajustadas para o ângulo mais próximo disponível para o qual foram disponibilizadas imagens.
headingInteractionEnabled optional
Tipo:boolean optional
Padrão:false
Indica se o mapa deve permitir o controle do usuário sobre a rotação da câmera. Essa opção só entra em vigor quando o mapa é vetorial. Se não estiver definido no código, a configuração da nuvem para o ID do mapa será usada (se disponível).
internalUsageAttributionIds optional
Tipo:Iterable<string> optional
Padrão:null
Adiciona um ID de atribuição de uso ao inicializador, o que ajuda o Google a entender quais bibliotecas e exemplos são úteis para os desenvolvedores, como o uso de uma biblioteca de clustering de marcadores. Para desativar o envio do ID de atribuição de uso, exclua essa propriedade ou substitua o valor por uma string vazia. Somente valores únicos serão enviados. As mudanças nesse valor após a instanciação podem ser ignoradas.
isFractionalZoomEnabled optional
Tipo:boolean optional
Padrão:true para mapas vetoriais e false para mapas rasterizados
Define se o mapa pode ter níveis de zoom fracionários. Ouça isfractionalzoomenabled_changed para saber quando o padrão foi definido.
keyboardShortcuts optional
Tipo:boolean optional
Se false, impede que o mapa seja controlado pelo teclado. Os atalhos do teclado estão ativados por padrão.
mapId optional
Tipo:string optional
O ID do mapa. Não é possível definir ou mudar esse parâmetro depois que um mapa é instanciado. O Map.DEMO_MAP_ID pode ser usado para testar recursos que exigem um ID do mapa, mas não precisam ser ativados na nuvem.
mapTypeControl optional
Tipo:boolean optional
O estado inicial ativado/desativado do controle do tipo de mapa.
mapTypeControlOptions optional
Tipo:MapTypeControlOptions optional
As opções de exibição inicial do controle do tipo de mapa.
mapTypeId optional
Tipo:MapTypeId|string optional
O mapTypeId inicial do mapa. O valor padrão é ROADMAP.
maxZoom optional
Tipo:number optional
O nível de zoom máximo que será exibido no mapa. Se for omitido ou definido como null, o zoom máximo do tipo de mapa atual será usado. Os valores de zoom válidos são números de zero até o nível máximo de zoom aceito.
minZoom optional
Tipo:number optional
O nível de zoom mínimo que será exibido no mapa. Se omitido ou definido como null, o zoom mínimo do tipo de mapa atual será usado. Os valores de zoom válidos são números de zero até o nível máximo de zoom aceito.
noClear optional
Tipo:boolean optional
Se true, não limpe o conteúdo da div do mapa.
panControl optional
Tipo:boolean optional
O estado ativado/desativado do controle de panorâmica.

panControlOptions optional
Tipo:PanControlOptions optional
As opções de exibição do controle de panorâmica.

renderingType optional
Tipo:RenderingType optional
Padrão:RenderingType.RASTER
Se o mapa deve ser rasterizado ou vetorial. Não é possível definir ou mudar esse parâmetro depois que um mapa é instanciado. Se não estiver definido, a configuração da nuvem para o ID do mapa vai determinar o tipo de renderização (se disponível). Os mapas vetoriais podem não estar disponíveis para todos os dispositivos e navegadores. Se necessário, o mapa será convertido para rasterizado.
restriction optional
Tipo:MapRestriction optional
Define um limite que restringe a área do mapa acessível aos usuários. Quando definido, um usuário só pode movimentar e ampliar enquanto a visualização da câmera permanece dentro dos limites da fronteira.
rotateControl optional
Tipo:boolean optional
O estado ativado/desativado do controle de rotação.
rotateControlOptions optional
Tipo:RotateControlOptions optional
As opções de exibição do controle de rotação.
scaleControl optional
Tipo:boolean optional
O estado inicial ativado/desativado do controle de escala.
scaleControlOptions optional
Tipo:ScaleControlOptions optional
As opções de exibição inicial do controle de escala.
scrollwheel optional
Tipo:boolean optional
Se false, desativa o zoom no mapa usando uma roda de rolagem do mouse. A roda de rolagem está ativada por padrão.

Observação: essa propriedade não é recomendada. Para desativar o zoom usando a roda de rolagem, use a propriedade gestureHandling e defina como "cooperative" ou "none".
streetView optional
Tipo:StreetViewPanorama optional
Um StreetViewPanorama para mostrar quando o Pegman do Street View é solto no mapa. Se nenhum panorama for especificado, um StreetViewPanorama padrão será mostrado no div do mapa quando o ícone do Street View for solto.
streetViewControl optional
Tipo:boolean optional
O estado ativado/desativado inicial do controle Pegman do Street View. Esse controle faz parte da interface padrão e precisa ser definido como false ao mostrar um tipo de mapa em que a sobreposição de vias do Street View não deve aparecer (por exemplo, um tipo de mapa que não é da Terra).
streetViewControlOptions optional
As opções de exibição inicial do controle Pegman do Street View.
styles optional
Tipo:Array<MapTypeStyle> optional
Estilos a serem aplicados a cada um dos tipos de mapa padrão. Nos modos satellite/hybrid e terrain, esses estilos só se aplicam a rótulos e geometria. Esse recurso não está disponível ao usar um ID de mapa ou mapas vetoriais. Em vez disso, use a Estilização de mapas baseada na nuvem.
tilt optional
Tipo:number optional
Para mapas vetoriais, define o ângulo de incidência do mapa. Os valores permitidos são restritos dependendo do nível de zoom do mapa. Para mapas rasterizados, controla o comportamento de troca automática do ângulo de incidência do mapa. Os únicos valores permitidos são 0 e 45. O valor 0 faz com que o mapa sempre use uma visualização aérea de 0°, independente do nível de zoom e da janela de visualização. O valor 45 faz com que o ângulo de inclinação mude automaticamente para 45 sempre que imagens em 45° estiverem disponíveis para o nível de zoom e a janela de visualização atuais, e volte para 0 quando não estiverem disponíveis (esse é o comportamento padrão). As imagens em 45° estão disponíveis apenas para os tipos de mapa satellite e hybrid, em alguns locais e níveis de zoom. Observação:getTilt retorna o ângulo de inclinação atual, não o valor especificado por essa opção. Como getTilt e essa opção se referem a coisas diferentes, não bind() a propriedade tilt. Isso pode gerar efeitos imprevisíveis.
tiltInteractionEnabled optional
Tipo:boolean optional
Padrão:false
Indica se o mapa deve permitir o controle do usuário sobre a inclinação da câmera. Essa opção só entra em vigor quando o mapa é vetorial. Se não estiver definido no código, a configuração da nuvem para o ID do mapa será usada (se disponível).
zoom optional
Tipo:number optional
O nível de zoom inicial do mapa. Os valores de zoom válidos são números de zero até o nível máximo de zoom aceito. Valores de zoom maiores correspondem a uma resolução mais alta.
zoomControl optional
Tipo:boolean optional
O estado ativado/desativado do controle de zoom.
zoomControlOptions optional
Tipo:ZoomControlOptions optional
As opções de exibição do controle de zoom.

Interface MapTypeStyle

Interface google.maps.MapTypeStyle

O MapTypeStyle é um conjunto de seletores e estilistas que definem como o mapa deve ser estilizado. Os seletores especificam os recursos e/ou elementos do mapa que devem ser afetados, e os stylers especificam como esses recursos e elementos devem ser modificados. Para mais detalhes, consulte a referência de estilo.
stylers
As regras de estilo a serem aplicadas aos elementos e recursos selecionados do mapa. As regras são aplicadas na ordem especificada nessa matriz. Para diretrizes sobre uso e valores permitidos, consulte a referência de estilo.
elementType optional
Tipo:string optional
O elemento a que um estilista deve ser aplicado. Um elemento é um aspecto visual de um recurso no mapa. Por exemplo, um rótulo, um ícone, o traço ou o preenchimento aplicado à geometria e muito mais. Opcional. Se elementType não for especificado, o valor será 'all'. Para detalhes de uso e valores permitidos, consulte a referência de estilo.
featureType optional
Tipo:string optional
O recurso ou grupo de recursos a que um styler deve ser aplicado. Opcional. Se featureType não for especificado, o valor será 'all'. Para detalhes de uso e valores permitidos, consulte a referência de estilo.

Interface MapMouseEvent

Interface google.maps.MapMouseEvent

Esse objeto é retornado de diversos eventos do mouse no mapa e de sobreposições, e contém todos os campos mostrados abaixo.
domEvent
O evento DOM nativo correspondente. Os desenvolvedores não devem confiar que as propriedades target, currentTarget, relatedTarget e path serão definidas e consistentes. Os desenvolvedores também não devem depender da estrutura DOM da implementação interna da API Maps. Devido ao mapeamento interno de eventos, o domEvent pode ter semânticas diferentes do MapMouseEvent. Por exemplo, um MapMouseEvent "clique" pode ter um domEvent do tipo KeyboardEvent.
latLng optional
Tipo:LatLng optional
A latitude/longitude que estava abaixo do cursor quando ocorreu o evento.
stop
stop()
Parâmetros:nenhum
Valor de retorno:void
Impede que o evento seja propagado.

Interface IconMouseEvent

Interface google.maps.IconMouseEvent

Esse objeto é enviado em um evento quando um usuário clica em um ícone no mapa. O ID do lugar é armazenado no membro placeId. Para evitar que a janela de informações padrão apareça, chame o método stop() nesse evento para impedir que ele seja propagado. Saiba mais sobre IDs de lugar no guia para desenvolvedores da API Places.

Essa interface estende MapMouseEvent.

placeId optional
Tipo:string optional
O ID do lugar que foi clicado. Esse ID pode ser usado para consultar mais informações sobre o recurso clicado.

Saiba mais sobre IDs de lugar no guia para desenvolvedores da API Places.
Herdado: domEvent, latLng
Herdado: stop

Constantes ColorScheme

Constantes de google.maps.ColorScheme

Identificadores para esquemas de cores do mapa. Especifique-os por valor ou usando o nome da constante. Por exemplo, 'FOLLOW_SYSTEM' ou google.maps.ColorScheme.FOLLOW_SYSTEM.

Acesse ligando para const {ColorScheme} = await google.maps.importLibrary("core").
Consulte Bibliotecas na API Maps JavaScript.
DARK O esquema de cores escuras para um mapa.
FOLLOW_SYSTEM O esquema de cores é selecionado com base nas preferências do sistema.
LIGHT O esquema de cores claro para um mapa. Valor padrão para o Maps JS legado.

Constantes MapTypeId

Constantes de google.maps.MapTypeId

Identificadores para MapTypes comuns. Especifique-os por valor ou usando o nome da constante. Por exemplo, 'satellite' ou google.maps.MapTypeId.SATELLITE.

Acesse ligando para const {MapTypeId} = await google.maps.importLibrary("maps").
Consulte Bibliotecas na API Maps JavaScript.
HYBRID Este tipo de mapa exibe uma camada transparente das principais ruas nas imagens de satélite.
ROADMAP Este tipo de mapa exibe um mapa convencional de ruas.
SATELLITE Este tipo de mapa exibe imagens de satélite.
TERRAIN Este tipo de mapa exibe os mapas com características físicas como terreno e vegetação.

Classe MapTypeRegistry

Classe google.maps.MapTypeRegistry

Um registro para instâncias de MapType, com chave pelo ID de MapType.

Essa classe estende MVCObject.

Acesse ligando para const {MapTypeRegistry} = await google.maps.importLibrary("maps").
Consulte Bibliotecas na API Maps JavaScript.
MapTypeRegistry
MapTypeRegistry()
Parâmetros:nenhum
O MapTypeRegistry contém a coleção de tipos de mapa personalizados disponíveis para uso no mapa. A API consulta esse registro ao fornecer a lista de tipos de mapas disponíveis nos controles, por exemplo.
set
set(id, mapType)
Parâmetros:
  • id:  string identificador do MapType a ser adicionado ao registro.
  • mapType:  objeto MapType|? MapType a ser adicionado ao registro.
Valor de retorno:nenhum
Define o registro a ser associado ao identificador de string passado juntamente com o tipo de mapa.
Herdado:addListener, bindTo, get, notify, setValues, unbind, unbindAll

Interface MapRestriction

Interface google.maps.MapRestriction

Uma restrição que pode ser aplicada ao mapa. A janela de visualização do mapa não vai exceder essas restrições.
latLngBounds
Quando definido, um usuário só pode mover e ampliar dentro dos limites especificados. Os limites podem restringir a longitude e a latitude ou apenas a latitude. Para limites somente de latitude, use longitudes oeste e leste de -180 e 180, respectivamente. Por exemplo, latLngBounds: {north: northLat, south: southLat, west: -180, east: 180}.
strictBounds optional
Tipo:boolean optional
É possível restringir ainda mais os limites definindo a flag strictBounds como true. Isso reduz o quanto um usuário pode diminuir o zoom, garantindo que tudo fora dos limites restritos permaneça oculto. O padrão é false, o que significa que um usuário pode reduzir o zoom até que toda a área delimitada esteja visível, possivelmente incluindo áreas fora dela.

Classe TrafficLayer

Classe google.maps.TrafficLayer

Uma camada para dados do trânsito.

Essa classe estende MVCObject.

Acesse ligando para const {TrafficLayer} = await google.maps.importLibrary("maps").
Consulte Bibliotecas na API Maps JavaScript.
TrafficLayer
TrafficLayer([opts])
Parâmetros:
Uma camada que exibe o trânsito atual da estrada.
getMap
getMap()
Parâmetros:nenhum
Valor de retorno:Map|null
Retorna o mapa no qual esta camada é exibida.
setMap
setMap(map)
Parâmetros:
  • map:  Map optional
Valor de retorno:nenhum
Renderiza a camada no mapa especificado. Se o mapa estiver definido como null, a camada será removida.
setOptions
setOptions(options)
Parâmetros:
Valor de retorno:nenhum
Herdado:addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

Interface TrafficLayerOptions

Interface google.maps.TrafficLayerOptions

Objeto TrafficLayerOptions usado para definir as propriedades que podem ser definidas em um TrafficLayer.
autoRefresh optional
Tipo:boolean optional
Padrão:true
Indica se a camada de trânsito é atualizada automaticamente com informações atualizadas.
map optional
Tipo:Map optional
Mapa em que a camada de trânsito será mostrada.

Classe TransitLayer

Classe google.maps.TransitLayer

Uma camada de transporte público.

Essa classe estende MVCObject.

Acesse ligando para const {TransitLayer} = await google.maps.importLibrary("maps").
Consulte Bibliotecas na API Maps JavaScript.
TransitLayer
TransitLayer()
Parâmetros:nenhum
Uma camada que mostra linhas de transporte público.
getMap
getMap()
Parâmetros:nenhum
Valor de retorno:Map|null
Retorna o mapa no qual esta camada é exibida.
setMap
setMap(map)
Parâmetros:
  • map:  Map optional
Valor de retorno:void
Renderiza a camada no mapa especificado. Se o mapa estiver definido como null, a camada será removida.
Herdado:addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

Classe BicyclingLayer

Classe google.maps.BicyclingLayer

Uma camada que mostra ciclovias.

Essa classe estende MVCObject.

Acesse ligando para const {BicyclingLayer} = await google.maps.importLibrary("maps").
Consulte Bibliotecas na API Maps JavaScript.
BicyclingLayer
BicyclingLayer()
Parâmetros:nenhum
Uma camada que exibe ciclovias e evita grandes estradas.
getMap
getMap()
Parâmetros:nenhum
Valor de retorno:Map|null
Retorna o mapa no qual esta camada é exibida.
setMap
setMap(map)
Parâmetros:
  • map:  Map optional
Valor de retorno:void
Renderiza a camada no mapa especificado. Se o mapa estiver definido como null, a camada será removida.
Herdado:addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

Interface CameraOptions

Interface google.maps.CameraOptions

Usado para definir as opções de câmera do mapa.
center optional
Tipo:LatLngLiteral|LatLng optional
heading optional
Tipo:number optional
tilt optional
Tipo:number optional
zoom optional
Tipo:number optional

Interface VisibleRegion

Interface google.maps.VisibleRegion

Contém os quatro pontos que definem o polígono de quatro lados, que é a região visível do mapa. Em um mapa vetorial, esse polígono pode ser um trapézio em vez de um retângulo quando o mapa está inclinado.
farLeft
Tipo:LatLng
farRight
Tipo:LatLng
latLngBounds
A menor caixa delimitadora que inclui a região visível.
nearLeft
Tipo:LatLng
nearRight
Tipo:LatLng

Constantes RenderingType

Constantes de google.maps.RenderingType

Acesse ligando para const {RenderingType} = await google.maps.importLibrary("maps").
Consulte Bibliotecas na API Maps JavaScript.
RASTER Indica que o mapa é rasterizado.
UNINITIALIZED Indica que ainda não se sabe se o mapa é vetorial ou raster, porque ele ainda não terminou de ser inicializado.
VECTOR Indica que o mapa é vetorial.

Interface MapCapabilities

Interface google.maps.MapCapabilities

Objeto que contém um snapshot dos recursos disponíveis no momento para o mapa. Isso não significa necessariamente que os módulos relevantes foram carregados ou inicializados, mas sim que o mapa atual tem permissão para usar essas APIs. Consulte as propriedades para uma lista de recursos possíveis.
isAdvancedMarkersAvailable optional
Tipo:boolean optional
Se for verdadeiro, o mapa estará configurado corretamente para permitir o uso de marcadores avançados. É necessário importar a biblioteca marker para usar marcadores avançados. Consulte https://goo.gle/gmp-isAdvancedMarkersAvailable para mais informações.
isDataDrivenStylingAvailable optional
Tipo:boolean optional
Se for "true", o mapa estará configurado corretamente para permitir o uso de estilização orientada a dados em pelo menos uma FeatureLayer. Consulte https://goo.gle/gmp-data-driven-styling e https://goo.gle/gmp-FeatureLayerIsAvailable para mais informações.
isWebGLOverlayViewAvailable optional
Tipo:boolean optional
Se for verdadeiro, o mapa estará configurado corretamente para permitir o uso de WebGLOverlayView.