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 fornecido, que normalmente é um elemento DIV . |
Propriedades | |
---|---|
controls |
Tipo:
Array<MVCArray<HTMLElement>> Controles adicionais a serem anexados ao mapa. Para adicionar um controle ao mapa, adicione a <div> do controle ao MVCArray correspondente ao ControlPosition em que ele precisa ser renderizado. |
data |
Tipo:
Data Uma instância de Data , vinculada ao mapa. Adicione elementos a este objeto Data para exibi-los convenientemente neste mapa. |
mapTypes |
Tipo:
MapTypeRegistry Um registro de instâncias de MapType por ID de string. |
overlayMapTypes |
Tipos de mapa adicionais a serem superpostos. Os tipos de mapa de sobreposição são exibidos sobre o mapa básico ao qual estão anexados, na ordem em que aparecem na matriz overlayMapTypes (as sobreposições com valores de índice mais altos são exibidas na frente 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 do mapa como 0x0 e, portanto, não faz nada. Para alterar a janela de visualização com o mapa oculto, defina o mapa como visibility: hidden , garantindo assim que o div do mapa tenha um tamanho real. Para mapas vetoriais, este método define a inclinação e o rumo do mapa como seus valores padrão zero. Chamar esse método pode causar uma animação suave quando o mapa se movimenta e aplica zoom para se ajustar aos limites. A animação desse método depende de uma heurística interna. |
getBounds |
getBounds() Parâmetros: nenhum
Valor de retorno:
LatLngBounds|undefined os limites de latitude/longitude da janela de visualização atual.Retorna os limites de latitude/longitude da janela de visualização atual. Se mais de uma cópia do mundo estiver visível, os limites variam em longitude de -180 a 180 graus. 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 cabeçalho 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 obter 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 clicabilidade dos ícones do mapa. Um ícone de mapa representa um ponto de interesse, também conhecido como PDI. Se o valor retornado for true , os ícones poderão ser clicados no mapa. |
|
getDatasetFeatureLayer(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 orientado a dados não estiver disponível (sem ID do mapa, blocos de vetor, camadas de recursos de estilo com base em dados ou conjuntos de dados configurados no estilo de mapa), isso registrará um erro e o FeatureLayer.isAvailable resultante será falso. |
getDiv |
getDiv() Parâmetros: nenhum
Valor de retorno:
HTMLElement o mapDiv do mapa. |
getFeatureLayer |
getFeatureLayer(featureType) Parâmetros:
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 neste mapa ou se o estilo com base em dados não estiver disponível (nenhum ID de mapa, blocos de vetor e FeatureLayer não estiver ativado no estilo de mapa), isso registrará um erro e o FeatureLayer.isAvailable resultante será falso. |
getHeading |
getHeading() Parâmetros: nenhum
Valor de retorno:
number|undefined Retorna a orientação da bússola do mapa. O valor da orientação é medido em graus (sentido horário) a partir da direção cardeal norte. Se o mapa ainda não tiver sido inicializado, o resultado será undefined . |
getMapCapabilities |
getMapCapabilities() Parâmetros: nenhum
Valor de retorno:
MapCapabilities Informa o chamador dos 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 . Ouça 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 alterações no streetViewControl do mapa serão refletidas na exibição desse panorama vinculado. |
getTilt |
getTilt() Parâmetros: nenhum
Valor de retorno:
number|undefined Retorna o ângulo atual de incidência do mapa, em graus do plano da janela de visualização ao plano do mapa. Para mapas de varredura, o resultado será 0 para imagens tiradas diretamente acima ou 45 para imagens de 45°. Esse método não retorna o valor definido por setTilt . Consulte setTilt para mais detalhes. |
getZoom |
getZoom() Parâmetros: nenhum
Valor de retorno:
number|undefined Retorna o zoom do mapa. Se o zoom não tiver sido definido, o resultado será undefined . |
moveCamera |
moveCamera(cameraOptions) Parâmetros:
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. Ele não garante onde os limites ficarão no mapa, exceto que o mapa será deslocado para mostrar o máximo de limites possível dentro de {currentMapSizeInPx} - {padding} . Nos mapas de varredura e vetoriais, o zoom, a inclinação e a orientação não serão alterados. |
setCenter |
setCenter(latlng) Parâmetros:
Valor de retorno: nenhum
|
setClickableIcons |
setClickableIcons(value) Parâmetros:
Valor de retorno: nenhum
Controla se os ícones de 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 medida em graus a partir da direção cardeal norte. Para mapas rasterizados, esse método se aplica somente a imagens aéreas. |
setMapTypeId |
setMapTypeId(mapTypeId) Parâmetros:
Valor de retorno: nenhum
|
setOptions |
setOptions(options) Parâmetros:
Valor de retorno: nenhum
|
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 ao mapa. A definição do panorama como null vincula o panorama incorporado padrão 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 dependendo do nível de zoom do mapa. Para mapas rasterizados, controla o comportamento da 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 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 as imagens de 45° estiverem disponíveis para o nível de zoom e a janela de visualização atuais. Depois, volte para 0 sempre que as imagens de 45° não estiverem disponíveis (esse é o comportamento padrão). As imagens de 45° estão disponíveis apenas para os tipos de mapa satellite e hybrid , em alguns locais e em alguns 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. |
setZoom |
setZoom(zoom) Parâmetros:
Valor de retorno: nenhum
Define o zoom do mapa. |
Herdada:
addListener ,
bindTo ,
get ,
notify ,
set ,
setValues ,
unbind ,
unbindAll
|
Constantes | |
---|---|
DEMO_MAP_ID |
ID do mapa que pode ser usado para amostras de código que exigem um ID do mapa. Esse ID do mapa não se destina ao uso em aplicativos de produção e não pode ser usado para recursos que exigem configuração da nuvem (como o Cloud Styling). |
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 do local clicado será retornado, a menos que um ícone de local seja clicado. Nesse caso, um IconMouseEvent com um ID de local será retornado. IconMouseEvent e MapMouseEvent são idênticos, exceto que IconMouseEvent tem o campo de ID de local. O evento poderá ser tratado como um MapMouseEvent quando o ID do local não for importante. O evento de clique não será acionado se um marcador ou uma janela de informações tiver sido 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 vez e outras 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 é acionado quando o usuário clica com o botão direito do mouse 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 de mapa não são clicáveis. Um ícone de mapa representa um ponto de interesse, também conhecido como PDI. |
controlSize optional |
Tipo:
number optional Tamanho em pixels dos controles que aparecem no mapa. Este valor deve ser fornecido diretamente durante a criação do mapa. A atualização desse valor mais tarde pode fazer com que os controles fiquem no estado undefined . Somente controla os controles feitos pela API do Google Maps. Não escalona os controles personalizados criados pelo desenvolvedor. |
disableDefaultUI optional |
Tipo:
boolean optional Ativa/desativa todos os botões padrão da interface do usuário. Pode ser substituída individualmente. Não desativa os controles do teclado, que são controlados separadamente pela opção MapOptions.keyboardShortcuts . Não desativa os controles de gestos, que são controlados separadamente pela opção MapOptions.gestureHandling . |
disableDoubleClickZoom optional |
Tipo:
boolean optional Ativa/desativa o zoom e a centralização com clique duplo. Ativado por padrão. Observação: essa propriedade não é recomendada. Para desativar o zoom com clique duplo, use a propriedade |
|
Tipo:
boolean optional Se false , evita que o mapa seja arrastado. O recurso de arrastar está ativado por padrão. |
draggableCursor optional |
Tipo:
string optional O nome ou o URL do cursor a ser exibido ao passar o mouse sobre um mapa arrastável. Essa propriedade usa o atributo cursor do CSS para alterar o ícone. Assim como na propriedade css, é necessário especificar pelo menos um cursor substituto que não seja um URL. Por exemplo, draggableCursor: 'url(http://www.example.com/icon.png), auto;' . |
draggingCursor optional |
Tipo:
string optional O nome ou o URL do cursor a ser exibido quando o mapa estiver sendo arrastado. Essa propriedade usa o atributo cursor do CSS para alterar o ícone. Assim como na propriedade css, é necessário especificar pelo menos um cursor substituto que não seja um URL. Por exemplo, draggingCursor: 'url(http://www.example.com/icon.png), auto;' . |
fullscreenControl optional |
Tipo:
boolean optional O estado ativado/desativado do controle de tela cheia. |
fullscreenControlOptions optional |
Tipo:
FullscreenControlOptions optional As opções de exibição do controle de tela cheia. |
gestureHandling optional |
Tipo:
string optional Esta configuração controla como a API lida com 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. |
isFractionalZoomEnabled optional |
Tipo:
boolean optional Padrão:
true para mapas vetoriais e false para mapas rasterizadosSe o mapa deve permitir níveis fracionários de zoom. Ouça isfractionalzoomenabled_changed para saber quando o padrão foi definido. |
keyboardShortcuts optional |
Tipo:
boolean optional Se false , impede que o mapa seja controlado pelo teclado. Os atalhos do teclado estão ativados por padrão. |
mapId optional |
Tipo:
string optional O ID do mapa. Este parâmetro não pode ser definido ou alterado depois que um mapa é instanciado. |
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 for omitido ou definido como null , o zoom máximo do tipo de mapa atual será usado. Os valores válidos de zoom são números de zero até o nível máximo de zoom permitido. |
minZoom optional |
Tipo:
number optional O nível de zoom mínimo que será exibido no mapa. Se for omitido ou definido como null , o zoom mínimo do tipo de mapa atual será usado. Os valores válidos de zoom são números de zero até o nível máximo de zoom permitido. |
noClear optional |
Tipo:
boolean optional Se true , não limpe o conteúdo do div do mapa. |
panControl optional |
Tipo:
boolean optional O estado ativado/desativado do controle de panorâmica. Observação: O controle de panorâmica não está disponível no novo conjunto de controles introduzido na versão 3.22 da API JavaScript do Google Maps. Na v3.22 e v3.23, você pode optar por usar o conjunto de controles anterior em vez dos novos, disponibilizando o controle de panorâmica como parte do conjunto de controle antigo. Consulte O que há de novo nos controles de mapa v3.22. |
panControlOptions optional |
Tipo:
PanControlOptions optional As opções de exibição do controle de panorâmica. Observação: O controle de panorâmica não está disponível no novo conjunto de controles introduzido na versão 3.22 da API JavaScript do Google Maps. Na v3.22 e v3.23, você pode optar por usar o conjunto de controles anterior em vez dos novos, disponibilizando o controle de panorâmica como parte do conjunto de controle antigo. Consulte O que há de novo nos controles de mapa v3.22. |
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ó poderá movimentar e aplicar zoom enquanto a visualização da câmera estiver dentro dos limites. |
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 o botão 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 a ser exibido quando o Pegman do Street View é colocado no mapa. Se nenhum panorama for especificado, um StreetViewPanorama padrão será exibido no div do mapa quando o Pegman for colocado. |
streetViewControl optional |
Tipo:
boolean optional O estado ativado/desativado inicial do controle Pegman do Street View. Este controle faz parte da interface de usuário padrão e deve ser definido como false ao exibir um tipo de mapa no qual a sobreposição de estrada do Street View não deve aparecer (por exemplo, um tipo de mapa que não seja do Google Earth). |
streetViewControlOptions optional |
Tipo:
StreetViewControlOptions optional As opções de exibição inicial do controle Pegman do Street View. |
styles optional |
Tipo:
Array<MapTypeStyle> optional Estilos a serem aplicados a cada um dos tipos de mapa padrão. Para os modos satellite /hybrid e terrain , esses estilos só se aplicam a marcadores e geometria. |
tilt optional |
Tipo:
number optional Para mapas vetoriais, define o ângulo de incidência do mapa. Os valores permitidos são restritos dependendo do nível de zoom do mapa. Para mapas rasterizados, controla o comportamento da 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 aérea de 0°, independentemente do nível de zoom e da janela de visualização. O valor 45 faz com que o ângulo de inclinação mude automaticamente para 45 sempre que as imagens de 45° estiverem disponíveis para o nível de zoom e a janela de visualização atuais, e volte a 0 sempre que as imagens de 45° não estiverem disponíveis (esse é o comportamento padrão). As imagens de 45° estão disponíveis apenas para os tipos de mapa satellite e hybrid , em alguns locais e em alguns níveis de zoom. Observação: getTilt retorna o ângulo de inclinação atual, não o valor especificado por essa opção. Como getTilt e essa opção se referem a coisas diferentes, não bind() a propriedade tilt . Isso pode gerar efeitos imprevisíveis. |
zoom optional |
Tipo:
number optional O nível de zoom inicial do mapa. Os valores válidos de zoom são números de zero até o nível máximo de zoom permitido. 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. |
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"></gmp-map>
Internamente, ela usa Map
, que pode ser acessado com a propriedade innerMap
.
Elemento personalizado:
<gmp-map center="lat,lng" map-id="string" zoom="number"></gmp-map>
Essa classe estende HTMLElement
.
Essa classe implementa MapElementOptions
.
Acesse chamando const {MapElement} = await google.maps.importLibrary("maps")
. Consulte Bibliotecas na API Maps JavaScript.
Propriedades | |
---|---|
center |
Tipo:
LatLng|LatLngLiteral optional A latitude/longitude central do mapa.
Atributo HTML:
|
innerMap |
Tipo:
Map Uma referência ao Map que o MapElement usa internamente. |
mapId |
Tipo:
string optional O ID do mapa. Consulte a documentação do ID do mapa para mais informações.
Atributo HTML:
|
zoom |
Tipo:
number optional O nível de zoom do mapa.
Atributo HTML:
|
Métodos | |
---|---|
|
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. Veja o addEventListener |
|
removeEventListener(type, listener[, options]) Parâmetros:
Valor de retorno:
void Remove do ouvinte do evento um listener de evento registrado anteriormente com addEventListener. Consulte removeEventListener |
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 O centro inicial do mapa. |
mapId optional |
Tipo:
string optional O ID do mapa. Este parâmetro não pode ser definido ou alterado depois que um mapa é instanciado. |
zoom optional |
Tipo:
number optional O nível de zoom inicial do mapa. Os valores válidos de zoom são números de zero até o nível máximo de zoom permitido. Valores de zoom maiores correspondem a uma resolução maior. |
MapTypeStyle
Interface google.maps.MapTypeStyle
O MapTypeStyle
é uma coleção de seletores e estilizadores que definem como o mapa deve ser estilizado. Os seletores especificam os elementos e/ou elementos do mapa que devem ser afetados e os estilizadores especificam como esses elementos e elementos devem ser modificados. Para mais detalhes, consulte a referência de estilo.
Propriedades | |
---|---|
stylers |
As regras de estilo a serem aplicadas aos elementos e elementos do mapa selecionado. As regras são aplicadas na ordem que você especificar nessa matriz. Para diretrizes sobre uso e valores permitidos, consulte a referência de estilo. |
elementType optional |
Tipo:
string optional O elemento ao qual um estilizador deve ser aplicado. Um elemento é um aspecto visual de um recurso no mapa. Exemplo: um rótulo, um ícone, o traço ou o preenchimento aplicado à geometria e muito mais. Opcional. Se elementType não for especificado, o valor será considerado 'all' . Para detalhes de uso e valores permitidos, consulte a referência de estilo. |
featureType optional |
Tipo:
string optional O elemento ou grupo de elementos ao qual um estilizador deve ser aplicado. Opcional. Se featureType não for especificado, o valor será considerado '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 de eventos internos, a domEvent pode ter uma semântica diferente da MapMouseEvent (por exemplo, um "clique" MapMouseEvent pode ter uma domEvent do tipo KeyboardEvent ). |
latLng optional |
Tipo:
LatLng optional A latitude/longitude que estava abaixo do cursor quando ocorreu o evento. |
Métodos | |
---|---|
stop |
stop() Parâmetros: nenhum
Valor de retorno:
void Impede que esse evento se propague mais. |
IconMouseEvent.
Interface google.maps.IconMouseEvent
Esse objeto é enviado em um evento quando um usuário clica em um ícone no mapa. O ID desse lugar é armazenado no membro placeId. Para evitar que a janela de informações padrão seja exibida, chame o método stop() nesse evento para evitar que ele seja propagado. Saiba mais sobre IDs de lugares 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 local pode ser usado para consultar mais informações sobre o elemento clicado. Saiba mais sobre IDs de lugares no guia do desenvolvedor da API Places. |
Herdada:
domEvent ,
latLng
|
Métodos | |
---|---|
Herdada:
stop
|
MapTypeId
google.maps.MapTypeId
constantes
Identificadores para MapTypes comuns. Especifique-as por valor ou usando o nome da constante. Por exemplo, 'satellite'
ou google.maps.MapTypeId.SATELLITE
.
Acesse chamando const {MapTypeId} = await google.maps.importLibrary("maps")
. Consulte Bibliotecas na API Maps JavaScript.
Constantes | |
---|---|
HYBRID |
Este tipo de mapa exibe uma camada transparente das principais ruas nas imagens de satélite. |
ROADMAP |
Este tipo de mapa exibe um mapa convencional de ruas. |
SATELLITE |
Este tipo de mapa exibe imagens de satélite. |
TERRAIN |
Este tipo de mapa exibe mapas com características físicas como terreno e vegetação. |
MapTypeRegistry.
Classe
google.maps.MapTypeRegistry
Um registro para instâncias de MapType, codificado pelo 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. |
Herdada:
addListener ,
bindTo ,
get ,
notify ,
setValues ,
unbind ,
unbindAll
|
MapRestriction
Interface google.maps.MapRestriction
Uma restrição que pode ser aplicada ao mapa. A janela de visualização do mapa não excederá essas restrições.
Propriedades | |
---|---|
latLngBounds |
Quando definido, o usuário só pode deslocar e aplicar zoom dentro dos limites fornecidos. Os limites podem restringir a longitude e a latitude ou apenas a latitude. Para limites somente de latitude, use as 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 a distância que 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 delimitada fique visível, possivelmente incluindo áreas fora da área delimitada. |
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
|
Herdada:
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 um TrafficLayer.
Propriedades | |
---|---|
autoRefresh optional |
Tipo:
boolean optional Padrão:
true Se a camada de tráfego é atualizada com informações atualizadas automaticamente. |
map optional |
Tipo:
Map optional Mapa no qual exibir a camada de trânsito. |
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 for definido como null , a camada será removida. |
Herdada:
addListener ,
bindTo ,
get ,
notify ,
set ,
setValues ,
unbind ,
unbindAll
|
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. |
Herdada:
addListener ,
bindTo ,
get ,
notify ,
set ,
setValues ,
unbind ,
unbindAll
|
CameraOptions.
Interface google.maps.CameraOptions
Usado para definir as opções de câmera do mapa.
Propriedades | |
---|---|
center optional |
Tipo:
LatLngLiteral|LatLng optional |
heading optional |
Tipo:
number optional |
tilt optional |
Tipo:
number optional |
zoom optional |
Tipo:
number optional |
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 |
RenderingType
google.maps.RenderingType
constantes
Acesse chamando const {RenderingType} = await google.maps.importLibrary("maps")
. Consulte Bibliotecas na API Maps JavaScript.
Constantes | |
---|---|
RASTER |
Indica que o mapa é de varredura. |
UNINITIALIZED |
Indica que ainda não se sabe se o mapa é vetorial ou rasterizado, porque ele ainda não foi inicializado. |
VECTOR |
Indica que o mapa é um mapa vetorial. |
MapCapabilities
Interface google.maps.MapCapabilities
Objeto que contém um instantâneo dos recursos disponíveis atualmente 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 for "true", este mapa será configurado corretamente para permitir o uso de marcadores avançados. Você ainda precisa 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 "true", este mapa será configurado corretamente para permitir o uso de estilos baseados em dados para pelo menos um FeatureLayer. Consulte https://goo.gle/gmp-data-drive-styling e https://goo.gle/gmp-FeatureLayerIsAvailable para mais informações. |