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.
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
.
Ao usar v=beta
, ele pode ser acessado chamando const {OverlayView} = await google.map.importLibrary("maps")
ou const {OverlayView} = await google.map.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
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:
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". |
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 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
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. 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.
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 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. |