DOM elements

OverlayView.

Classe google.maps.OverlayView

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

Herdar desta classe definindo o protótipo da sua 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(), você precisa posicionar esses elementos.
  • No método onRemove(), remova os objetos do DOM.
É necessário chamar 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 depois que a sobreposição for exibida novamente após a remoção. O método draw() será chamado sempre que uma propriedade de mapa mudar, o que pode mudar a posição do elemento, como zoom, centro ou tipo de mapa.

Essa classe estende MVCObject.

OverlayView
OverlayView()
Parâmetros: nenhum
Cria um OverlayView.
preventMapHitsAndGesturesFrom
preventMapHitsAndGesturesFrom(element)
Parâmetros:
  • element: Element
Valor de retorno: nenhum
impede que os eventos de clique, toque, arrastar e de roda no elemento apareçam no mapa. Use essa opção para impedir eventos de arrastar e aplicar zoom no mapa, bem como eventos de "clique" no mapa.
preventMapHitsFrom
preventMapHitsFrom(element)
Parâmetros:
  • elementElement
Valor de retorno: nenhum
impede que o elemento apareça no mapa ou toque nele. Use essa opção para evitar que o mapa acione eventos de "clique".
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 aos MapPanes. Esse método é chamado após onAdd() e na mudança de zoom ou centro. 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 este 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.
Herdadas: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

interface MapPanes

Interface google.maps.MapPanes

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. Ela não recebe eventos DOM. (painel 0).
markerLayer
Tipo:Element
Este painel contém marcadores. Ela 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. Ela não recebe eventos DOM. (painel 1).
overlayMouseTarget
Tipo: Element
Esse painel contém elementos que recebem eventos DOM. (painel 3).

Interface MapCanvasproj

Interface google.maps.MapCanvasProjection

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

fromContainerPixelToLatLng
fromContainerPixelToLatLng(pixel[, noClampNoWrap])
Parâmetros:
  • pixel: Point optional
  • noClampNoWrapboolean 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
  • noClampNoWrapboolean 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:
Valor de retorno: Point|null
Calcula as coordenadas em pixels do local geográfico especificado no elemento de 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 direção de 90 ou 270 graus, corresponde ao intervalo de pixels no eixo Y.