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:
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 para exemplos de código que exigem um ID do mapa. Esse ID de mapa não é destinado a aplicativos de produção e não pode ser usado para 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, adicione o <div> do controle ao MVCArray correspondente ao ControlPosition em que ele será renderizado. |
data |
Tipo:
Data Uma instância de Data , vinculada ao mapa. Adicione elementos a esse objeto Data para exibi-los convenientemente no mapa. |
mapTypes |
Tipo:
MapTypeRegistry Um registro de instâncias MapType por ID de string. |
overlayMapTypes |
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 mais baixos. |
Métodos | |
---|---|
fitBounds |
fitBounds(bounds[, padding]) Parâmetros:
Valor de retorno:nenhum
Define a janela de visualização para que contenha os limites fornecidos. Observação:quando o mapa está 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 , garantindo que o div do mapa tenha um tamanho real. Para mapas vetoriais, esse método define a inclinação e a direção do mapa como os valores padrão de zero. A chamada desse método pode causar uma animação suave à medida que o mapa é movido e ampliado 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 lat/lng da viewport 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 em longitude de -180 a 180 graus. Se o mapa ainda não foi inicializado ou se o centro e o zoom não foram definidos, o resultado será undefined . Para mapas vetoriais com inclinação ou rumo diferentes 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 saber a região visível exata da janela de visualização do mapa. |
getCenter |
getCenter() Parâmetros:nenhum
Valor de retorno:
LatLng|undefined |
getClickableIcons |
getClickableIcons() Parâmetros:nenhum
Valor de retorno:
boolean|undefined Retorna a capacidade de clique 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 |
getDatasetFeatureLayer(datasetId) Parâmetros:
Valor de retorno:
FeatureLayer Retorna o FeatureLayer para o datasetId especificado. Os IDs de 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, sem blocos vetorial, sem camadas de elementos ou conjuntos de dados do estilo baseado em dados configurados no estilo do mapa), um erro será registrado e o FeatureLayer.isAvailable resultante será falso. |
getDiv |
getDiv() Parâmetros:nenhum
Valor de retorno:
HTMLElement O mapDiv do mapa. |
getFeatureLayer |
getFeatureLayer(featureType) Parâmetros:
Valor de retorno:
FeatureLayer Retorna o FeatureLayer do FeatureType específico. Um FeatureLayer precisa ser ativado no console do Google Cloud. Se um FeatureLayer do FeatureType especificado não existir no mapa ou se o estilo baseado em dados não estiver disponível (sem ID de mapa, sem blocos vetorial e sem FeatureLayer ativado no estilo do mapa), isso vai gerar 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 estiver inicializado, o resultado será undefined . |
getHeadingInteractionEnabled |
getHeadingInteractionEnabled() Parâmetros:nenhum
Valor de retorno:
boolean|null Retorna se as interações de título estão ativadas. Essa opção só é válida quando o mapa é vetorial. Se não for definido no código, a configuração da nuvem para o ID do mapa será usada (se disponível). |
getMapCapabilities |
getMapCapabilities() Parâmetros:nenhum
Valor de retorno:
MapCapabilities Informa ao autor da chamada 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 estiver inicializado, o resultado será undefined . Detecte o evento projection_changed e verifique o valor dele para garantir que ele 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 na streetViewControl do mapa vão ser 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 de raster, 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 Retorna se as interações de inclinação estão ativadas. Essa opção só é válida quando o mapa é vetorial. Se não for definido no código, a configuração da nuvem para o ID do mapa será usada (se disponível). |
getZoom |
getZoom() Parâmetros:nenhum
Valor de retorno:
number|undefined Retorna o zoom do mapa. Se o zoom não tiver sido definido, o resultado será undefined . |
moveCamera |
moveCamera(cameraOptions) Parâmetros:
Valor de retorno:nenhum
Define imediatamente a câmera do mapa para as opções de câmera de destino, sem animação. |
panBy |
panBy(x, y) Parâmetros:
Valor de retorno:nenhum
Altera o centro do mapa de acordo com a distância especificada em pixels. Se a distância for menor do que a largura e a altura do mapa, a transição será animada suavemente. O sistema de coordenadas do mapa aumenta do oeste para o leste (para valores x) e do norte para o sul (para valores y). |
panTo |
panTo(latLng) Parâmetros:
Valor de retorno:nenhum
Muda o centro do mapa para o LatLng fornecido. 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:
Valor de retorno:nenhum
Desloca o mapa pela quantidade mínima necessária para conter o LatLngBounds fornecido. 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} . Para mapas rasterizados e vetoriais, o zoom, a inclinação e a direção do mapa não vão mudar. |
setCenter |
setCenter(latlng) Parâmetros:
Valor de retorno:nenhum
|
setClickableIcons |
setClickableIcons(value) Parâmetros:
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 clique dos ícones do mapa, transmita um valor de false para esse método. |
setHeading |
setHeading(heading) Parâmetros:
Valor de retorno:nenhum
Define a direção da bússola para o mapa medido em graus a partir da direção cardinal Norte. Para mapas raster, esse método só se aplica a imagens aéreas. |
setHeadingInteractionEnabled |
setHeadingInteractionEnabled(headingInteractionEnabled) Parâmetros:
Valor de retorno:nenhum
Define se as interações de título estão ativadas. Essa opção só é válida quando o mapa é vetorial. Se não for definido no código, a configuração da nuvem para o ID do mapa será usada (se disponível). |
setMapTypeId |
setMapTypeId(mapTypeId) Parâmetros:
Valor de retorno:nenhum
|
setOptions |
setOptions(options) Parâmetros:
Valor de retorno:nenhum
|
setRenderingType |
setRenderingType(renderingType) Parâmetros:
Valor de retorno:nenhum
Define o RenderingType atual do mapa. |
setStreetView |
setStreetView(panorama) Parâmetros:
Valor de retorno:nenhum
Vincula um StreetViewPanorama ao mapa. Esse panorama substitui o StreetViewPanorama padrão, permitindo que o mapa seja vinculado a um panorama externo. Definir o panorama como null vincula o panorama incorporado padrão de volta ao mapa. |
setTilt |
setTilt(tilt) Parâmetros:
Valor de retorno:nenhum
Para mapas vetoriais, define o ângulo de incidência do mapa. Os valores permitidos são restritos de acordo com o nível de zoom do mapa. Para mapas de varredura, controla o comportamento de troca 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 vista 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 volte para 0 quando 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 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:
Valor de retorno:nenhum
Define se as interações de inclinação estão ativadas. Essa opção só é válida quando o mapa é vetorial. Se não for definido no código, a configuração da nuvem para o ID do mapa será usada (se disponível). |
setZoom |
setZoom(zoom) Parâmetros:
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:
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. O IconMouseEvent e o MapMouseEvent são idênticos, exceto pelo fato de o IconMouseEvent ter o campo de ID de lugar. O evento pode ser tratado como um MapMouseEvent quando o ID do lugar não é importante. O evento de clique não é acionado se um marcador ou uma janela de informações foi clicada. |
contextmenu |
function(event) Argumentos:
Este evento é disparado quando o evento contextmenu do DOM é disparado no recipiente do mapa. |
dblclick |
function(event) Argumentos:
Este evento é disparado quando o usuário clica duas vezes no mapa. Às vezes, o evento de clique é acionado uma vez e, às vezes, duas vezes, 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
Esse evento é acionado quando a propriedade isFractionalZoomEnabled muda. |
mapcapabilities_changed |
function() Argumentos: nenhum
Esse evento é acionado quando os recursos do mapa mudam. |
maptypeid_changed |
function() Argumentos: nenhum
Este evento é disparado quando a propriedade mapTypeId é alterada. |
mousemove |
function(event) Argumentos:
Este evento é disparado sempre que o mouse do usuário é movido sobre o recipiente do mapa. |
mouseout |
function(event) Argumentos:
Este evento é disparado quando o mouse do usuário é retirado do recipiente do mapa. |
mouseover |
function(event) Argumentos:
Este evento é disparado quando o mouse do usuário é colocado no recipiente do mapa. |
projection_changed |
function() Argumentos: nenhum
Este evento é disparado quando a projeção é alterada. |
renderingtype_changed |
function() Argumentos: nenhum
Esse evento é acionado quando o renderingType muda. |
tilesloaded |
function() Argumentos: nenhum
Este evento é disparado quando os blocos visíveis são totalmente carregados. |
tilt_changed |
function() Argumentos: nenhum
Este evento é acionado quando a propriedade de inclinação do mapa é alterada. |
zoom_changed |
function() Argumentos: nenhum
Este evento é acionado quando a propriedade de zoom do mapa é alterada. |
|
function(event) Argumentos:
Esse evento é acionado quando o usuário clica com o botão direito do mouse no mapa. |
Interface MapOptions
Interface
google.maps.MapOptions
Objeto MapOptions usado para definir as propriedades que podem ser definidas em um mapa.
Propriedades | |
---|---|
backgroundColor optional |
Tipo:
string optional Cor usada para o plano de fundo do div do mapa. Essa cor vai ficar visível quando os blocos ainda não forem carregados enquanto o usuário desliza. 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 |
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. Atualizar esse valor mais tarde pode levar os controles a um estado undefined . Governa 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 de interface padrão. Pode ser substituída individualmente. Não desativa os controles do teclado, que são controlados separadamente pela opção MapOptions.keyboardShortcuts . Não desativa os controles por gestos, que são controlados separadamente pela opção MapOptions.gestureHandling . |
disableDoubleClickZoom optional |
Tipo:
boolean optional Ativa/desativa o zoom e a centralização com clique duplo. Ativado por padrão. Observação: essa propriedade não é recomendada. Para desativar o zoom no duplo clique, use a propriedade |
|
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 o URL do cursor que será exibido ao passar o cursor sobre um mapa arrastável. Essa propriedade usa o atributo css cursor para mudar o ícone. Assim como na propriedade css, é necessário especificar pelo menos um cursor substituto que não seja um URL. Por exemplo, draggableCursor: 'url(http://www.example.com/icon.png), auto;' . |
draggingCursor optional |
Tipo:
string optional O nome ou 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, é 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 para o controle de tela cheia. |
gestureHandling optional |
Tipo:
string optional Essa configuração controla como a API processa gestos no mapa. Valores permitidos:
|
heading optional |
Tipo:
number optional A orientação de imagens aéreas em graus medida no sentido horário a partir da direção cardeal norte. As orientações são ajustadas para o ângulo mais próximo disponível para o qual foram disponibilizadas imagens. |
headingInteractionEnabled optional |
Tipo:
boolean optional Padrão:
false Indica se o mapa permite que o usuário controle a direção da câmera (rotação). Essa opção só é válida quando o mapa é vetorial. Se não for definido no código, a configuração da nuvem para o ID do mapa será usada (se disponível). |
isFractionalZoomEnabled optional |
Tipo:
boolean optional Padrão:
true para mapas vetoriais e false para mapas rasterDefine se o mapa precisa 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. Não é possível definir ou mudar esse parâmetro depois que um mapa é instanciado. O Map.DEMO_MAP_ID pode ser usado para testar recursos que exigem um ID de mapa, mas não precisam de ativação na nuvem. |
mapTypeControl optional |
Tipo:
boolean optional O estado inicial ativado/desativado do controle do tipo de mapa. |
mapTypeControlOptions optional |
Tipo:
MapTypeControlOptions optional As opções de exibição inicial do controle do tipo de mapa. |
mapTypeId optional |
Tipo:
MapTypeId|string optional O mapTypeId inicial do mapa. O valor padrão é ROADMAP . |
maxZoom optional |
Tipo:
number optional O nível de zoom máximo que será exibido no mapa. Se omitido ou definido como null , o zoom máximo do tipo de mapa atual será usado. Os valores de zoom válidos são números de zero até o nível máximo de zoom aceito. |
minZoom optional |
Tipo:
number optional O nível de zoom mínimo que será exibido no mapa. Se omitido ou definido como null , o zoom mínimo do tipo de mapa atual será usado. Os valores de zoom válidos são números de zero até o nível máximo de zoom aceito. |
noClear optional |
Tipo:
boolean optional Se true , não limpe o conteúdo do div do mapa. |
|
Tipo:
boolean optional O estado ativado/desativado do controle de panorâmica. |
|
Tipo:
PanControlOptions optional As opções de exibição do controle de panorâmica. |
renderingType optional |
Tipo:
RenderingType optional Padrão:
RenderingType.RASTER Indica se o mapa precisa ser rasterizado ou vetorial. Não é possível definir ou mudar esse parâmetro depois que um mapa é instanciado. Se não for definido, a configuração da nuvem para o ID do mapa vai determinar o tipo de renderização (se disponível). Os mapas vetoriais podem não estar disponíveis para todos os dispositivos e navegadores, e o mapa será substituído por um 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, o usuário só pode mover 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 |
streetView optional |
Tipo:
StreetViewPanorama optional Um StreetViewPanorama para mostrar quando o Pegman do Street View for colocado no mapa. Se nenhum panorama for especificado, um StreetViewPanorama padrão vai aparecer na div do mapa quando o Pegman for posicionado. |
streetViewControl optional |
Tipo:
boolean optional O estado ativado/desativado inicial do controle Pegman do Street View. Esse controle faz parte da interface padrão e precisa ser definido como false ao mostrar um tipo de mapa em que a sobreposição de vias do Street View não aparece (por exemplo, um tipo de mapa que não é 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ó se aplicam 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 Para mapas vetoriais, define o ângulo de incidência do mapa. Os valores permitidos são restritos de acordo com o nível de zoom do mapa. Para mapas de varredura, controla o comportamento de troca 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 vista 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 imagens em 45° estiverem disponíveis para o nível de zoom e a viewport atuais e volte para 0 quando 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 níveis de zoom. Observação:getTilt retorna o ângulo de inclinação atual, não o valor especificado por essa opção. Como getTilt e essa opção se referem a coisas diferentes, não bind() a propriedade tilt . Isso pode gerar efeitos imprevisíveis. |
tiltInteractionEnabled optional |
Tipo:
boolean optional Padrão:
false Indica se o mapa permite que o usuário controle a inclinação da câmera. Essa opção só é válida quando o mapa é vetorial. Se não for definido no código, a configuração da nuvem para o ID do mapa será usada (se disponível). |
zoom optional |
Tipo:
number optional O nível de zoom inicial do mapa. Os valores de zoom válidos são números de zero até o nível máximo de zoom aceito. Valores de zoom maiores correspondem a uma resolução 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
, é possível criar um mapa em HTML. 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>
Ele usa
Map
internamente, 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:
|
Propriedades | |
---|---|
center |
Tipo:
LatLng|LatLngLiteral optional Latitude/longitude central do mapa.
Atributo HTML:
|
headingInteractionDisabled |
Tipo:
boolean optional Padrão:
false Indica se o mapa permite que o usuário controle a direção da câmera (rotação). Essa opção só é válida quando o mapa é vetorial. Se não for definido no código, a configuração da nuvem para o ID do mapa será usada (se disponível).
Atributo HTML:
|
innerMap |
Tipo:
Map Uma referência ao Map que o MapElement usa internamente. |
mapId |
Tipo:
string optional O ID do mapa. Não é possível definir ou mudar esse parâmetro depois que um mapa é instanciado. O
Map.DEMO_MAP_ID pode ser usado para testar recursos que exigem um ID de mapa, mas não precisam de ativação na nuvem.Atributo HTML:
|
renderingType |
Tipo:
RenderingType optional Padrão:
RenderingType.VECTOR Indica se o mapa precisa ser rasterizado ou vetorial. Não é possível definir ou mudar esse parâmetro depois que um mapa é instanciado. Se não for definido, a configuração da nuvem para o ID do mapa vai determinar o tipo de renderização (se disponível). Os mapas vetoriais podem não estar disponíveis para todos os dispositivos e navegadores, e o mapa será substituído por um rasterizado conforme necessário.
Atributo HTML:
|
tiltInteractionDisabled |
Tipo:
boolean optional Padrão:
false Indica se o mapa permite que o usuário controle a inclinação da câmera. Essa opção só é válida quando o mapa é vetorial. Se não for definido no código, a configuração da nuvem para o ID do mapa será usada (se disponível).
Atributo HTML:
|
zoom |
Tipo:
number optional Nível de zoom do mapa. Os valores de zoom válidos são números de zero até o nível máximo de zoom aceito. Valores de zoom maiores correspondem a uma resolução maior.
Atributo HTML:
|
Slots | |
---|---|
control-block-end-inline-center |
Posiciona o elemento com ranhura na posição ControlPosition.BLOCK_END_INLINE_CENTER . |
control-block-end-inline-end |
Posiciona o elemento com ranhura na posição ControlPosition.BLOCK_END_INLINE_END . |
control-block-end-inline-start |
Posiciona o elemento com ranhura na posição ControlPosition.BLOCK_END_INLINE_START . |
control-block-start-inline-center |
Posiciona o elemento com ranhura na posição ControlPosition.BLOCK_START_INLINE_CENTER . |
control-block-start-inline-end |
Posiciona o elemento com ranhura na posição ControlPosition.BLOCK_START_INLINE_END . |
control-block-start-inline-start |
Posiciona o elemento com ranhura na posição ControlPosition.BLOCK_START_INLINE_START . |
control-inline-end-block-center |
Posiciona o elemento com ranhura na posição ControlPosition.INLINE_END_BLOCK_CENTER . |
control-inline-end-block-end |
Posiciona o elemento com ranhura na posição ControlPosition.INLINE_END_BLOCK_END . |
control-inline-end-block-start |
Posiciona o elemento com ranhura na posição ControlPosition.INLINE_END_BLOCK_START . |
control-inline-start-block-center |
Posiciona o elemento com ranhura na posição ControlPosition.INLINE_START_BLOCK_CENTER . |
control-inline-start-block-end |
Posiciona o elemento com ranhura na posição ControlPosition.INLINE_START_BLOCK_END . |
control-inline-start-block-start |
Posiciona o elemento com ranhura na posição ControlPosition.INLINE_START_BLOCK_START . |
default |
É possível criar componentes reutilizáveis em torno dos componentes da Web JavaScript do Maps, como AdvancedMarkerElement , usando elementos personalizados. Por padrão, todos os elementos personalizados adicionados diretamente ao MapElement são inseridos e renderizados em MapPanes.overlayMouseTarget . No entanto, os Web Components da API Maps JavaScript podem ser realocados para os slots internos do MapElement . |
Métodos | |
---|---|
addEventListener |
addEventListener(type, listener[, options]) Parâmetros:
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:
Valor de retorno:
void Remove um listener de eventos registrado anteriormente com addEventListener do destino. Consulte removeEventListener. |
Eventos | |
---|---|
gmp-zoomchange |
function(event) Argumentos:
Este evento é acionado quando a propriedade de zoom do mapa é alterada. |
Interface MapElementOptions
Interface
google.maps.MapElementOptions
Objeto MapElementOptions usado para definir as propriedades que podem ser definidas em um MapElement.
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 . |
Classe ZoomChangeEvent
Classe
google.maps.ZoomChangeEvent
Este evento é criado ao monitorar a mudança de 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 o estilo do mapa. Os seletores especificam os elementos e/ou recursos do mapa que serão afetados, e os stylers especificam como esses elementos e recursos serão modificados. Para mais detalhes, consulte a referência de estilo.
Propriedades | |
---|---|
stylers |
As regras de estilo que serão aplicadas aos elementos e recursos do mapa selecionados. As regras são aplicadas na ordem especificada nessa matriz. Para conferir diretrizes sobre o uso e os valores permitidos, consulte a referência de estilo. |
elementType optional |
Tipo:
string optional O elemento em que um estilizador precisa 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 saber mais sobre o uso e os valores permitidos, consulte a referência de estilo. |
featureType optional |
Tipo:
string optional O recurso ou grupo de recursos em que um styler precisa ser aplicado. Opcional. Se featureType não for especificado, o valor será 'all' . Para saber mais sobre o uso e os 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 |
O evento DOM nativo correspondente. Os desenvolvedores não devem depender de propriedades target , currentTarget , relatedTarget e path definidas e consistentes. Os desenvolvedores também não devem depender da estrutura DOM da implementação interna da API Maps. Devido ao mapeamento de eventos interno, o domEvent pode ter semânticas diferentes do MapMouseEvent . Por exemplo, um MapMouseEvent "clique" pode ter um domEvent do tipo KeyboardEvent . |
latLng optional |
Tipo:
LatLng optional A latitude/longitude que estava abaixo do cursor quando ocorreu o evento. |
Métodos | |
---|---|
stop |
stop() Parâmetros:nenhum
Valor de retorno:
void Impedem a propagação desse evento. |
Interface IconMouseEvent
Interface
google.maps.IconMouseEvent
Esse objeto é enviado em um evento quando um usuário clica em um ícone no mapa. O ID do lugar é armazenado no membro placeId. Para impedir que a janela de informações padrão apareça, chame o método stop() nesse evento para impedir a propagação dele. Saiba mais sobre IDs de lugar no guia para desenvolvedores 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 recurso em que o usuário clicou. Saiba mais sobre IDs de lugar no guia para desenvolvedores da API Places. |
Herdado:
domEvent ,
latLng
|
Métodos | |
---|---|
Herdado:
stop
|
Constantes ColorScheme
Constantes
google.maps.ColorScheme
Identificadores de esquemas de cores do mapa. Especifique esses valores pelo 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 claras de um mapa. Valor padrão para o Maps JS legado. |
Constantes MapTypeId
Constantes
google.maps.MapTypeId
Identificadores para MapTypes comuns. Especifique esses valores pelo 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. |
Classe MapTypeRegistry
Classe
google.maps.MapTypeRegistry
Um registro para instâncias de MapType, com chave de 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. 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:
Valor de retorno:nenhum
Define o registro a ser associado ao identificador de string passado juntamente com o tipo de mapa. |
Herdado:
addListener ,
bindTo ,
get ,
notify ,
setValues ,
unbind ,
unbindAll
|
Interface MapRestriction
Interface
google.maps.MapRestriction
Uma restrição que pode ser aplicada ao mapa. A janela de visualização do mapa não vai exceder essas restrições.
Propriedades | |
---|---|
latLngBounds |
Quando definido, o usuário só pode fazer panorâmica e zoom dentro dos limites especificados. Os limites podem restringir a longitude e a latitude ou apenas a latitude. Para limites de latitude, use longitudes oeste e leste de -180 e 180, respectivamente. Por exemplo, latLngBounds: {north: northLat, south: southLat, west: -180, east: 180} . |
strictBounds optional |
Tipo:
boolean optional É possível tornar os limites mais restritivos definindo a flag strictBounds como true . Isso reduz o quanto um usuário pode diminuir o zoom, garantindo que tudo fora dos limites restritos permaneça oculto. O padrão é false , o que significa que o usuário pode diminuir o zoom até que toda a área delimitada esteja visível, possivelmente incluindo áreas fora da área delimitada. |
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:
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:
Valor de retorno:nenhum
Renderiza a camada no mapa especificado. Se o mapa for definido como null , a camada será removida. |
setOptions |
setOptions(options) Parâmetros:
Valor de retorno:nenhum
|
Herdado:
addListener ,
bindTo ,
get ,
notify ,
set ,
setValues ,
unbind ,
unbindAll
|
Interface TrafficLayerOptions
Interface
google.maps.TrafficLayerOptions
Objeto TrafficLayerOptions usado para definir as propriedades que podem ser definidas em uma TrafficLayer.
Propriedades | |
---|---|
autoRefresh optional |
Tipo:
boolean optional Padrão:
true Indica se a camada de trânsito é atualizada automaticamente com informações atualizadas. |
map optional |
Tipo:
Map optional Mapa em que a camada de trânsito vai ser mostrada. |
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 mostra 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:
Valor de retorno:nenhum
Renderiza a camada no mapa especificado. Se o mapa for 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:
Valor de retorno:nenhum
Renderiza a camada no mapa especificado. Se o mapa for 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 da 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 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 |
Constantes RenderingType
Constantes
google.maps.RenderingType
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 de varredura, porque ele ainda não terminou a inicialização. |
VECTOR |
Indica que o mapa é vetorial. |
Interface MapCapabilities
Interface
google.maps.MapCapabilities
Objeto que contém um resumo dos recursos disponíveis no momento para o mapa. Isso não significa necessariamente que os módulos relevantes são carregados ou inicializados, mas sim que o mapa atual tem permissão para usar essas APIs. Consulte as propriedades para conferir uma lista de recursos possíveis.
Propriedades | |
---|---|
isAdvancedMarkersAvailable optional |
Tipo:
boolean optional Se for verdadeiro, o mapa está configurado corretamente para permitir o uso de marcadores avançados. É necessário importar a biblioteca marker para usar marcadores avançados. Consulte https://goo.gle/gmp-isAdvancedMarkersAvailable para mais informações. |
isDataDrivenStylingAvailable optional |
Tipo:
boolean optional Se for verdadeiro, o mapa está configurado corretamente para permitir o uso de estilos orientados a dados para pelo menos uma FeatureLayer. Consulte https://goo.gle/gmp-data-driven-styling e https://goo.gle/gmp-FeatureLayerIsAvailable para mais informações. |
isWebGLOverlayViewAvailable optional |
Tipo:
boolean optional Se for verdadeiro, o mapa está configurado corretamente para permitir o uso de WebGLOverlayView . |