Maps

Mapa aula

Classe google.maps.Map

Essa classe estende MVCObject:

Acesse chamando const {Map} = await google.maps.importLibrary("maps"). Consulte Bibliotecas na API Maps JavaScript.

Construtor
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 especificado, que normalmente é um elemento DIV.

Constantes
DEMO_MAP_ID	ID do mapa, que pode ser usado em exemplos de código que exigem um ID de mapa. Esse ID do mapa não deve ser usado em aplicativos de produção e não pode ser usado para recursos que exigem configuração de nuvem (como a estilização na nuvem).

Propriedades
controls	Tipo:  Array<MVCArray<HTMLElement>> Controles adicionais a serem anexados ao mapa. Para adicionar um controle ao mapa, adicione o <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 recursos a este objeto Data para que eles sejam mostrados neste mapa com praticidade.
mapTypes	Tipo:  MapTypeRegistry Um registro de instâncias de MapType por ID da 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. As sobreposições com valores de índice mais altos são exibidas na frente daquelas com valores de índice mais baixos.

Métodos
fitBounds	fitBounds(bounds[, padding]) Parâmetros:  bounds:  LatLngBounds|LatLngBoundsLiteral limites a serem exibidos. padding:  number|Padding optional padding em pixels. Os limites serão ajustados na parte do mapa que permanece depois que o preenchimento é removido. Um valor numérico gera 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 como 0 x 0 e, portanto, não faz nada. Para alterar a janela de visualização enquanto o mapa está 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 e a direção do mapa com os valores zero padrão. Chamar esse método pode causar uma animação suave à medida que 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 da Terra estiver visível, os limites variam em longitude de -180 a 180 graus. Se o mapa ainda não tiver sido inicializado ou se o zoom não tiver sido definido, o resultado será undefined. Nos mapas vetoriais com inclinação ou direçã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 descobrir a região exata visível 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 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 receber cliques dos í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 poderão ser clicados no mapa.
getDatasetFeatureLayer	Aviso:disponível apenas no canal v=beta. getDatasetFeatureLayer(datasetId) Parâmetros:  datasetId:  string Valor de retorno:  FeatureLayer Retorna o FeatureLayer para o datasetId especificado. Os IDs do conjunto 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, blocos vetoriais, camadas de elementos de estilo baseado em dados ou conjuntos de dados configurados no estilo de mapa), isso vai registrar um erro, 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:  featureType:  FeatureType 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 ou se o estilo baseado em dados não estiver disponível (sem ID do mapa, blocos vetoriais e FeatureLayer ativado no estilo de 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 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.
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ó funciona quando o mapa é vetorial. Se não for definida no código, a configuração de nuvem do ID do mapa será usada (se disponível).
getMapCapabilities	getMapCapabilities() Parâmetros: nenhum Valor de retorno:  MapCapabilities Informa o autor da chamada sobre os 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. Detecte o evento projection_changed e verifique se o valor dele não é 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 alterações no 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 de incidência atual do mapa, em graus, do plano da janela de visualização para o plano do mapa. Para mapas rasterizados, o resultado será 0 para imagens tiradas diretamente de cima 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 Informa se as interações de inclinação estão ativadas. Essa opção só funciona quando o mapa é vetorial. Se não for definida no código, a configuração de nuvem do 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 foi definido, o resultado é undefined.
moveCamera	moveCamera(cameraOptions) Parâmetros:  cameraOptions:  CameraOptions Valor de retorno: nenhum Define imediatamente a câmera do mapa para as opções de 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. 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:  latLng:  LatLng|LatLngLiteral a nova latitude/longitude central do mapa. 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 onde o mapa será deslocado. padding:  number|Padding optional padding em pixels. Um valor numérico gera o mesmo padding nos quatro lados. O valor padrão é 0. Valor de retorno: nenhum Movimenta o mapa de acordo com o valor mínimo necessário para conter o LatLngBounds especificado. Não há garantia de onde os limites vão estar no mapa, exceto que o mapa será movido para mostrar o máximo possível dos limites dentro de {currentMapSizeInPx} - {padding}. Nos mapas vetoriais e rasterizados, o zoom, a inclinação e a direção não são alterados.
setCenter	setCenter(latlng) Parâmetros:  latlng:  LatLng|LatLngLiteral 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 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 para o mapa medido em graus a partir da direção cardeal norte. Para mapas rasterizados, esse método se aplica somente a imagens aéreas.
setHeadingInteractionEnabled	setHeadingInteractionEnabled(headingInteractionEnabled) Parâmetros:  headingInteractionEnabled:  boolean Valor de retorno: nenhum Define se as interações de cabeçalho serão ativadas. Essa opção só funciona quando o mapa é vetorial. Se não for definida no código, a configuração de nuvem do ID do mapa será usada (se disponível).
setMapTypeId	setMapTypeId(mapTypeId) Parâmetros:  mapTypeId:  MapTypeId|string Valor de retorno: nenhum
setOptions	setOptions(options) Parâmetros:  options:  MapOptions optional Valor de retorno: nenhum
setRenderingType	setRenderingType(renderingType) Parâmetros:  renderingType:  RenderingType Valor de retorno: nenhum Define o RenderingType atual do mapa.
setStreetView	setStreetView(panorama) Parâmetros:  panorama:  StreetViewPanorama optional o panorama a ser vinculado ao mapa. Valor de retorno: nenhum Vincula um StreetViewPanorama ao mapa. Este panorama substitui o padrão StreetViewPanorama, permitindo que o mapa seja vinculado a um panorama externo fora dele. Definir o panorama como null vincula o panorama incorporado padrão ao mapa.
setTilt	setTilt(tilt) Parâmetros:  tilt:  number Valor de retorno: nenhum Em 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 alternância automática para o â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 visã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 imagens em 45° estiverem disponíveis para o nível de zoom e a janela de visualização atuais e volta para 0 sempre que as imagens em 45° 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 com determinados 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 use bind() na propriedade tilt. isso pode causar 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ó funciona quando o mapa é vetorial. Se não for definida no código, a configuração de nuvem do 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

Eventos
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:  event:  MapMouseEvent|IconMouseEvent Este evento é disparado 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 local é retornado. IconMouseEvent e MapMouseEvent são idênticos, exceto pelo fato de IconMouseEvent ter o campo de ID de local. O evento sempre pode ser tratado como um MapMouseEvent quando o ID de local não é importante. O evento de clique não será disparado se um marcador ou uma janela de informações tiver sido clicado.
contextmenu	function(event) Argumentos:  event:  MapMouseEvent Este evento é disparado quando o evento contextmenu do DOM é disparado no recipiente do mapa.
dblclick	function(event) Argumentos:  event:  MapMouseEvent Este evento é disparado quando o usuário clica duas vezes no mapa. O evento de clique às vezes é disparado uma 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.
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 for alterada.
mapcapabilities_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:  event:  MapMouseEvent Este evento é disparado sempre que o mouse do usuário é movido sobre o recipiente do mapa.
mouseout	function(event) Argumentos:  event:  MapMouseEvent Este evento é disparado quando o mouse do usuário é retirado do recipiente do mapa.
mouseover	function(event) Argumentos:  event:  MapMouseEvent 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 é alterado.
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	Descontinuado:use o evento Map.contextmenu para oferecer suporte a padrões de uso, como clicar em Control no macOS. function(event) Argumentos:  event:  MapMouseEvent Este evento é disparado quando o usuário clica com o botão direito do mouse no mapa.

MapOptions interface

google.maps.MapOptions interface

Objeto MapOptions usado para definir as propriedades que podem ser definidas em um mapa.

Propriedades
backgroundColor optional	Tipo:  string optional Cor usada para o plano de fundo do div do mapa. Essa cor ficará 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 do mapa não são clicáveis. Um ícone de mapa representa um ponto de interesse, também conhecido como PDI.
colorScheme optional	Aviso:disponível apenas no canal v=beta. 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. Se ele for atualizado posteriormente, poderá levar os controles para o estado undefined. Rege apenas os controles realizados pela própria API do Google Maps. Não escalona controles personalizados criados pelo desenvolvedor.
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 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 com clique duplo, é possível usar a propriedade gestureHandling e defini-la como "none".
draggable optional	Descontinuado:uso descontinuado em 2017. Para desativar o recurso de arrastar no mapa, use a propriedade gestureHandling e defina-a como "none". 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 quando você passa o mouse sobre um mapa arrastável. Essa propriedade usa o atributo CSS cursor para alterar 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 CSS cursor para alterar 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	Tipo:  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 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. Gestos de toque com dois dedos movimentam e aplicam zoom ao mapa. Eventos de rolagem com uma tecla Ctrl ou ⌘ pressionadas para ampliar o mapa. Neste modo, o mapa coopera com a página. "greedy": todos os gestos de toque e eventos de rolagem movimentam ou aplicam zoom ao mapa. "none": o mapa não pode ser movimentado ou ampliado por gestos do usuário. "auto" (padrão): o processamento de gestos é cooperativo ou ganancioso, dependendo se a página é rolável 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 Define se o mapa deve permitir que o usuário controle a direção da câmera (rotação). Essa opção só funciona quando o mapa é vetorial. Se não for definida no código, a configuração de nuvem do ID do mapa será usada (se disponível).
isFractionalZoomEnabled optional	Tipo:  boolean optional Padrão:true para mapas vetoriais e false para mapas rasterizados Define 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, 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. Este parâmetro não pode ser definido ou alterado depois que um mapa é instanciado. Map.DEMO_MAP_ID pode ser usada para testar recursos que exigem um ID de mapa, mas que não precisam de ativação da 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 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 de zoom máximo 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 de zoom máximo aceito.
noClear optional	Tipo:  boolean optional Se for true, não limpe o conteúdo do div do mapa.
panControl optional	Descontinuado:o controle de panorâmica foi descontinuado em setembro de 2015. Tipo:  boolean optional O estado ativado/desativado do controle de panorâmica.
panControlOptions optional	Descontinuado:o controle de panorâmica foi descontinuado em setembro de 2015. Tipo:  PanControlOptions optional As opções de exibição do controle de panorâmica.
renderingType optional	Tipo:  RenderingType optional Padrão:RenderingType.RASTER Define se o mapa deve ser rasterizado ou vetorial. Este parâmetro não pode ser definido ou alterado depois que um mapa é instanciado. Se ela não for definida, a configuração de nuvem do 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, e o mapa voltará a ser rasterizado conforme necessário.
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 aplicar zoom enquanto a visualização da câmera permanece 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 interface padrão e deve ser definido como false ao exibir um tipo de mapa em que a sobreposição de estradas do Street View não deve aparecer (por exemplo, um tipo de mapa que não seja do Google Earth).
streetViewControlOptions optional	Tipo:  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ó serão aplicados a rótulos e geometria. Esse recurso não está disponível ao usar um ID de mapa ou mapas vetoriais (use a Estilização de mapas baseada na nuvem).
tilt optional	Tipo:  number optional Em mapas vetoriais, define o ângulo de incidência do mapa. Os valores permitidos são restritos dependendo do nível de zoom do mapa. Em mapas rasterizados, controla o comportamento de 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 visã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 em 45° estiverem disponíveis para o nível de zoom e a janela de visualização atuais e muda de volta para 0 sempre que as imagens em 45° 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 com determinados 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 causar efeitos imprevisíveis.
tiltInteractionEnabled optional	Tipo:  boolean optional Padrão:false Define se o mapa deve permitir que o usuário controle a inclinação da câmera. Essa opção só funciona quando o mapa é vetorial. Se não for definida no código, a configuração de nuvem do 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 de zoom máximo 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.

MapElement aula

Classe google.maps.MapElement

Aviso:disponível apenas no canal v=beta.

MapElement é uma subclasse HTMLElement para renderização de mapas. Depois de carregar a biblioteca maps, é possível criar um mapa em HTML. Por exemplo:

<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>

Internamente, ele usa Map, que pode ser acessado com a propriedade innerMap.

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

Essa classe estende HTMLElement:

Essa classe implementa MapElementOptions:

Acesse chamando const {MapElement} = await google.maps.importLibrary("maps"). Consulte Bibliotecas na API Maps JavaScript.

Construtor
MapElement	MapElement([options]) Parâmetros:  options:  MapElementOptions optional

Propriedades
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 Define se o mapa deve permitir que o usuário controle a direção da câmera (rotação). Essa opção só funciona quando o mapa é vetorial. Se não for definida no código, a configuração de nuvem do 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.
mapId	Tipo:  string optional O ID do mapa. Este parâmetro não pode ser definido ou alterado depois que um mapa é instanciado. Map.DEMO_MAP_ID pode ser usada para testar recursos que exigem um ID de mapa, mas que não precisam de ativação da nuvem. Atributo HTML: <gmp-map map-id="string"></gmp-map>
renderingType	Tipo:  RenderingType optional Padrão:RenderingType.VECTOR Define se o mapa deve ser rasterizado ou vetorial. Este parâmetro não pode ser definido ou alterado depois que um mapa é instanciado. Se ela não for definida, a configuração de nuvem do 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, e o mapa voltará a ser rasterizado conforme necessário. Atributo HTML: <gmp-map rendering-type="vector"></gmp-map> <gmp-map rendering-type="raster"></gmp-map>
tiltInteractionDisabled	Tipo:  boolean optional Padrão:false Define se o mapa deve permitir que o usuário controle a inclinação da câmera. Essa opção só funciona quando o mapa é vetorial. Se não for definida no código, a configuração de nuvem do 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 de zoom máximo aceito. Valores de zoom maiores correspondem a uma resolução mais alta. Atributo HTML: <gmp-map zoom="number"></gmp-map>

Slots
control-block-end-inline-center	Coloca o elemento com espaço na posição ControlPosition.BLOCK_END_INLINE_CENTER.
control-block-end-inline-end	Coloca o elemento com espaço na posição ControlPosition.BLOCK_END_INLINE_END.
control-block-end-inline-start	Coloca o elemento com espaço na posição ControlPosition.BLOCK_END_INLINE_START.
control-block-start-inline-center	Coloca o elemento com espaço na posição ControlPosition.BLOCK_START_INLINE_CENTER.
control-block-start-inline-end	Coloca o elemento com espaço na posição ControlPosition.BLOCK_START_INLINE_END.
control-block-start-inline-start	Coloca o elemento com espaço na posição ControlPosition.BLOCK_START_INLINE_START.
control-inline-end-block-center	Coloca o elemento com espaço na posição ControlPosition.INLINE_END_BLOCK_CENTER.
control-inline-end-block-end	Coloca o elemento com espaço na posição ControlPosition.INLINE_END_BLOCK_END.
control-inline-end-block-start	Coloca o elemento com espaço na posição ControlPosition.INLINE_END_BLOCK_START.
control-inline-start-block-center	Coloca o elemento com espaço na posição ControlPosition.INLINE_START_BLOCK_CENTER.
control-inline-start-block-end	Coloca o elemento com espaço na posição ControlPosition.INLINE_START_BLOCK_END.
control-inline-start-block-start	Coloca o elemento com espaço na posição ControlPosition.INLINE_START_BLOCK_START.
default	É possível criar componentes reutilizáveis em torno dos componentes da Web do Maps JavaScript, como AdvancedMarkerElement, usando elementos personalizados. Por padrão, todos os elementos personalizados adicionados diretamente ao MapElement serão alocados e renderizados no MapPanes.overlayMouseTarget. No entanto, os componentes da Web da API Maps JavaScript podem ser inseridos novamente nos slots internos do MapElement.

Métodos
addEventListener	Aviso:disponível apenas no canal v=beta. addEventListener(type, listener[, options]) Parâmetros:  type:  string é uma string que diferencia maiúsculas de minúsculas que 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 as opções. Eventos personalizados são compatíveis apenas 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
removeEventListener	Aviso:disponível apenas no canal v=beta. removeEventListener(type, listener[, options]) Parâmetros:  type:  string uma string que especifica o tipo de evento do qual um listener de eventos será removido. listener:  EventListener|EventListenerObject o listener de eventos do manipulador de eventos a ser removido do destino de evento. options:  boolean|EventListenerOptions optional Consulte as opções Valor de retorno:  void Remove um listener de eventos registrado anteriormente com addEventListener do destino. Consulte removeEventListener

Eventos
gmp-zoomchange	function(event) Argumentos:  event:  ZoomChangeEvent Este evento é acionado quando a propriedade de zoom do mapa é alterada.

MapElementOptions interface

google.maps.MapElementOptions interface

Aviso:disponível apenas no canal v=beta.

Objeto MapElementOptions usado para definir as propriedades que podem ser definidas em um MapElement.

Propriedades
center optional	Tipo:  LatLng|LatLngLiteral optional Consulte MapElement.center.
headingInteractionDisabled optional	Tipo:  boolean optional Consulte MapElement.headingInteractionDisabled.
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.

ZoomChangeEvent aula

Classe google.maps.ZoomChangeEvent

Aviso:disponível apenas no canal v=beta.

Esse evento é criado a partir do monitoramento de alteração de zoom.

Essa classe estende Event:

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

MapTypeStyle interface

google.maps.MapTypeStyle interface

O MapTypeStyle é um conjunto de seletores e estilizadores que definem como o mapa deve ser estilizado. Os seletores especificam os elementos e/ou os elementos do mapa que devem ser afetados, e os estilizadores especificam como esses elementos e elementos devem ser modificados. Para mais detalhes, consulte a referência de estilo.

Propriedades
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 em que são especificadas nessa matriz. Para orientações sobre uso e 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 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 ver detalhes de uso e valores permitidos, consulte a referência de estilo.
featureType optional	Tipo:  string optional O elemento ou grupo de elementos ao qual um estilizador deve ser aplicado. Opcional. Se featureType não for especificado, o valor será 'all'. Para ver detalhes de uso e valores permitidos, consulte a referência de estilo.

MapMouseEvent interface

google.maps.MapMouseEvent interface

Esse objeto é retornado de diversos eventos do mouse no mapa e de sobreposições, e contém todos os campos mostrados abaixo.

Propriedades
domEvent	Tipo:  MouseEvent|TouchEvent|PointerEvent|KeyboardEvent|Event 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 não devem depender também da estrutura DOM da implementação interna da API do Google Maps. Devido ao mapeamento de eventos interno, o domEvent pode ter uma semântica diferente do MapMouseEvent (por exemplo, um "clique" MapMouseEvent pode ter um domEvent do tipo KeyboardEvent).
latLng optional	Tipo:  LatLng optional A latitude/longitude que estava abaixo do cursor quando ocorreu o evento.

Métodos
stop	stop() Parâmetros: nenhum Valor de retorno:  void Evita que esse evento se propague ainda mais.

IconMouseEvent interface

google.maps.IconMouseEvent interface

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

Essa interface estende MapMouseEvent:

Propriedades
placeId optional	Tipo:  string optional O ID do local que foi clicado. Esse ID de lugar pode ser usado para consultar mais informações sobre o elemento que foi clicado. Saiba mais sobre IDs de local no guia para desenvolvedores da API Places.
Herdado: domEvent, latLng

Métodos
Herdado: stop

ColorScheme constantes

google.maps.ColorScheme constantes

Aviso:disponível apenas no canal v=beta.

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

Acesse chamando const {ColorScheme} = await google.maps.importLibrary("core"). Consulte Bibliotecas na API Maps JavaScript.

Constantes
DARK	O esquema de cores escuras de um mapa.
FOLLOW_SYSTEM	O esquema de cores é selecionado com base nas preferências do sistema.
LIGHT	O esquema de cores da luz de um mapa. Valor padrão do Maps JS legado.

MapTypeId constantes

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.

Acesse chamando const {MapTypeId} = await google.maps.importLibrary("maps"). Consulte Bibliotecas na API Maps JavaScript.

Constantes
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.

MapTypeRegistry aula

Classe google.maps.MapTypeRegistry

Um registro para instâncias de MapType, codificadas por ID de MapType.

Essa classe estende MVCObject:

Acesse chamando const {MapTypeRegistry} = await google.maps.importLibrary("maps"). Consulte Bibliotecas na API Maps JavaScript.

Construtor
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 mapa disponíveis nos controles, por exemplo.

Métodos
set	set(id, mapType) Parâmetros:  id:  string identificador do tipo de mapa a ser adicionado ao registro. mapType:  MapType|* objeto 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

MapRestriction interface

google.maps.MapRestriction interface

Uma restrição que pode ser aplicada ao mapa. A janela de visualização do mapa não excederá essas restrições.

Propriedades
latLngBounds	Tipo:  LatLngBounds|LatLngBoundsLiteral Quando definida, um usuário só pode movimentar e aplicar zoom dentro dos limites especificados. Os limites podem restringir a longitude e a latitude ou somente 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 Os limites podem ser mais restritivos definindo a flag strictBounds como true. Isso reduz até que ponto 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 diminuir o zoom até que toda a área limitada fique visível, possivelmente incluindo áreas fora da área limitada.

TrafficLayer aula

Classe google.maps.TrafficLayer

Uma camada para dados do trânsito.

Essa classe estende MVCObject:

Acesse chamando const {TrafficLayer} = await google.maps.importLibrary("maps"). Consulte Bibliotecas na API Maps JavaScript.

Construtor
TrafficLayer	TrafficLayer([opts]) Parâmetros:  opts:  TrafficLayerOptions optional Uma camada que exibe o trânsito atual da estrada.

Métodos
getMap	getMap() Parâmetros: nenhum Valor de retorno:  Map Retorna o mapa no qual esta camada é exibida.
setMap	setMap(map) Parâmetros:  map:  Map 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:  options:  TrafficLayerOptions Valor de retorno: nenhum
Herdado: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

TrafficLayerOptions interface

google.maps.TrafficLayerOptions interface

Objeto TrafficLayerOptions usado para definir as propriedades que podem ser definidas em um TrafficLayer.

Propriedades
autoRefresh optional	Tipo:  boolean optional Padrão:true Se a camada de trânsito é atualizada automaticamente com informações atualizadas.
map optional	Tipo:  Map optional Mapa no qual exibir a camada de trânsito.

TransitLayer aula

Classe google.maps.TransitLayer

Uma camada de transporte público.

Essa classe estende MVCObject:

Acesse chamando const {TransitLayer} = await google.maps.importLibrary("maps"). Consulte Bibliotecas na API Maps JavaScript.

Construtor
TransitLayer	TransitLayer() Parâmetros: nenhum Uma camada que exibe linhas de transporte público.

Métodos
getMap	getMap() Parâmetros: nenhum Valor de retorno:  Map Retorna o mapa no qual esta camada é exibida.
setMap	setMap(map) Parâmetros:  map:  Map Valor de retorno: nenhum 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

BicyclingLayer aula

Classe google.maps.BicyclingLayer

Uma camada que mostra ciclovias.

Essa classe estende MVCObject:

Acesse chamando const {BicyclingLayer} = await google.maps.importLibrary("maps"). Consulte Bibliotecas na API Maps JavaScript.

Construtor
BicyclingLayer	BicyclingLayer() Parâmetros: nenhum Uma camada que exibe ciclovias e evita grandes estradas.

Métodos
getMap	getMap() Parâmetros: nenhum Valor de retorno:  Map Retorna o mapa no qual esta camada é exibida.
setMap	setMap(map) Parâmetros:  map:  Map Valor de retorno: nenhum 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

CameraOptions interface

google.maps.CameraOptions interface

Aviso:disponível apenas no canal v=beta.

Usado para definir as opções de câmera do mapa.

Propriedades
center optional	Tipo:  LatLngLiteral|LatLng optional
heading optional	Tipo:  number optional
tilt optional	Tipo:  number optional
zoom optional	Tipo:  number optional

VisibleRegion interface

google.maps.VisibleRegion interface

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.

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

RenderingType constantes

google.maps.RenderingType constantes

Acesse chamando const {RenderingType} = await google.maps.importLibrary("maps"). Consulte Bibliotecas na API Maps JavaScript.

Constantes
RASTER	Indica que o mapa é rasterizado.
UNINITIALIZED	Indica que ainda não se sabe se o mapa é vetorial ou rasterizado, porque a inicialização dele ainda não foi concluída.
VECTOR	Indica que o mapa é vetorial.

MapCapabilities interface

google.maps.MapCapabilities interface

Objeto que contém um instantâneo de quais recursos estão disponíveis no momento para o mapa. Isso não significa necessariamente que os módulos relevantes foram carregados ou inicializados, mas que o mapa atual tem permissão para usar essas APIs. Consulte as propriedades para obter uma lista de possíveis capacidades.

Propriedades
isAdvancedMarkersAvailable optional	Tipo:  boolean optional Se verdadeiro, este mapa está configurado corretamente para permitir o uso de Marcadores Avançados. Você ainda precisa importar a biblioteca marker para usar os Marcadores Avançados. Consulte https://goo.gle/gmp-isAdvancedMarkersAvailable para ver mais informações.
isDataDrivenStylingAvailable optional	Tipo:  boolean optional Se verdadeiro, este mapa é configurado corretamente para permitir o uso de estilo baseado em dados para pelo menos um FeatureLayer. Para mais informações, consulte https://goo.gle/gmp-data-driven-styling e https://goo.gle/gmp-FeatureLayerIsAvailable.
isWebGLOverlayViewAvailable optional	Tipo:  boolean optional Se for "true", o mapa será configurado corretamente para permitir o uso de WebGLOverlayView.