Maps

Map

Classe google.maps.Map

Essa classe estende MVCObject.

Ao usar v=beta, é possível chamar const {Map} = await google.map.importLibrary("maps"). Consulte Bibliotecas na API Maps JavaScript.

Map
Map(mapDiv[, opts])
Parâmetros:
  • mapDiv: HTMLElement o mapa será renderizado para preencher esse elemento.
  • optsMapOptions optional Opções
Cria um novo mapa dentro do contêiner HTML fornecido, que normalmente é um elemento DIV.
controls
Controles adicionais a serem anexados ao mapa. Para adicionar um controle ao mapa, adicione a <div> do controle ao MVCArray correspondente ao ControlPosition em que ele deve ser renderizado.
data
Tipo: Data
Uma instância de Data, vinculada ao mapa. Adicione elementos a este objeto Data para os exibir facilmente 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 serão exibidos sobre o mapa básico ao qual estão anexados, na ordem em que aparecem na matriz overlayMapTypes (sobreposições com valores de índice mais altos são exibidas na frente de sobreposições com valores de índice mais baixos).
fitBounds
fitBounds(bounds[, padding])
Parâmetros:
  • boundsLatLngBounds|LatLngBoundsLiteral limites para exibir.
  • paddingnumber|Padding optional é preenchido em pixels. Os limites serão ajustados na parte do mapa que permanecer depois que o padding for removido. Um valor numérico produz o mesmo padding nos quatro lados. Insira 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 não faz nada. Para mudar a janela de visualização enquanto o mapa estiver oculto, defina o mapa como visibility: hidden, garantindo que o div do mapa tenha um tamanho real. Para mapas vetoriais, este método define a inclinação do mapa e a direção para seus valores zero padrão. Chamar esse método pode causar uma animação suave enquanto o mapa se movimenta e aplica 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 for visível, os limites variam em longitude, de -180 a 180 graus. 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 ver 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 exibida no centro do mapa. Esse objeto LatLng não é encapsulado. Consulte LatLng para mais informações. 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 clicabilidade dos ícones de mapa. Um ícone de mapa representa um ponto de interesse, também conhecido como PDI. Se o valor retornado for true, os ícones poderão ser clicados no mapa.
getDiv
getDiv()
Parâmetros:nenhum
Valor de retorno: HTMLElement o mapDiv do mapa.
BetagetFeatureLayer
getFeatureLayer(featureType)
Parâmetros:
Valor de retorno: FeatureLayer
Retorna o FeatureLayer do FeatureType específico. Um FeatureLayer precisa estar ativado no Console do Google Cloud. Se um FeatureLayer do FeatureType especificado não existir no mapa ou se o estilo com base em dados não estiver disponível (nenhum ID de mapa, blocos de vetor e FeatureLayer não estiverem ativados no estilo de mapa), um erro será registrado, e a FeatureLayer.isAvailable resultante será falsa.
getHeading
getHeading()
Parâmetros: nenhum
Valor de retorno: number|undefined
Retorna a direção da 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.
BetagetMapCapabilities
getMapCapabilities()
Parâmetros: nenhum
Valor de retorno: MapCapabilities
Informa o autor da chamada dos recursos atuais disponíveis para o 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. Ouça 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 RenderType 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 na streetViewControl do mapa serão refletidas na exibição desse panorama vinculado.
getTilt
getTilt()
Parâmetros: nenhum
Valor de retorno: number|undefined
Retorna o ângulo atual de incidência do mapa, em graus a partir do plano da janela de visualização para o plano do mapa. Para mapas de varredura, o resultado será 0 para imagens tiradas diretamente em cima ou 45 para imagens de 45°. Esse método não retorna o valor definido por setTilt. Consulte setTilt para mais detalhes.
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 a câmera do mapa imediatamente para as opções da câmera desejada, sem animação.
panBy
panBy(x, y)
Parâmetros:
  • x: number número de pixels para mover o mapa na direção x.
  • ynumber 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
Altera o centro do mapa para a LatLng especificada. 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 movimentar o mapa.
  • padding: number|Padding optional é preenchido em pixels. Um valor numérico produz o mesmo padding nos quatro lados. O valor padrão é 0.
Valor de retorno: nenhum
Move o mapa de acordo com a quantidade mínima necessária para conter o LatLngBounds especificado. Ele não garante onde vão os limites no mapa, exceto que o mapa será deslocado para mostrar o máximo possível de limites dentro de {currentMapSizeInPx} - {padding}. Nos mapas vetorial e de varredura, 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:
  • valueboolean
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 clicabilidade dos ícones de 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 do mapa medida em graus a partir da direção cardeal norte. Para mapas de varredura, esse método se aplica somente a imagens aéreas.
setMapTypeId
setMapTypeId(mapTypeId)
Parâmetros:
Valor de retorno: nenhum
setOptions
setOptions(options)
Parâmetros:
Valor de retorno: nenhum
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 a ele. A definição do panorama como null vincula o panorama incorporado padrão novamente 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 de varredura, controla o comportamento da alternância automática para o ângulo de incidência do mapa. Os únicos valores permitidos são 0 e 45. setTilt(0) faz o mapa sempre usar uma visualização aérea de 0°, independentemente 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 as imagens de 45° estiverem disponíveis para o nível de zoom e a janela de visualização atuais e volte para 0 sempre que as imagens de 45° estiverem disponíveis (esse é o comportamento padrão). As imagens em 45° só estão disponíveis para os tipos de mapa satellite e hybrid, em alguns locais e com alguns 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.
setZoom
setZoom(zoom)
Parâmetros:
  • zoom: number os valores de zoom maiores correspondem a uma resolução maior.
Valor de retorno: nenhum
Define o zoom do mapa.
Herdadas: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
DEMO_MAP_ID ID do mapa, que pode ser usado para amostras de código que exigem um ID do mapa. Esse ID do mapa não se destina ao uso em aplicativos de produção e não pode ser usado para recursos que exigem configuração da nuvem (como o estilo de nuvem).
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:
Este evento é disparado quando o usuário clica no mapa. Um MapArgs com propriedades para o local clicado é retornado, a menos que um ícone de local seja clicado. Nesse caso, um IconArgs com um ID de local é retornado. IconArgs e MapArgs são idênticos, mas IconArgs tem o campo ID do lugar. O evento sempre poderá ser tratado como um MapUUID quando o ID de lugar não for importante. O evento de clique não será acionado se um marcador ou 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. O evento de clique também disparará, imediatamente antes desse.
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.
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
Este evento é disparado quando a propriedade isFractionalZoomEnabled é alterada.
Betamapcapabilities_changed
function()
Argumentos:  nenhum
Este evento é disparado quando os recursos do mapa são alterados.
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
Este evento é disparado quando o renderType 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:
Este 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 Map.

backgroundColor optional
Tipo:string optional
Cor usada para o plano de fundo do div do mapa. Essa cor vai ser visível quando os blocos ainda não tiverem sido carregados à medida que o usuário movimenta o mapa. Esta opção pode ser configurada somente quando o mapa é inicializado.
center optional
Tipo: LatLng|LatLngLiteral optional
O centro inicial do mapa.
clickableIcons optional
Tipo:boolean optional
Padrão: true
Quando false, os ícones de mapa não são clicáveis. Um ícone de mapa representa um ponto de interesse, também conhecido como PDI.
controlSize optional
Tipo: number optional
Tamanho em pixels dos controles que aparecem no mapa. Esse valor precisa ser fornecido diretamente ao criar o mapa. Atualizar este valor mais tarde pode fazer com que os controles fiquem no estado undefined. Só controla os controles feitos pela própria API Maps. Não dimensiona os controles personalizados criados pelo desenvolvedor.
disableDefaultUI optional
Tipo:boolean optional
Ativa/desativa todos os botões de IU padrão. 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 de 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 no clique duplo, use a propriedade gestureHandling e a defina como "none".

draggable optional
Tipo:boolean optional
Se false, o mapa não será arrastado. O recurso de arrastar está ativado por padrão.
draggableCursor optional
Tipo: string optional
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, é preciso 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
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, é preciso 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 lida com os gestos no mapa. Valores permitidos:
  • "cooperative": eventos de rolagem e gestos de toque com um dedo rolam a página sem aplicar zoom nem movimentar o mapa. Os gestos de toque com dois dedos movimentam e ampliam o mapa. Eventos de rolagem com uma tecla Ctrl ou ⌘ pressionada para aplicar zoom ao mapa.
    Nesse modo, o mapa coopera com a página.
  • "greedy": todos os gestos de toque e eventos de rolagem movimentam ou aumentam o zoom do mapa.
  • "none": não é possível movimentar ou aumentar o zoom do mapa usando gestos do usuário.
  • "auto": (padrão) o gerenciamento de gestos é cooperativo ou ganancioso, dependendo da possibilidade de rolagem da página ou de 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.
isFractionalZoomEnabled optional
Tipo: boolean optional
Padrão:true para mapas vetoriais e false para mapas rasterizados
Indica se o mapa deve permitir 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, o mapa não será controlado pelo teclado. Os atalhos do teclado estão ativados por padrão.
mapId optional
Tipo:string optional
O ID do mapa. Este parâmetro não pode ser definido ou alterado depois que um mapa é instanciado.
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 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 for true, não apague o conteúdo do div do mapa.
panControl optional
Tipo: boolean optional
O estado ativado/desativado do controle de panorâmica.

Observação: o controle de movimentação não está disponível no novo conjunto de controles introduzido na v3.22 da API Google Maps JavaScript. Na v3.22 e v3.23, você pode optar por usar o conjunto de controles anterior em vez dos novos, disponibilizando o controle de movimentação como parte do conjunto de controles antigo. Consulte O que há de novo nos controles de mapa v3.22.

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

Observação: o controle de movimentação não está disponível no novo conjunto de controles introduzido na v3.22 da API Google Maps JavaScript. Na v3.22 e v3.23, você pode optar por usar o conjunto de controles anterior em vez dos novos, disponibilizando o controle de movimentação como parte do conjunto de controles antigo. Consulte O que há de novo nos controles de mapa v3.22.

restriction optional
Tipo:MapRestriction optional
Define um limite que restringe a área do mapa acessível a usuários. Quando definido, o usuário só pode movimentar e aplicar zoom enquanto a visualização da câmera estiver dentro dos limites do limite.
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 a 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 a defina como "cooperative" ou "none".

streetView optional
Tipo: StreetViewPanorama optional
Um StreetViewPanorama a ser exibido quando o Pegman do Street View é colocado no mapa. Se nenhum panorama for especificado, um StreetViewPanorama padrão será exibido no div do mapa quando o pegman for solto.
streetViewControl optional
Tipo:boolean optional
O estado ativado/desativado inicial do controle Pegman do Street View. Esse controle faz parte da IU padrão e precisa ser definido como false ao exibir um tipo de mapa em que a sobreposição de ruas do Street View não aparece (por exemplo, um tipo de mapa que não seja 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. Para os modos satellite/hybrid e terrain, esses estilos só se aplicam aos marcadores e à geometria.
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 de varredura, controla o comportamento da alternância automática para o â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°, independentemente 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 as imagens de 45° estiverem disponíveis para o nível de zoom e a janela de visualização atuais e volte para 0 sempre que as imagens de 45° estiverem indisponíveis (esse é o comportamento padrão). As imagens em 45° só estão disponíveis para os tipos de mapa satellite e hybrid, em alguns locais e com alguns 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.
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 maior.
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 CmdStyle.

Interface google.maps.MapTypeStyle

O MapTypeStyle é uma coleção de seletores e estilizadores que definem o estilo do mapa. Os seletores especificam os elementos e/ou elementos do mapa que devem ser afetados, e os estilizadores especificam como esses recursos e elementos devem ser modificados. Veja mais detalhes na referência de estilo.

stylers
Tipo: Array<Object>
As regras de estilo a serem aplicadas aos elementos e elementos do mapa selecionados. As regras são aplicadas na ordem especificada nessa matriz. Para ver diretrizes sobre o uso e os valores permitidos, consulte a referência de estilo.
elementType optional
Tipo: string optional
O elemento ao qual um estilizador deve ser aplicado. Um elemento é um aspecto visual de um recurso no mapa. Exemplo: um marcador, um ícone, o traço ou o preenchimento aplicados à geometria e muito mais. Opcional. Se elementType não for especificado, o valor será considerado 'all'. Para detalhes sobre uso e valores permitidos, consulte a referência de estilo.
featureType optional
Tipo:string optional
O recurso ou grupo de atributos ao qual um estilizador deve ser aplicado. Opcional. Se featureType não for especificado, o valor será considerado 'all'. Para detalhes sobre uso e valores permitidos, consulte a referência de estilo.

interface MapArgs

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 podem depender da definição e consistência das propriedades target, currentTarget, relatedTarget e path. Os desenvolvedores também não devem confiar na estrutura DOM da implementação interna da API Maps. Devido ao mapeamento de eventos internos, o domEvent pode ter uma semântica diferente do MapMouseEvent. Por exemplo, um MapMouseEvent "click" 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 esse evento se propague ainda mais.

IconArgs.

Interface google.maps.IconMouseEvent

Esse objeto é enviado em um evento quando um usuário clica em um ícone no mapa. O ID desse 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 evitar que ele seja propagado. Saiba mais sobre IDs de local no guia do desenvolvedor da API Places.

Essa interface estende MapMouseEvent.

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

Saiba mais sobre IDs de local no guia do desenvolvedor da API Places.

Herdadas: domEvent, latLng
Herdadas: stop

especificarIds (links em inglês)

google.maps.MapTypeId constantes

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

Ao usar v=beta, é possível chamar const {MapTypeId} = await google.map.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 mapas com características físicas como terreno e vegetação.

Classe ⌘Registry.

Classe google.maps.MapTypeRegistry

Um registro para instâncias PSA, codificado pelo ID splash.

Essa classe estende MVCObject.

Ao usar v=beta, é possível chamar const {MapTypeRegistry} = await google.map.importLibrary("maps"). Consulte Bibliotecas na API Maps JavaScript.

MapTypeRegistry
MapTypeRegistry()
Parâmetros:nenhum
A 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:
  • idstring Identificador do splash para adicionar ao registro.
  • mapType:  objeto MapType|* que 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.
Herdadas: 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 excederá essas restrições.

latLngBounds
Quando definido, o usuário só pode movimentar e aplicar zoom dentro dos limites fornecidos. 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 tornar os limites mais restritivos definindo a sinalização strictBounds como true. Isso reduz o quanto o usuário pode diminuir o zoom, garantindo que tudo fora dos limites restritos permaneça oculto. O padrão é false, o que significa que o usuário pode diminuir o zoom até que toda a área limitada esteja na visualização, possivelmente incluindo áreas fora da área limitada.

Classe TrafficLayer

Classe google.maps.TrafficLayer

Uma camada para dados do trânsito.

Essa classe estende MVCObject.

Ao usar v=beta, é possível chamar const {TrafficLayer} = await google.map.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
Retorna o mapa no qual esta camada é exibida.
setMap
setMap(map)
Parâmetros:
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
Herdadas: 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áfego é atualizada automaticamente com informações atualizadas.
map optional
Tipo:Map optional
Mapa no qual exibir a camada de trânsito.

TransitLayer

Classe google.maps.TransitLayer

Uma camada de transporte público.

Essa classe estende MVCObject.

Ao usar v=beta, é possível chamar const {TransitLayer} = await google.map.importLibrary("maps"). Consulte Bibliotecas na API Maps JavaScript.

TransitLayer
TransitLayer()
Parâmetros: nenhum
Uma camada que exibe linhas de transporte público.
getMap
getMap()
Parâmetros: nenhum
Valor de retorno: Map
Retorna o mapa no qual esta camada é exibida.
setMap
setMap(map)
Parâmetros:
Valor de retorno: nenhum
Renderiza a camada no mapa especificado. Se o mapa estiver definido como null, a camada será removida.
Herdadas: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

Classe BicyclingLayer

Classe google.maps.BicyclingLayer

Uma camada que mostra ciclovias.

Essa classe estende MVCObject.

Ao usar v=beta, é possível chamar const {BicyclingLayer} = await google.map.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
Retorna o mapa no qual esta camada é exibida.
setMap
setMap(map)
Parâmetros:
Valor de retorno: nenhum
Renderiza a camada no mapa especificado. Se o mapa estiver definido como null, a camada será removida.
Herdadas: 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 um mapa vetorial tem inclinação.

farLeft
Tipo: LatLng
farRight
Tipo:LatLng
latLngBounds
A menor caixa delimitadora que inclui a região visível.
nearLeft
Tipo: LatLng
nearRight
Tipo:LatLng

RenderType (link em inglês)

google.maps.RenderingType constantes

Ao usar v=beta, é possível chamar const {RenderingType} = await google.map.importLibrary("maps"). Consulte Bibliotecas na API Maps JavaScript.

RASTER Indica que o mapa é de varredura.
UNINITIALIZED Indica que ainda é desconhecido se o mapa é vetorial ou rasterizado, porque o mapa ainda não foi inicializado.
VECTOR Indica que o mapa é vetorial.

interface MapCapabilities

Interface google.maps.MapCapabilities

Objeto que contém um snapshot dos recursos atualmente disponíveis para o mapa. Consulte as propriedades para ver uma lista dos possíveis recursos.

isAdvancedMarkersAvailable optional
Tipo: boolean optional
isDataDrivenStylingAvailable optional
Tipo:boolean optional