Esta página foi traduzida pela API Cloud Translation.

Maps

Classe Map

Classe google.maps.Map

Essa classe estende MVCObject.

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

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 informado, 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 de mapa não foi criado para uso em aplicativos de produção e não pode ser usado em recursos que exigem configuração na nuvem, como a estilização na nuvem.

Propriedades
`controls`	Tipo:`Array<MVCArray<HTMLElement>>` Controles adicionais a serem anexados ao mapa. Para adicionar um controle ao mapa, inclua o `<div>` do controle no `MVCArray` correspondente ao `ControlPosition` em que ele deve ser renderizado.
`data`	Tipo:`Data` Uma instância de `Data` vinculada ao mapa. Adicione recursos a esse objeto `Data` para mostrá-los convenientemente no mapa.
`mapTypes`	Tipo:`MapTypeRegistry` Um registro de instâncias `MapType` por ID de string.
`overlayMapTypes`	Tipo:`MVCArray<MapType optional>` Tipos de mapa adicionais a serem superpostos. Os tipos de mapa de sobreposição aparecem sobre o mapa base em que estão anexados, na ordem em que aparecem na matriz `overlayMapTypes`. As sobreposições com valores de índice mais altos aparecem na frente das sobreposições com valores de índice menores.

Métodos
`fitBounds`	`fitBounds(bounds[, padding])` Parâmetros: `bounds`: limites de `LatLngBounds\|LatLngBoundsLiteral` a serem mostrados. `padding`: `number\|Padding optional` padding em pixels. Os limites serão ajustados na parte do mapa que permanecer após a remoção do padding. Um valor numérico vai gerar o mesmo padding nos quatro lados. Forneça 0 aqui para tornar um fitBounds idempotente no resultado de getBounds. Valor de retorno:nenhum Define a janela de visualização para que contenha os limites fornecidos. Observação:quando o mapa é definido como `display: none`, a função `fitBounds` lê o tamanho do mapa como 0x0 e, portanto, não faz nada. Para mudar a janela de visualização enquanto o mapa está oculto, defina o mapa como `visibility: hidden`. Assim, a div do mapa terá um tamanho real. Para mapas vetoriais, esse método define a inclinação e o rumo do mapa como os valores padrão zero. Chamar esse método pode causar uma animação suave à medida que o mapa faz uma transição e um zoom para se ajustar aos limites. A animação desse método depende de uma heurística interna.
`getBounds`	`getBounds()` Parâmetros:nenhum Valor de retorno:`LatLngBounds\|undefined` os limites de latitude/longitude da janela de visualização atual. Retorna os limites de latitude/longitude da janela de visualização atual. Se mais de uma cópia do mundo estiver visível, o intervalo de limites em longitude será de -180 a 180 graus, inclusive. Se o mapa ainda não tiver sido inicializado ou se o centro e o zoom não tiverem sido definidos, o resultado será `undefined`. Para mapas vetoriais com inclinação ou orientação diferentes de zero, os limites de latitude/longitude retornados representam a menor caixa delimitadora que inclui a região visível da janela de visualização do mapa. Consulte `MapCanvasProjection.getVisibleRegion` para saber a região visível exata da janela de visualização do mapa.
`getCenter`	`getCenter()` Parâmetros:nenhum Valor de retorno:`LatLng\|undefined` Retorna a posição mostrada no centro do mapa. O objeto `LatLng` não está encapsulado. Consulte `LatLng` para saber mais. Se o centro ou os limites não tiverem sido definidos, o resultado será `undefined`.
`getClickableIcons`	`getClickableIcons()` Parâmetros:nenhum Valor de retorno:`boolean\|undefined` Retorna a capacidade de clicar nos ícones do mapa. Um ícone de mapa representa um ponto de interesse, também conhecido como PDI. Se o valor retornado for `true`, os ícones serão clicáveis no mapa.
`getDatasetFeatureLayer`	Aviso:disponível apenas no canal v=beta. `getDatasetFeatureLayer(datasetId)` Parâmetros: `datasetId`: `string` Valor de retorno:`FeatureLayer` Retorna o `FeatureLayer` do `datasetId` especificado. Os IDs de conjuntos de dados precisam ser configurados no console do Google Cloud. Se o ID do conjunto de dados não estiver associado ao estilo do mapa ou se o estilo baseado em dados não estiver disponível (sem ID do mapa, sem blocos vetoriais, sem camadas de recursos de estilo baseado em dados ou conjuntos de dados configurados no estilo do mapa), um erro será registrado, e o `FeatureLayer.isAvailable` resultante será falso.
`getDiv`	`getDiv()` Parâmetros:nenhum Valor de retorno:`HTMLElement` o mapDiv do mapa.
`getFeatureLayer`	`getFeatureLayer(featureType)` Parâmetros: `featureType`: `FeatureType` Valor de retorno:`FeatureLayer` Retorna o `FeatureLayer` do `FeatureType` específico. Um `FeatureLayer` precisa ser ativado no console do Google Cloud. Se um `FeatureLayer` do `FeatureType` especificado não existir no mapa ou se o estilo baseado em dados não estiver disponível (sem ID do mapa, sem blocos vetoriais e sem `FeatureLayer` ativado no estilo do mapa), isso vai registrar um erro, e o `FeatureLayer.isAvailable` resultante será falso.
`getHeading`	`getHeading()` Parâmetros:nenhum Valor de retorno:`number\|undefined` Retorna a bússola do mapa. O valor da orientação é medido em graus (sentido horário) a partir da direção cardeal norte. Se o mapa ainda não tiver sido inicializado, o resultado será `undefined`.
`getHeadingInteractionEnabled`	`getHeadingInteractionEnabled()` Parâmetros:nenhum Valor de retorno:`boolean\|null` Retorna se as interações de cabeçalho estão ativadas. Essa opção só entra em vigor quando o mapa é vetorial. Se não estiver definido no código, a configuração da nuvem para o ID do mapa será usada (se disponível).
`getInternalUsageAttributionIds`	`getInternalUsageAttributionIds()` Parâmetros:nenhum Valor de retorno:`Iterable<string>\|null` Retorna a lista de IDs de atribuição de uso, que ajudam o Google a entender quais bibliotecas e amostras são úteis para os desenvolvedores, como o uso de uma biblioteca de clustering de marcadores.
`getMapCapabilities`	`getMapCapabilities()` Parâmetros:nenhum Valor de retorno:`MapCapabilities` Informa ao caller os recursos disponíveis no mapa com base no ID fornecido.
`getMapTypeId`	`getMapTypeId()` Parâmetros:nenhum Valor de retorno:`MapTypeId\|string\|undefined`
`getProjection`	`getProjection()` Parâmetros:nenhum Valor de retorno:`Projection\|undefined` Retorna o `Projection` atual. Se o mapa ainda não tiver sido inicializado, o resultado será `undefined`. Detecte o evento `projection_changed` e verifique o valor dele para garantir que não seja `undefined`.
`getRenderingType`	`getRenderingType()` Parâmetros:nenhum Valor de retorno:`RenderingType` Retorna o RenderingType atual do mapa.
`getStreetView`	`getStreetView()` Parâmetros:nenhum Valor de retorno:`StreetViewPanorama` o panorama vinculado ao mapa. Retorna o `StreetViewPanorama` padrão vinculado ao mapa, que pode ser um panorama padrão incorporado ao mapa ou o panorama definido usando `setStreetView()`. As mudanças no `streetViewControl` do mapa serão refletidas na exibição de um panorama vinculado.
`getTilt`	`getTilt()` Parâmetros:nenhum Valor de retorno:`number\|undefined` Retorna o ângulo de incidência atual do mapa, em graus do plano da janela de visualização para o plano do mapa. Para mapas raster, o resultado será `0` para imagens capturadas diretamente acima ou `45` para imagens em 45°. Esse método não retorna o valor definido por `setTilt`. Consulte `setTilt` para mais detalhes.
`getTiltInteractionEnabled`	`getTiltInteractionEnabled()` Parâmetros:nenhum Valor de retorno:`boolean\|null` Retorna se as interações de inclinação estão ativadas. Essa opção só entra em vigor quando o mapa é vetorial. Se não estiver definido no código, a configuração da nuvem para o ID do mapa será usada (se disponível).
`getZoom`	`getZoom()` Parâmetros:nenhum Valor de retorno:`number\|undefined` Retorna o zoom do mapa. Se o zoom não tiver sido definido, o resultado será `undefined`.
`moveCamera`	`moveCamera(cameraOptions)` Parâmetros: `cameraOptions`: `CameraOptions` Valor de retorno:nenhum Define imediatamente as opções de câmera de destino para a câmera do mapa, sem animação.
`panBy`	`panBy(x, y)` Parâmetros: `x`: `number` número de pixels para mover o mapa na direção x. `y`: `number` número de pixels para mover o mapa na direção y. Valor de retorno:nenhum Altera o centro do mapa de acordo com a distância especificada em pixels. Se a distância for menor do que a largura e a altura do mapa, a transição será animada suavemente. O sistema de coordenadas do mapa aumenta do oeste para o leste (para valores x) e do norte para o sul (para valores y).
`panTo`	`panTo(latLng)` Parâmetros: `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 mover o mapa. `padding`: `number\|Padding optional` padding em pixels. Um valor numérico vai gerar o mesmo padding nos quatro lados. O valor padrão é 0. Valor de retorno:nenhum Move o mapa pela quantidade mínima necessária para conter o `LatLngBounds` especificado. Não há garantia de onde os limites vão ficar no mapa, exceto que o mapa será movido para mostrar o máximo possível dos limites dentro de `{currentMapSizeInPx} - {padding}`. Para mapas rasterizados e vetoriais, o zoom, a inclinação e a direção do mapa não serão alterados.
`setCenter`	`setCenter(latlng)` Parâmetros: `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 capacidade de clicar nos ícones do mapa, transmita um valor de `false` para esse método.
`setHeading`	`setHeading(heading)` Parâmetros: `heading`: `number` Valor de retorno:nenhum Define a direção da bússola para o mapa, medida em graus a partir da direção cardeal norte. Para mapas rasterizados, esse método só se aplica a imagens aéreas.
`setHeadingInteractionEnabled`	`setHeadingInteractionEnabled(headingInteractionEnabled)` Parâmetros: `headingInteractionEnabled`: `boolean` Valor de retorno:nenhum Define se as interações de cabeçalho estão ativadas. Essa opção só entra em vigor quando o mapa é vetorial. Se não estiver definido no código, a configuração da nuvem para o ID do mapa será usada (se disponível).
`setMapTypeId`	`setMapTypeId(mapTypeId)` Parâmetros: `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. Esse panorama substitui o `StreetViewPanorama` padrão, permitindo que o mapa seja vinculado a um panorama externo fora dele. Definir o panorama como `null` vincula o panorama incorporado padrão de volta ao mapa.
`setTilt`	`setTilt(tilt)` Parâmetros: `tilt`: `number` Valor de retorno:nenhum Para mapas vetoriais, define o ângulo de incidência do mapa. Os valores permitidos são restritos dependendo do nível de zoom do mapa. Para mapas rasterizados, controla o comportamento de troca automática do ângulo de incidência do mapa. Os únicos valores permitidos são `0` e `45`. `setTilt(0)` faz com que o mapa sempre use uma visualização aérea de 0°, independente do nível de zoom e da janela de visualização. `setTilt(45)` faz com que o ângulo de inclinação mude automaticamente para 45 sempre que imagens em 45° estiverem disponíveis para o nível de zoom e a janela de visualização atuais, e volte para 0 quando não estiverem disponíveis (esse é o comportamento padrão). As imagens em 45° estão disponíveis apenas para os tipos de mapa `satellite` e `hybrid`, em alguns locais e níveis de zoom. Observação:`getTilt` retorna o ângulo de inclinação atual, não o valor definido por `setTilt`. Como `getTilt` e `setTilt` se referem a coisas diferentes, não `bind()` a propriedade `tilt`. Isso pode gerar efeitos imprevisíveis.
`setTiltInteractionEnabled`	`setTiltInteractionEnabled(tiltInteractionEnabled)` Parâmetros: `tiltInteractionEnabled`: `boolean` Valor de retorno:nenhum Define se as interações de inclinação estão ativadas. Essa opção só entra em vigor quando o mapa é vetorial. Se não estiver definido no código, a configuração da nuvem para o ID do mapa será usada (se disponível).
`setZoom`	`setZoom(zoom)` Parâmetros: `zoom`: `number`. Valores de zoom maiores correspondem a uma resolução mais alta. Valor de retorno:nenhum Define o zoom do mapa.
Herdado:`addListener`, `bindTo`, `get`, `notify`, `set`, `setValues`, `unbind`, `unbindAll`

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` Esse evento é acionado quando o usuário clica no mapa. Um MapMouseEvent com propriedades para o local clicado é retornado, a menos que um ícone de lugar tenha sido clicado. Nesse caso, um IconMouseEvent com um ID de lugar é retornado. IconMouseEvent e MapMouseEvent são idênticos, exceto que IconMouseEvent tem o campo ID do lugar. O evento sempre pode ser tratado como um MapMouseEvent quando o ID do lugar não é importante. O evento de clique não é disparado se um marcador ou uma janela de informações for clicado.
`contextmenu`	`function(event)` Argumentos: `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. Às vezes, o evento de clique é acionado uma vez e, às vezes, duas vezes, logo antes deste.
`drag`	`function()` Argumentos: nenhum Este evento é disparado repetidamente enquanto o usuário arrasta o mapa.
`dragend`	`function()` Argumentos: nenhum Este evento é acionado quando o usuário para de arrastar o mapa. Observação: o evento "dragend" NÃO é disparado quando o usuário para de mover o mapa usando o teclado. Use o evento `Map.idle` para determinar quando o usuário parou de movimentar ou arrastar o mapa.
`dragstart`	`function()` Argumentos: nenhum Este evento é acionado quando o usuário começa a arrastar o mapa.
`heading_changed`	`function()` Argumentos: nenhum Este evento é acionado quando a propriedade de orientação do mapa é alterada.
`idle`	`function()` Argumentos: nenhum Este evento é disparado quando o mapa fica inativo após sofrer um deslocamento ou alteração de zoom.
`isfractionalzoomenabled_changed`	`function()` Argumentos: nenhum Esse evento é disparado quando a propriedade "isFractionalZoomEnabled" muda.
`mapcapabilities_changed`	`function()` Argumentos: nenhum Esse evento é disparado quando as funcionalidades do mapa mudam.
`maptypeid_changed`	`function()` Argumentos: nenhum Este evento é disparado quando a propriedade mapTypeId é alterada.
`mousemove`	`function(event)` Argumentos: `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 Esse evento é disparado quando o renderingType muda.
`tilesloaded`	`function()` Argumentos: nenhum Este evento é disparado quando os blocos visíveis são totalmente carregados.

Maps Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Classe Map

Construtor

Constantes

Propriedades

Métodos

Eventos

Maps