DOM elements

Classe OverlayView

Classe google.maps.OverlayView

Implemente essa classe se quiser exibir tipos personalizados de objetos de sobreposição no mapa.

Herde de essa classe definindo o protótipo da sobreposição: MyOverlay.prototype = new google.maps.OverlayView();. O construtor OverlayView é garantido como uma função vazia.

É necessário 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.

Chame 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 em qualquer momento depois, quando a sobreposição precisa ser mostrada novamente após a remoção. O método draw() é chamado sempre que uma propriedade do mapa muda e pode alterar 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: element:  Element Valor de retorno:nenhum Impedem que os eventos de clique, toque, arrasto e roda no elemento sejam transmitidos para o mapa. Use isso para evitar que o mapa seja arrastado e ampliado, bem como eventos de "clique".
preventMapHitsFrom	preventMapHitsFrom(element) Parâmetros: element:  Element Valor de retorno:nenhum Impedem que o clique ou toque no elemento seja transmitido para o mapa. Use isso 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 às janelas do mapa. Esse método é chamado após onAdd() e é chamado na mudança de zoom ou centralização. Não é recomendável fazer trabalhos computacionalmente caros 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 esse 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: map:  Map|StreetViewPanorama optional O mapa ou panorama. Se for null, a camada será removida. 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 é o painel mais baixo e fica acima dos blocos. Ele não recebe eventos DOM. (painel 0).
markerLayer	Tipo:Element Esse 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 Esse painel contém elementos que recebem eventos DOM. (painel 3).

Interface MapCanvasProjection

Interface google.maps.MapCanvasProjection

Esse objeto é disponibilizado para OverlayView no método de exibição. A inicialização até que draw seja chamado não é garantida.

Métodos
fromContainerPixelToLatLng	fromContainerPixelToLatLng(pixel[, noClampNoWrap]) Parâmetros: pixel:  Point optional noClampNoWrap:  boolean optional 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: pixel:  Point optional noClampNoWrap:  boolean optional 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: latLng:  LatLng|LatLngLiteral Valor de retorno:Point|null Calcula as coordenadas de pixel do local geográfico fornecido no elemento do contêiner do mapa.
fromLatLngToDivPixel	fromLatLngToDivPixel(latLng) Parâmetros: latLng:  LatLng|LatLngLiteral optional 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 Região visível do mapa. Retorna null se o mapa não tiver tamanho. Retorna null se a 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 direção de 90 ou 270 graus, isso corresponde à extensão de pixel no eixo Y.