Classe OverlayView
Classe
google.maps.OverlayView
Implemente essa classe se quiser exibir tipos personalizados de objetos de sobreposição no mapa.
Para herdar desta classe, defina o protótipo da sobreposição: MyOverlay.prototype = new google.maps.OverlayView();
. O construtor OverlayView
é uma função vazia.
Você precisa implementar três métodos: onAdd()
, draw()
e onRemove()
.
- No método
onAdd()
, crie objetos DOM e anexe-os como filhos dos painéis. - No método
draw()
, posicione esses elementos. - No método
onRemove()
, remova os objetos do DOM.
setMap()
com um objeto Map
válido para acionar a chamada para o método onAdd()
e setMap(null)
para acionar o método onRemove()
. O método setMap()
pode ser chamado no momento da construção ou a qualquer momento posteriormente em que a sobreposição precisa ser mostrada novamente após a remoção. O método draw()
será chamado sempre que uma propriedade do mapa mudar e mudar a posição do elemento, como zoom, centralização ou tipo de mapa.
Essa classe estende
MVCObject
.
Acesse chamando const {OverlayView} = await google.maps.importLibrary("maps")
ou const {OverlayView} = await google.maps.importLibrary("streetView")
. Consulte Bibliotecas na API Maps JavaScript.
Construtor | |
---|---|
OverlayView |
OverlayView() Parâmetros: nenhum
Cria um OverlayView . |
Métodos estáticos | |
---|---|
preventMapHitsAndGesturesFrom |
preventMapHitsAndGesturesFrom(element) Parâmetros:
Valor de retorno: nenhum
Isso impede que eventos de clique, toque, arraste e role no elemento apareçam no mapa. Use para impedir arrastar e aplicar zoom no mapa, bem como eventos de "clique" no mapa. |
preventMapHitsFrom |
preventMapHitsFrom(element) Parâmetros:
Valor de retorno: nenhum
Isso impede que o clique ou toque no elemento apareça no mapa. Use para evitar que o mapa acione eventos de "clique". |
Métodos | |
---|---|
draw |
draw() Parâmetros: nenhum
Valor de retorno: nenhum
Implemente esse método para desenhar ou atualizar a sobreposição. Use a posição de projection.fromLatLngToDivPixel() para posicionar corretamente a sobreposição em relação ao MapPanes. Este método é chamado após onAdd() e é chamado quando o zoom ou o centro são alterados. Não é recomendado fazer um trabalho computacionalmente caro nesse método. |
getMap |
getMap() Parâmetros: nenhum
Valor de retorno:
Map|StreetViewPanorama |
getPanes |
getPanes() Parâmetros: nenhum
Valor de retorno:
MapPanes|null Retorna os painéis nos quais essa OverlayView pode ser renderizada. Os painéis não são inicializados até que onAdd seja chamado pela API. |
getProjection |
getProjection() Parâmetros: nenhum
Valor de retorno:
MapCanvasProjection Retorna o objeto MapCanvasProjection associado a essa OverlayView . A projeção não é inicializada até que onAdd seja chamado pela API. |
onAdd |
onAdd() Parâmetros: nenhum
Valor de retorno: nenhum
Implemente esse método para inicializar os elementos DOM de sobreposição. Esse método é chamado uma vez após setMap() ser chamado com um mapa válido. Nesse ponto, os painéis e a projeção terão sido inicializados. |
onRemove |
onRemove() Parâmetros: nenhum
Valor de retorno: nenhum
Implemente esse método para remover os seus elementos do DOM. Esse método é chamado uma vez após uma chamada para setMap(null). |
setMap |
setMap(map) Parâmetros:
Valor de retorno: nenhum
Adiciona uma superposição ao mapa ou panorama. |
Herdado:
addListener ,
bindTo ,
get ,
notify ,
set ,
setValues ,
unbind ,
unbindAll
|
Interface MapPanes
Interface
google.maps.MapPanes
Propriedades | |
---|---|
floatPane |
Tipo:
Element Este painel contém a janela de informações. Fica acima de todas as sobreposições do mapa (Painel 4). |
mapPane |
Tipo:
Element Este painel é o mais baixo e fica acima dos blocos. Ele não recebe eventos DOM. (painel 0). |
markerLayer |
Tipo:
Element Este painel contém marcadores. Ele não recebe eventos DOM. (painel 2). |
overlayLayer |
Tipo:
Element Este painel contém polilinhas, polígonos, sobreposições de solo e sobreposições de camada de blocos. Ele não recebe eventos DOM. (painel 1). |
overlayMouseTarget |
Tipo:
Element Este painel contém elementos que recebem eventos DOM. (painel 3). |
Interface MapCanvasProjection
Interface
google.maps.MapCanvasProjection
Esse objeto é disponibilizado para o OverlayView
pelo método draw. A inicialização até que draw seja chamado não é garantida.
Métodos | |
---|---|
fromContainerPixelToLatLng |
fromContainerPixelToLatLng(pixel[, noClampNoWrap]) Parâmetros:
Valor de retorno:
LatLng|null Calcula as coordenadas geográficas a partir das coordenadas em pixels no recipiente do mapa. |
fromDivPixelToLatLng |
fromDivPixelToLatLng(pixel[, noClampNoWrap]) Parâmetros:
Valor de retorno:
LatLng|null Calcula as coordenadas geográficas a partir das coordenadas em pixels no div que contém o mapa arrastável. |
fromLatLngToContainerPixel |
fromLatLngToContainerPixel(latLng) Parâmetros:
Valor de retorno:
Point|null Calcula as coordenadas em pixels do local geográfico especificado no elemento do contêiner do mapa. |
fromLatLngToDivPixel |
fromLatLngToDivPixel(latLng) Parâmetros:
Valor de retorno:
Point|null Calcula as coordenadas em pixels do local geográfico especificado no elemento DOM que contém o mapa arrastável. |
getVisibleRegion |
getVisibleRegion() Parâmetros: nenhum
Valor de retorno:
VisibleRegion|null A região visível do mapa. Retorna null se o mapa não tiver tamanho. Retorna null se OverlayView estiver em um StreetViewPanorama. |
getWorldWidth |
getWorldWidth() Parâmetros: nenhum
Valor de retorno:
number A largura do mundo em pixels no nível de zoom atual. Para projeções com um ângulo de orientação de 90 ou 270 graus, corresponde à extensão de pixels no eixo Y. |