Classe Map
Classe
google.maps.Map
Essa classe estende
MVCObject
.
Acesse ligando para const {Map} = await google.maps.importLibrary("maps")
.
Consulte Bibliotecas na API Maps JavaScript.
Construtor | |
---|---|
Map |
Map(mapDiv[, opts]) Parâmetros:
Cria um novo mapa dentro do contêiner HTML informado, que normalmente é um elemento DIV . |
Constantes | |
---|---|
DEMO_MAP_ID |
ID do mapa que pode ser usado em exemplos de código que exigem um ID de mapa. Esse ID de mapa não foi criado para uso em aplicativos de produção e não pode ser usado em recursos que exigem configuração na nuvem, como a estilização na nuvem. |
Propriedades | |
---|---|
controls |
Tipo:
Array<MVCArray<HTMLElement>> Controles adicionais a serem anexados ao mapa. Para adicionar um controle ao mapa, inclua o <div> do controle no MVCArray correspondente ao ControlPosition em que ele deve ser renderizado. |
data |
Tipo:
Data Uma instância de Data vinculada ao mapa. Adicione recursos a esse objeto Data para mostrá-los convenientemente no mapa. |
mapTypes |
Tipo:
MapTypeRegistry Um registro de instâncias MapType por ID de string. |
overlayMapTypes |
Tipos de mapa adicionais a serem superpostos. Os tipos de mapa de sobreposição aparecem sobre o mapa base em que estão anexados, na ordem em que aparecem na matriz overlayMapTypes . As sobreposições com valores de índice mais altos aparecem na frente das sobreposições com valores de índice menores. |
Métodos | |
---|---|
fitBounds |
fitBounds(bounds[, padding]) Parâmetros:
Valor de retorno:nenhum
Define a janela de visualização para que contenha os limites fornecidos. Observação:quando o mapa é definido como display: none , a função fitBounds lê o tamanho do mapa como 0x0 e, portanto, não faz nada. Para mudar a janela de visualização enquanto o mapa está oculto, defina o mapa como visibility: hidden . Assim, a div do mapa terá um tamanho real. Para mapas vetoriais, esse método define a inclinação e o rumo do mapa como os valores padrão zero. Chamar esse método pode causar uma animação suave à medida que o mapa faz uma transição e um zoom para se ajustar aos limites. A animação desse método depende de uma heurística interna. |
getBounds |
getBounds() Parâmetros:nenhum
Valor de retorno:
LatLngBounds|undefined os limites de latitude/longitude da janela de visualização atual.Retorna os limites de latitude/longitude da janela de visualização atual. Se mais de uma cópia do mundo estiver visível, o intervalo de limites em longitude será de -180 a 180 graus, inclusive. Se o mapa ainda não tiver sido inicializado ou se o centro e o zoom não tiverem sido definidos, o resultado será undefined . Para mapas vetoriais com inclinação ou orientação diferentes de zero, os limites de latitude/longitude retornados representam a menor caixa delimitadora que inclui a região visível da janela de visualização do mapa. Consulte MapCanvasProjection.getVisibleRegion para saber a região visível exata da janela de visualização do mapa. |
getCenter |
getCenter() Parâmetros:nenhum
Valor de retorno:
LatLng|undefined |
getClickableIcons |
getClickableIcons() Parâmetros:nenhum
Valor de retorno:
boolean|undefined Retorna a capacidade de clicar nos ícones do mapa. Um ícone de mapa representa um ponto de interesse, também conhecido como PDI. Se o valor retornado for true , os ícones serão clicáveis no mapa. |
|
getDatasetFeatureLayer(datasetId) Parâmetros:
Valor de retorno:
FeatureLayer Retorna o FeatureLayer do datasetId especificado. Os IDs de conjuntos de dados precisam ser configurados no console do Google Cloud. Se o ID do conjunto de dados não estiver associado ao estilo do mapa ou se o estilo baseado em dados não estiver disponível (sem ID do mapa, sem blocos vetoriais, sem camadas de recursos de estilo baseado em dados ou conjuntos de dados configurados no estilo do mapa), um erro será registrado, e o FeatureLayer.isAvailable resultante será falso. |
getDiv |
getDiv() Parâmetros:nenhum
Valor de retorno:
HTMLElement o mapDiv do mapa. |
getFeatureLayer |
getFeatureLayer(featureType) Parâmetros:
Valor de retorno:
FeatureLayer Retorna o FeatureLayer do FeatureType específico. Um FeatureLayer precisa ser ativado no console do Google Cloud. Se um FeatureLayer do FeatureType especificado não existir no mapa ou se o estilo baseado em dados não estiver disponível (sem ID do mapa, sem blocos vetoriais e sem FeatureLayer ativado no estilo do mapa), isso vai registrar um erro, e o FeatureLayer.isAvailable resultante será falso. |
getHeading |
getHeading() Parâmetros:nenhum
Valor de retorno:
number|undefined Retorna a bússola do mapa. O valor da orientação é medido em graus (sentido horário) a partir da direção cardeal norte. Se o mapa ainda não tiver sido inicializado, o resultado será undefined . |
getHeadingInteractionEnabled |
getHeadingInteractionEnabled() Parâmetros:nenhum
Valor de retorno:
boolean|null Retorna se as interações de cabeçalho estão ativadas. Essa opção só entra em vigor quando o mapa é vetorial. Se não estiver definido no código, a configuração da nuvem para o ID do mapa será usada (se disponível). |
getInternalUsageAttributionIds |
getInternalUsageAttributionIds() Parâmetros:nenhum
Valor de retorno:
Iterable<string>|null Retorna a lista de IDs de atribuição de uso, que ajudam o Google a entender quais bibliotecas e amostras são úteis para os desenvolvedores, como o uso de uma biblioteca de clustering de marcadores. |
getMapCapabilities |
getMapCapabilities() Parâmetros:nenhum
Valor de retorno:
MapCapabilities Informa ao caller os recursos disponíveis no mapa com base no ID fornecido. |
getMapTypeId |
getMapTypeId() Parâmetros:nenhum
Valor de retorno:
MapTypeId|string|undefined |
getProjection |
getProjection() Parâmetros:nenhum
Valor de retorno:
Projection|undefined Retorna o Projection atual. Se o mapa ainda não tiver sido inicializado, o resultado será undefined . Detecte o evento projection_changed e verifique o valor dele para garantir que não seja undefined . |
getRenderingType |
getRenderingType() Parâmetros:nenhum
Valor de retorno:
RenderingType Retorna o RenderingType atual do mapa. |
getStreetView |
getStreetView() Parâmetros:nenhum
Valor de retorno:
StreetViewPanorama o panorama vinculado ao mapa.Retorna o StreetViewPanorama padrão vinculado ao mapa, que pode ser um panorama padrão incorporado ao mapa ou o panorama definido usando setStreetView() . As mudanças no streetViewControl do mapa serão refletidas na exibição de um panorama vinculado. |
getTilt |
getTilt() Parâmetros:nenhum
Valor de retorno:
number|undefined Retorna o ângulo de incidência atual do mapa, em graus do plano da janela de visualização para o plano do mapa. Para mapas raster, o resultado será 0 para imagens capturadas diretamente acima ou 45 para imagens em 45°. Esse método não retorna o valor definido por setTilt . Consulte setTilt para mais detalhes. |
getTiltInteractionEnabled |
getTiltInteractionEnabled() Parâmetros:nenhum
Valor de retorno:
boolean|null Retorna se as interações de inclinação estão ativadas. Essa opção só entra em vigor quando o mapa é vetorial. Se não estiver definido no código, a configuração da nuvem para o ID do mapa será usada (se disponível). |
getZoom |
getZoom() Parâmetros:nenhum
Valor de retorno:
number|undefined Retorna o zoom do mapa. Se o zoom não tiver sido definido, o resultado será undefined . |
moveCamera |
moveCamera(cameraOptions) Parâmetros:
Valor de retorno:nenhum
Define imediatamente as opções de câmera de destino para a câmera do mapa, sem animação. |
panBy |
panBy(x, y) Parâmetros:
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 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 pela quantidade mínima necessária para conter o LatLngBounds especificado. Não há garantia de onde os limites vão ficar no mapa, exceto que o mapa será movido para mostrar o máximo possível dos limites dentro de {currentMapSizeInPx} - {padding} . Para mapas rasterizados e vetoriais, o zoom, a inclinação e a direção do mapa não serão alterados. |
setCenter |
setCenter(latlng) Parâmetros:
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 clicar nos í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, medida em graus a partir da direção cardeal norte. Para mapas rasterizados, esse método só se aplica a imagens aéreas. |
setHeadingInteractionEnabled |
setHeadingInteractionEnabled(headingInteractionEnabled) Parâmetros:
Valor de retorno:nenhum
Define se as interações de cabeçalho estão ativadas. Essa opção só entra em vigor quando o mapa é vetorial. Se não estiver definido no código, a configuração da nuvem para o ID do mapa será usada (se disponível). |
setMapTypeId |
setMapTypeId(mapTypeId) Parâmetros:
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 fora dele. 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 dependendo do nível de zoom do mapa. Para mapas rasterizados, controla o comportamento de troca automática do ângulo de incidência do mapa. Os únicos valores permitidos são 0 e 45 . setTilt(0) faz com que o mapa sempre use uma visualização aérea de 0°, independente do nível de zoom e da janela de visualização. setTilt(45) faz com que o ângulo de inclinação mude automaticamente para 45 sempre que imagens em 45° estiverem disponíveis para o nível de zoom e a janela de visualização atuais, e volte para 0 quando não estiverem disponíveis (esse é o comportamento padrão). As imagens em 45° estão disponíveis apenas para os tipos de mapa satellite e hybrid , em alguns locais e níveis de zoom. Observação:getTilt retorna o ângulo de inclinação atual, não o valor definido por setTilt . Como getTilt e setTilt se referem a coisas diferentes, não bind() a propriedade tilt . Isso pode gerar efeitos imprevisíveis. |
setTiltInteractionEnabled |
setTiltInteractionEnabled(tiltInteractionEnabled) Parâmetros:
Valor de retorno:nenhum
Define se as interações de inclinação estão ativadas. Essa opção só entra em vigor quando o mapa é vetorial. Se não estiver definido no código, a configuração da nuvem para o ID do mapa será usada (se disponível). |
setZoom |
setZoom(zoom) Parâmetros:
Valor de retorno:nenhum
Define o zoom do mapa. |
Herdado:addListener ,
bindTo ,
get ,
notify ,
set ,
|