Em breve, a Plataforma Google Maps usará a nova estilização de mapas. Essa atualização inclui uma nova paleta de cores padrão e melhorias nas experiências de mapa e na usabilidade. Todos os estilos de mapa serão atualizados automaticamente em março de 2025. Para mais informações sobre a disponibilidade e como ativar logo, consulte Novo estilo de mapa para a Plataforma Google Maps.

Esta página foi traduzida pela API Cloud Translation.

Maps

Classe Map

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, normalmente um elemento `DIV`.

Constantes
`DEMO_MAP_ID`	ID do mapa que pode ser usado para exemplos de código que exigem um ID. Esse ID de mapa não é destinado a 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>` ao `MVCArray` correspondente ao `ControlPosition` em que ele precisa ser renderizado.
`data`	Tipo:`Data` Uma instância de `Data`, vinculada ao mapa. Adicione recursos a este objeto `Data` para mostrá-los neste mapa de maneira conveniente.
`mapTypes`	Tipo:`MapTypeRegistry` Um registro de instâncias de `MapType` por ID de string.
`overlayMapTypes`	Tipo:`MVCArray<MapType optional>` Tipos de mapa adicionais a serem superpostos. Os tipos de mapa de sobreposição são exibidos sobre o mapa de base 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 para exibição. `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 produz o mesmo preenchimento 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 mudar 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. Em mapas vetoriais, esse método define a inclinação e a direção do mapa com seus valores padrão zero. Chamar esse método pode gerar 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 do mundo estiver visível, os limites vão variar de longitude de -180 a 180 graus. Se o mapa ainda não tiver sido inicializado ou centralizado e o zoom não tiver sido definido, o resultado será `undefined`. Para mapas vetoriais com inclinação ou direção diferente de zero, os limites de lat/lng 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 é unido. 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 serão clicáveis no mapa.
`getDatasetFeatureLayer`	Aviso:disponível apenas no canal v=beta. `getDatasetFeatureLayer(datasetId)` Parâmetros: `datasetId`: `string` Valor de retorno:`FeatureLayer` Retorna `FeatureLayer` para o `datasetId` especificado. Os IDs dos conjuntos de dados precisam ser configurados no Console do Google Cloud. Se o ID do conjunto de dados não estiver associado ao estilo de mapa do mapa ou se o estilo orientado a dados não estiver disponível (sem ID do mapa, blocos vetoriais, camadas de elementos de estilo orientado a dados ou conjuntos de dados configurados no estilo), o 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: `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 no mapa ou se o estilo orientado a dados não estiver disponível (nenhum ID do mapa, blocos vetoriais e nenhum `FeatureLayer` ativado no estilo de mapa), um erro será registrado, 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`.
`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 do mapa 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 ele não é `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 limite `StreetViewPanorama` padrão do 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 limite.
`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 ao plano do mapa. Para mapas rasterizados, o resultado será `0` para imagens tiradas diretamente acima ou `45` para imagens em 45°. Esse método não retorna o valor definido por `setTilt`. Acesse `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: `cameraOptions`: `CameraOptions` Valor de retorno: nenhum Define imediatamente a câmera do mapa 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. `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 produz o mesmo preenchimento nos quatro lados. O valor padrão é 0. Valor de retorno: nenhum Move o mapa de acordo com o valor mínimo necessário para conter o `LatLngBounds` especificado. Ele não garante a localização dos limites no mapa, mas é deslocado para mostrar o máximo de limites possível em `{currentMapSizeInPx} - {padding}`. Nos mapas vetoriais e rasterizados, o zoom, a inclinação e a direção do mapa 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 `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.
`setMapTypeId`	`setMapTypeId(mapTypeId)` Parâmetros: `mapTypeId`: `MapTypeId\|string` Valor de retorno: nenhum
`setOptions`	`setOptions(options)` Parâmetros: `options`: `MapOptions optional` Valor de retorno: nenhum
`setStreetView`	`setStreetView(panorama)` Parâmetros: `panorama`: `StreetViewPanorama optional` o panorama que 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 dele. Definir o panorama como `null` vincula novamente o panorama incorporado padrão 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. Em mapas de varredura, controla o comportamento de alternância 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 de 0° de cima, 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 mude de volta para 0 sempre que essas imagens 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 em 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 aplique `bind()` na propriedade `tilt`. Fazer isso pode gerar efeitos imprevisíveis.
`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 local tenha sido clicado. Nesse caso, um IconMouseEvent com um ID de local é retornado. IconMouseEvent e MapMouseEvent são idênticos, exceto que IconMouseEvent tem o campo de ID de lugar. O evento sempre pode ser tratado como um MapMouseEvent quando o ID de lugar não é importante. O evento de clique não será disparado se um marcador ou uma janela de informações for 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 ou duas vezes 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 foi 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 renderizadorType é 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 com a tecla Ctrl pressionada no macOS. `function(event)` Argumentos: `event`: `MapMouseEvent` Este evento é disparado quando o usuário clica com o botão direito no mapa.

Interface MapOptions

Interface google.maps.MapOptions

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

Propriedades
`backgroundColor optional`	Tipo:`string optional` Cor usada para o plano de fundo do div do mapa. Esta 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 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 durante a criação do mapa. Atualizar esse valor posteriormente pode deixar os controles para o estado `undefined`. Rege apenas os controles feitos pela própria API Maps. Não dimensiona 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, use a propriedade `gestureHandling` e a defina 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 definido como `false`, evita que o mapa seja arrastado. O recurso de arrastar está ativado por padrão.
`draggableCursor optional`	Tipo:`string optional` O nome ou o URL do cursor que será exibido quando você passar o mouse sobre um mapa arrastável. Essa propriedade usa o atributo css `cursor` 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` O nome ou o URL do cursor que será exibido quando o mapa estiver sendo arrastado. Essa propriedade usa o atributo css `cursor` 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`	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 processa gestos no mapa. Valores permitidos: `"cooperative"`: eventos de rolagem e gestos de toque com um dedo rolam a página sem ampliar nem movimentar o mapa. Gestos de toque com dois dedos movimentam e aplicam zoom ao mapa. Os eventos de rolagem com uma tecla Ctrl ou ⌘ pressionada para aplicar zoom ao 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 deslocado nem 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.
`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 for `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. Esse 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 de zoom máximo compatível.
`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 compatível.
`noClear optional`	Tipo:`boolean optional` Se for `true`, não limpe o conteúdo do div do mapa.
`panControl optional`	Descontinuado:o controle "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 "Panorâmica" foi descontinuado em setembro de 2015. Tipo:`PanControlOptions optional` As opções de exibição do controle de panorâmica.
`restriction optional`	Tipo:`MapRestriction optional` Define um limite que restringe a área do mapa acessível aos usuários. Quando definido, o 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 for `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` que vai ser exibido quando o Pegman do Street View for 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 precisa ser definido como `false` ao exibir um tipo de mapa em que a sobreposição de estrada do Street View não deve aparecer (por exemplo, um tipo de mapa que não seja o 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. Nos modos `satellite`/`hybrid` e `terrain`, esses estilos são aplicados apenas às etiquetas 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. Em mapas de varredura, controla o comportamento de alternância 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 de 0° de cima para baixo, 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 voltará para 0 sempre que essas imagens 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 em 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 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 de zoom máximo compatível. 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.

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. 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" map-id="string" 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>`
`innerMap`	Tipo:`Map` Uma referência ao `Map` que o MapElement usa internamente.
`mapId`	Tipo:`string optional` O ID do mapa. Consulte a documentação do ID do mapa para mais informações. Atributo HTML: `<gmp-map map-id="string"></gmp-map>`
`zoom`	Tipo:`number optional` O nível de zoom do mapa. Atributo HTML: `<gmp-map zoom="number"></gmp-map>`

Slots
`control-block-end-inline-center`	Coloca o elemento com slot na posição `ControlPosition.BLOCK_END_INLINE_CENTER`.
`control-block-end-inline-end`	Coloca o elemento com slot na posição `ControlPosition.BLOCK_END_INLINE_END`.
`control-block-end-inline-start`	Coloca o elemento com slot na posição `ControlPosition.BLOCK_END_INLINE_START`.
`control-block-start-inline-center`	Coloca o elemento com slot na posição `ControlPosition.BLOCK_START_INLINE_CENTER`.
`control-block-start-inline-end`	Coloca o elemento com slot na posição `ControlPosition.BLOCK_START_INLINE_END`.
`control-block-start-inline-start`	Coloca o elemento com slot na posição `ControlPosition.BLOCK_START_INLINE_START`.
`control-inline-end-block-center`	Coloca o elemento com slot na posição `ControlPosition.INLINE_END_BLOCK_CENTER`.
`control-inline-end-block-end`	Coloca o elemento com slot na posição `ControlPosition.INLINE_END_BLOCK_END`.
`control-inline-end-block-start`	Coloca o elemento com slot na posição `ControlPosition.INLINE_END_BLOCK_START`.
`control-inline-start-block-center`	Coloca o elemento com slot na posição `ControlPosition.INLINE_START_BLOCK_CENTER`.
`control-inline-start-block-end`	Coloca o elemento com slot na posição `ControlPosition.INLINE_START_BLOCK_END`.
`control-inline-start-block-start`	Coloca o elemento com slot na posição `ControlPosition.INLINE_START_BLOCK_START`.

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 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 as opções. Os 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 de que 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 as opções Valor de retorno:`void` Remove um listener de eventos registrado anteriormente com addEventListener do destino. Consulte removeEventListener

Métodos

addEventListener

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 as opções. Os 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

removeEventListener(type, listener[, options])

Parâmetros:

type: string uma string que especifica o tipo de evento de que 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 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

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

Propriedades
`center optional`	Tipo:`LatLng\|LatLngLiteral optional` O centro inicial do mapa.
`mapId optional`	Tipo:`string optional` O ID do mapa. Esse parâmetro não pode ser definido ou alterado depois que um mapa é instanciado.
`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 compatível. Valores de zoom maiores correspondem a uma resolução maior.

Classe ZoomChangeEvent

Classe google.maps.ZoomChangeEvent

Este evento é criado a partir do monitoramento da alteração do zoom.

Essa classe estende Event.

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

Interface MapTypeStyle

Interface google.maps.MapTypeStyle

O MapTypeStyle é uma coleção de seletores e estilizadores que definem como o mapa será estilizado. Os seletores especificam os recursos e/ou elementos do mapa que devem ser afetados, e os estilizadores especificam como esses 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 recursos e elementos selecionados do mapa. As regras são aplicadas na ordem que você especifica 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 styler deve ser aplicado. Um elemento é um aspecto visual de um elemento 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 detalhes de uso e valores permitidos, consulte a referência de estilo.
`featureType optional`	Tipo:`string optional` O elemento ou grupo de recursos aos quais 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.

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 também não devem confiar na estrutura DOM da implementação interna da API do Google Maps. Devido ao mapeamento interno de eventos, a `domEvent` pode ter semânticas diferentes de `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.

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 também não devem confiar na estrutura DOM da implementação interna da API do Google Maps. Devido ao mapeamento interno de eventos, a domEvent pode ter semânticas diferentes de 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` Impede que esse evento se propague.

IconMouseEvent

Interface google.maps.IconMouseEvent

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

Essa interface estende MapMouseEvent.

Propriedades
`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 foi clicado. Saiba mais sobre IDs de local no guia do desenvolvedor da API Places.
Herdado: `domEvent`, `latLng`

Métodos
Herdado:`stop`

Constantes MapTypeId

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 mapas com características físicas como terreno e vegetação.

Classe MapTypeRegistry

Classe google.maps.MapTypeRegistry

Um registro para instâncias de MapType, codificada pelo ID do 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 MapType a adicionar 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 excederá essas restrições.

Propriedades
`latLngBounds`	Tipo:`LatLngBounds\|LatLngBoundsLiteral` Quando definido, um usuário só pode movimentar e aplicar zoom dentro dos limites indicados. Os limites podem restringir a longitude e a latitude, ou apenas a latitude. Para limites apenas 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` Para tornar os limites mais restritivos, defina a sinalização `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 diminuir o zoom até que toda a área limitada fique visível, possivelmente incluindo áreas fora dela.

Propriedades

latLngBounds

Tipo:LatLngBounds|LatLngBoundsLiteral

Quando definido, um usuário só pode movimentar e aplicar zoom dentro dos limites indicados. Os limites podem restringir a longitude e a latitude, ou apenas a latitude. Para limites apenas 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

Para tornar os limites mais restritivos, defina a sinalização 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 diminuir o zoom até que toda a área limitada fique 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 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

O objeto TrafficLayerOptions usado para definir as propriedades que podem ser definidas em uma TrafficLayer.

Propriedades
`autoRefresh optional`	Tipo:`boolean optional` Padrão:`true` Define 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.

Classe TransitLayer

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`

Classe BicyclingLayer

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`

Interface CameraOptions

Interface google.maps.CameraOptions

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`

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

Constantes RenderingType

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 é de varredura.
`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

Objeto contendo um snapshot das capacidades 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 uma lista de possíveis recursos.

Propriedades
`isAdvancedMarkersAvailable optional`	Tipo:`boolean optional` Se verdadeiro, o mapa será configurado corretamente para permitir o uso de marcadores avançados. Ainda é 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 verdadeiro, o mapa será configurado corretamente para permitir o uso do estilo orientado a dados em pelo menos um FeatureLayer. Para mais informações, consulte https://goo.gle/gmp-data-driven-styling e https://goo.gle/gmp-FeatureLayerIsAvailable.

Maps

Classe Map

Construtor

Constantes

Propriedades

Métodos

Eventos

Interface MapOptions

Propriedades

Classe MapElement

Construtor

Propriedades

Slots

Métodos

Eventos

MapElementOptions

Propriedades

Classe ZoomChangeEvent

Interface MapTypeStyle

Propriedades

Interface MapMouseEvent

Propriedades

Métodos

IconMouseEvent

Propriedades

Métodos

Constantes MapTypeId

Constantes

Classe MapTypeRegistry

Construtor

Métodos

Interface MapRestriction

Propriedades

Classe TrafficLayer

Construtor

Métodos

TrafficLayerOptions

Propriedades

Classe TransitLayer

Construtor

Métodos

Classe BicyclingLayer

Construtor

Métodos

Interface CameraOptions

Propriedades

Interface VisibleRegion

Propriedades

Constantes RenderingType

Constantes

MapCapabilities

Propriedades