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 especificado, que costuma ser 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 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 incluir um controle no 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 que eles sejam mostrados no mapa de forma conveniente. |
mapTypes |
Tipo:
MapTypeRegistry Um registro de instâncias MapType por ID da string. |
overlayMapTypes |
Tipos de mapa adicionais a serem superpostos. Os tipos de mapa de sobreposição serã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 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 é definido como display: none , a função fitBounds lê o tamanho como 0 x 0 e, portanto, não faz nada. Para alterar a janela de visualização enquanto o mapa está oculto, defina o mapa como visibility: hidden , garantindo que o div do mapa tenha um tamanho real. Em mapas vetoriais, esse método define a inclinação e a direção do mapa com os valores zero padrão. 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 lat/lng 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 em longitude de -180 a 180 graus. Se o mapa ainda não tiver sido inicializado ou se a centralização e o zoom não tiverem sido definidos, 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 acessar 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 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 |
getDatasetFeatureLayer(datasetId) Parâmetros:
Valor de retorno:
FeatureLayer Retorna o 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 do mapa ou se o estilo com base em dados não estiver disponível (sem ID do mapa, blocos vetoriais, camadas de elementos do estilo baseado em dados ou conjuntos de dados configurados no estilo), o resultado será um erro, e o FeatureLayer.isAvailable 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 estar 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, blocos vetoriais e FeatureLayer ativado no estilo de mapa), o resultado será um erro, e o FeatureLayer.isAvailable resultante será falso. |
getHeading |
getHeading() Parâmetros: nenhum
Valor de retorno:
number|undefined Retorna a direção da bússola do mapa. O valor da orientação é medido em graus (sentido horário) a partir da direção cardeal norte. Se o mapa ainda não tiver sido inicializado, o resultado será undefined . |
getHeadingInteractionEnabled |
getHeadingInteractionEnabled() Parâmetros: nenhum
Valor de retorno:
boolean|null Retorna se as interações de cabeçalho estão ativadas. Essa opção só é válida quando o mapa é vetorial. Se não for definida no código, a configuração de nuvem para o ID do mapa será usada (se disponível). |
getMapCapabilities |
getMapCapabilities() Parâmetros: nenhum
Valor de retorno:
MapCapabilities Informa o autor da chamada sobre os recursos atuais disponíveis para o mapa com base no ID fornecido. |
getMapTypeId |
getMapTypeId() Parâmetros: nenhum
Valor de retorno:
MapTypeId|string|undefined |
getProjection |
getProjection() Parâmetros: nenhum
Valor de retorno:
Projection|undefined Retorna o Projection atual. Se o mapa ainda não tiver sido inicializado, o resultado será undefined . Detecte o evento projection_changed e verifique 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 limite StreetViewPanorama padrão do mapa, que pode ser um panorama padrão incorporado ao mapa ou o panorama definido com setStreetView() . As alterações no streetViewControl do mapa serão refletidas na exibição desse panorama limitado. |
getTilt |
getTilt() Parâmetros: nenhum
Valor de retorno:
number|undefined Retorna o ângulo de incidência atual do mapa, em graus, do plano da janela de visualização para o plano do mapa. Para mapas rasterizados, o resultado será 0 para imagens tiradas diretamente para cima ou 45 para imagens em 45°. Esse método não retorna o valor definido por setTilt . Acesse 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 definida no código, a configuração de 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
Altera 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:
Valor de retorno: nenhum
Move o mapa de acordo com a quantidade mínima necessária para conter o LatLngBounds especificado. Isso não garante a localização dos limites no mapa, exceto que o mapa será deslocado para mostrar o máximo de limites possível dentro de {currentMapSizeInPx} - {padding} . Nos mapas rasterizados e vetoriais, o zoom, a inclinação e a direção não são alterados. |
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 clicabilidade dos ícones de mapa, transmita um valor de false para esse método. |
setHeading |
setHeading(heading) Parâmetros:
Valor de retorno: nenhum
Define a orientação da bússola para o mapa medido em graus a partir da direção cardeal norte. Para mapas rasterizados, esse método se aplica somente a imagens aéreas. |
setHeadingInteractionEnabled |
setHeadingInteractionEnabled(headingInteractionEnabled) Parâmetros:
Valor de retorno: nenhum
Define se as interações de cabeçalho estão ativadas. Essa opção só é válida quando o mapa é vetorial. Se não for definida no código, a configuração de 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. Este 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 ao mapa. |
setTilt |
setTilt(tilt) Parâmetros:
Valor de retorno: nenhum
Em mapas vetoriais, define o ângulo de incidência do mapa. Os valores permitidos são restritos dependendo do nível de zoom do mapa. Em mapas rasterizados, controla o comportamento de alternância automática para o ângulo de incidência do mapa. Os únicos valores permitidos são 0 e 45 . 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 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() (em inglês) a propriedade tilt . Fazer 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 definida no código, a configuração de 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:
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 pelo fato de IconMouseEvent ter o campo de ID de lugar. O evento sempre pode ser tratado como um MapMouseEvent quando o ID de local não é importante. O evento de clique não é disparado se um marcador ou uma janela de informações é clicado. |
contextmenu |
function(event) Argumentos:
Este evento é disparado quando o evento contextmenu do DOM é disparado no recipiente do mapa. |
dblclick |
function(event) Argumentos:
Este evento é disparado quando o usuário clica duas vezes no mapa. O evento de clique às vezes é acionado uma ou duas vezes logo antes deste. |
drag |
function() Argumentos: nenhum
Este evento é disparado repetidamente enquanto o usuário arrasta o mapa. |
dragend |
function() Argumentos: nenhum
Este evento é acionado quando o usuário para de arrastar o mapa. |
dragstart |
function() Argumentos: nenhum
Este evento é acionado quando o usuário começa a arrastar o mapa. |
heading_changed |
function() Argumentos: nenhum
Este evento é acionado quando a propriedade de orientação do mapa é alterada. |
idle |
function() Argumentos: nenhum
Este evento é disparado quando o mapa fica inativo após sofrer um deslocamento ou alteração de zoom. |
isfractionalzoomenabled_changed |
function() Argumentos: nenhum
Este evento é disparado quando a propriedade isFractionalZoomEnabled é 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:
Este evento é disparado sempre que o mouse do usuário é movido sobre o recipiente do mapa. |
mouseout |
function(event) Argumentos:
Este evento é disparado quando o mouse do usuário é retirado do recipiente do mapa. |
mouseover |
function(event) Argumentos:
Este evento é disparado quando o mouse do usuário é colocado no recipiente do mapa. |
projection_changed |
function() Argumentos: nenhum
Este evento é disparado quando a projeção é alterada. |
renderingtype_changed |
function() Argumentos: nenhum
Este evento é disparado quando o renderType é 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. |
|
function(event) Argumentos:
Este evento é disparado quando o usuário clica com o botão direito no mapa. |
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 do 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 fazer com que os controles passem para o estado undefined . Controla apenas os controles feitos pela própria API do Google 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 de 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 |
|
Tipo:
boolean optional Se for 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 a ser exibido quando você passa o mouse sobre um mapa arrastável. Essa propriedade usa o atributo CSS cursor para mudar o ícone. Assim como acontece com a propriedade CSS, você precisa 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 acontece com a propriedade CSS, você precisa 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:
|
heading optional |
Tipo:
number optional A orientação de imagens aéreas em graus medida no sentido horário a partir da direção cardeal norte. As orientações são ajustadas para o ângulo mais próximo disponível para o qual foram disponibilizadas imagens. |
headingInteractionEnabled optional |
Tipo:
boolean optional Padrão:
false Define se o mapa deve permitir o controle do usuário sobre a direção da câmera (rotação). Essa opção só é válida quando o mapa é vetorial. Se não for definida no código, a configuração de 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 rasterizadosDefine 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. Map.DEMO_MAP_ID pode ser usada para testar recursos que precisam de um ID do mapa, mas que não exigem ativação da nuvem. |
mapTypeControl optional |
Tipo:
boolean optional O estado inicial ativado/desativado do controle do tipo de mapa. |
mapTypeControlOptions optional |
Tipo:
MapTypeControlOptions optional As opções de exibição inicial do controle do tipo de mapa. |
mapTypeId optional |
Tipo:
MapTypeId|string optional O mapTypeId inicial do mapa. O valor padrão é ROADMAP . |
maxZoom optional |
Tipo:
number optional O nível de zoom máximo que será exibido no mapa. Se omitido, ou definido como null , o zoom máximo do tipo de mapa atual será usado. Os valores de zoom válidos são números de zero até o nível de zoom máximo 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. |
|
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 Se o mapa deve ser rasterizado ou vetorial. Esse parâmetro não pode ser definido ou alterado depois que um mapa é instanciado. Se não for definido, a configuração da nuvem do ID do mapa vai determinar o tipo de renderização (se disponível). Os mapas vetoriais podem não estar disponíveis para todos os dispositivos e navegadores e retornar a uma versão rasterizada 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 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 uma 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 que 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 colocado. |
streetViewControl optional |
Tipo:
boolean optional O estado ativado/desativado inicial do controle Pegman do Street View. Esse controle faz parte da interface padrão e deve ser definido como false ao exibir um tipo de mapa em que a sobreposição de via do Street View não deve aparecer (por exemplo, um tipo de mapa que não seja da Terra). |
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. Esse recurso não está disponível ao usar um ID do mapa ou mapas vetoriais (use a Estilização de mapas baseada na nuvem). |
tilt optional |
Tipo:
number optional Em mapas vetoriais, define o ângulo de incidência do mapa. Os valores permitidos são restritos dependendo do nível de zoom do mapa. Para mapas raster, controla o comportamento de alternância automática para o ângulo de incidência do mapa. Os únicos valores permitidos são 0 e 45 . O valor 0 faz com que o mapa sempre use uma visualização de 0° acima 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 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 Define se o mapa deve permitir o controle do usuário sobre a inclinação da câmera. Essa opção só é válida quando o mapa é vetorial. Se não for definida no código, a configuração de 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 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
, é possível criar um mapa em HTML. Por exemplo:
<gmp-map center="37.4220656,-122.0840897" zoom="10" map-id="DEMO_MAP_ID">
<button slot="control-block-start-inline-end">Custom Control</button>
</gmp-map>
Internamente, ela usa
Map
, que pode ser acessada 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 A latitude/longitude central do mapa.
Atributo HTML:
|
headingInteractionDisabled |
Tipo:
boolean optional Padrão:
false Define se o mapa deve permitir o controle do usuário sobre a direção da câmera (rotação). Essa opção só é válida quando o mapa é vetorial. Se não for definida no código, a configuração de 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. Esse parâmetro não pode ser definido ou alterado depois que um mapa é instanciado.
Map.DEMO_MAP_ID pode ser usada para testar recursos que precisam de um ID do mapa, mas que não exigem ativação da nuvem.Atributo HTML:
|
renderingType |
Tipo:
RenderingType optional Padrão:
RenderingType.VECTOR Se o mapa deve ser rasterizado ou vetorial. Esse parâmetro não pode ser definido ou alterado depois que um mapa é instanciado. Se não for definido, a configuração da nuvem do ID do mapa vai determinar o tipo de renderização (se disponível). Os mapas vetoriais podem não estar disponíveis para todos os dispositivos e navegadores e retornar a uma versão rasterizada conforme necessário.
Atributo HTML:
|
tiltInteractionDisabled |
Tipo:
boolean optional Padrão:
false Define se o mapa deve permitir o controle do usuário sobre a inclinação da câmera. Essa opção só é válida quando o mapa é vetorial. Se não for definida no código, a configuração de nuvem para o ID do mapa será usada (se disponível).
Atributo HTML:
|
zoom |
Tipo:
number optional O nível de zoom do mapa. Os valores de zoom válidos são números de zero até o nível de zoom máximo compatível. Valores de zoom maiores correspondem a uma resolução maior.
Atributo HTML:
|
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 do destino um listener de eventos registrado anteriormente com addEventListener. Consulte removeEventListener |
Eventos | |
---|---|
gmp-zoomchange |
function(event) Argumentos:
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 Consulte os MapElement.center . |
headingInteractionDisabled optional |
Tipo:
boolean optional Consulte os MapElement.headingInteractionDisabled . |
mapId optional |
Tipo:
string optional Consulte os MapElement.mapId . |
renderingType optional |
Tipo:
RenderingType optional Consulte os MapElement.renderingType . |
tiltInteractionDisabled optional |
Tipo:
boolean optional Consulte os MapElement.tiltInteractionDisabled . |
zoom optional |
Tipo:
number optional Consulte os MapElement.zoom . |
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.
MapTypeStyle
Interface
google.maps.MapTypeStyle
MapTypeStyle
é uma coleção de seletores e estilizadores que definem o estilo do mapa. Os seletores especificam os elementos e/ou elementos do mapa que devem ser afetados, e os estilizadores especificam como esses recursos e elementos devem ser modificados. Para mais detalhes, consulte a referência de estilo.
Propriedades | |
---|---|
stylers |
As regras de estilo que serão aplicadas aos recursos e elementos selecionados do mapa. As regras são aplicadas na ordem em que você especifica nesta matriz. Para orientações sobre uso e valores permitidos, confira a referência de estilo. |
elementType optional |
Tipo:
string optional O elemento ao qual um estilizador deve ser aplicado. Um elemento é um aspecto visual de um elemento no mapa. Exemplo: uma etiqueta, 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 ao qual um estilizador 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. |
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 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, o domEvent pode ter semântica diferente do MapMouseEvent . Por exemplo, um "clique" de 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 este 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 lugar desse lugar está armazenado no membro placeId. Para evitar que a janela de informações padrão apareça, chame o método stop() neste evento para impedir que ela seja propagada. Saiba mais sobre IDs de lugar 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 lugar no guia do desenvolvedor da API Places. |
Herdado:
domEvent ,
latLng
|
Métodos | |
---|---|
Herdado:
stop
|
Constantes MapTypeId
Constantes
google.maps.MapTypeId
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, codificadas por ID de MapType.
Essa classe estende
MVCObject
.
Acesse chamando const {MapTypeRegistry} = await google.maps.importLibrary("maps")
. Consulte Bibliotecas na API Maps JavaScript.
Construtor | |
---|---|
MapTypeRegistry |
MapTypeRegistry() Parâmetros: nenhum
O MapTypeRegistry contém a coleção de tipos de mapa personalizados disponíveis para uso no mapa. A API consulta esse registro ao fornecer a lista de tipos de mapa disponíveis nos controles, por exemplo. |
Métodos | |
---|---|
set |
set(id, mapType) Parâmetros:
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 movimentar e aplicar zoom dentro dos limites especificados. 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:
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 estiver 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
|
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:
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:
Valor de retorno: nenhum
Renderiza a camada no mapa especificado. Se o mapa estiver definido como null , a camada será removida. |
Herdado:
addListener ,
bindTo ,
get ,
notify ,
set ,
setValues ,
unbind ,
unbindAll
|
CameraOptions
Interface
google.maps.CameraOptions
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 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
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 é uma varredura. |
UNINITIALIZED |
Indica que ainda não se sabe se o mapa é vetorial ou rasterizado, porque a inicialização ainda não foi concluída. |
VECTOR |
Indica que o mapa é vetorial. |
Interface MapCapabilities
Interface
google.maps.MapCapabilities
Objeto que contém um snapshot dos recursos 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 ver uma lista de possíveis recursos.
Propriedades | |
---|---|
isAdvancedMarkersAvailable optional |
Tipo:
boolean optional Se verdadeiro, esse mapa é configurado corretamente para permitir o uso de Marcadores Avançados. Você ainda precisa importar a biblioteca marker para usar os Marcadores Avançados. Consulte https://goo.gle/gmp-isAdvancedMarkersAvailable para mais informações. |
isDataDrivenStylingAvailable optional |
Tipo:
boolean optional Se verdadeiro, o mapa é configurado corretamente para permitir o uso do estilo orientado a dados em pelo menos um FeatureLayer. Para mais informações, acesse https://goo.gle/gmp-data-driven-styling e https://goo.gle/gmp-FeatureLayerIsAvailable. |
isWebGLOverlayViewAvailable optional |
Tipo:
boolean optional Se verdadeiro, esse mapa é configurado corretamente para permitir o uso de WebGLOverlayView . |