DOM elements

OverlayView class

google.maps.OverlayView classe

Puoi implementare questa classe se vuoi visualizzare tipi personalizzati di oggetti di overlay sulla mappa.

Eredita da questa classe impostando il prototipo dell'overlay: MyOverlay.prototype = new google.maps.OverlayView();. Il costruttore OverlayView è garantito per essere una funzione vuota.

Devi implementare tre metodi: onAdd(), draw() e onRemove().

  • Nel metodo onAdd(), devi creare oggetti DOM e aggiungerli come elementi secondari dei riquadri.
  • Nel metodo draw(), devi posizionare questi elementi.
  • Nel metodo onRemove(), devi rimuovere gli oggetti dal DOM.
Devi chiamare setMap() con un oggetto Map valido per attivare la chiamata al metodo onAdd() e setMap(null) per attivare il metodo onRemove(). Il metodo setMap() può essere chiamato al momento della costruzione o in qualsiasi momento successivo in cui l'overlay deve essere visualizzato nuovamente dopo la rimozione. Il metodo draw() verrà quindi chiamato ogni volta che una proprietà della mappa cambia e potrebbe modificare la posizione dell'elemento, ad esempio lo zoom, il centro o il tipo di mappa.

Questo corso si estende MVCObject.

Accesso tramite chiamata al numero const {OverlayView} = await google.maps.importLibrary("maps") o const {OverlayView} = await google.maps.importLibrary("streetView").
Consulta Librerie nell'API Maps JavaScript.
OverlayView
OverlayView()
Parametri: nessuno
Crea un OverlayView.
preventMapHitsAndGesturesFrom
preventMapHitsAndGesturesFrom(element)
Parametri: 
Valore restituito:nessuno
Interrompe la propagazione degli eventi di clic, tocco, trascinamento e rotellina sull'elemento alla mappa. Utilizza questa opzione per impedire il trascinamento e lo zoom della mappa, nonché gli eventi "clic" sulla mappa.
preventMapHitsFrom
preventMapHitsFrom(element)
Parametri: 
Valore restituito:nessuno
Interrompe il clic o il tocco sull'elemento che si propaga alla mappa. Utilizza questo parametro per impedire alla mappa di attivare gli eventi "click".
draw
draw()
Parametri: nessuno
Valore restituito:nessuno
Implementa questo metodo per disegnare o aggiornare l'overlay. Utilizza la posizione di projection.fromLatLngToDivPixel() per posizionare correttamente l'overlay rispetto a MapPanes. Questo metodo viene chiamato dopo onAdd() e viene chiamato in caso di modifica dello zoom o del centro. Non è consigliabile eseguire operazioni che richiedono molte risorse di calcolo con questo metodo.
getMap
getMap()
Parametri: nessuno
Valore restituito:  Map|StreetViewPanorama
getPanes
getPanes()
Parametri: nessuno
Valore restituito:  MapPanes|null
Restituisce i riquadri in cui può essere visualizzato questo OverlayView. I riquadri non vengono inizializzati finché l'API non chiama onAdd.
getProjection
getProjection()
Parametri: nessuno
Valore restituito:  MapCanvasProjection
Restituisce l'oggetto MapCanvasProjection associato a questo OverlayView. La proiezione non viene inizializzata finché l'API non chiama onAdd.
onAdd
onAdd()
Parametri: nessuno
Valore restituito:nessuno
Implementa questo metodo per inizializzare gli elementi DOM di overlay. Questo metodo viene chiamato una volta dopo che setMap() viene chiamato con una mappa valida. A questo punto, i riquadri e la proiezione saranno stati inizializzati.
onRemove
onRemove()
Parametri: nessuno
Valore restituito:nessuno
Implementa questo metodo per rimuovere gli elementi dal DOM. Questo metodo viene chiamato una volta dopo una chiamata a setMap(null).
setMap
setMap(map)
Parametri: 
Valore restituito:nessuno
Aggiunge l'overlay alla mappa o al panorama.
Ereditato: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

Interfaccia MapPanes

google.maps.MapPanes interfaccia

floatPane
Tipo:  Element
Questo riquadro contiene la finestra delle informazioni. Si trova sopra tutti gli overlay mappa. (riquadro 4).
mapPane
Tipo:  Element
Questo riquadro è il più basso e si trova sopra i riquadri. Non riceve eventi DOM. (Riquadro 0).
markerLayer
Tipo:  Element
Questo riquadro contiene indicatori. Non riceve eventi DOM. (riquadro 2).
overlayLayer
Tipo:  Element
Questo riquadro contiene polilinee, poligoni, sovrapposizioni di terreno e sovrapposizioni di livelli di tessere. Non riceve eventi DOM. (riquadro 1).
overlayMouseTarget
Tipo:  Element
Questo riquadro contiene gli elementi che ricevono eventi DOM. (Riquadro 3).

MapCanvasProjection interfaccia

google.maps.MapCanvasProjection interfaccia

Questo oggetto viene reso disponibile a OverlayView dall'interno del metodo draw. Non è garantito che venga inizializzato finché non viene chiamato draw.
fromContainerPixelToLatLng
fromContainerPixelToLatLng(pixel[, noClampNoWrap])
Parametri: 
  • pixel:  Point optional
  • noClampNoWrap:  boolean optional
Valore restituito:  LatLng|null
Calcola le coordinate geografiche dalle coordinate dei pixel nel contenitore della mappa.
fromDivPixelToLatLng
fromDivPixelToLatLng(pixel[, noClampNoWrap])
Parametri: 
  • pixel:  Point optional
  • noClampNoWrap:  boolean optional
Valore restituito:  LatLng|null
Calcola le coordinate geografiche dalle coordinate dei pixel nel div che contiene la mappa trascinabile.
fromLatLngToContainerPixel
fromLatLngToContainerPixel(latLng)
Parametri: 
Valore restituito:  Point|null
Calcola le coordinate in pixel della posizione geografica specificata nell'elemento contenitore della mappa.
fromLatLngToDivPixel
fromLatLngToDivPixel(latLng)
Parametri: 
Valore restituito:  Point|null
Calcola le coordinate in pixel della posizione geografica specificata nell'elemento DOM che contiene la mappa trascinabile.
getVisibleRegion
getVisibleRegion()
Parametri: nessuno
Valore restituito:  VisibleRegion|null
La regione visibile della mappa. Restituisce null se la mappa non ha dimensioni. Restituisce null se OverlayView si trova su StreetViewPanorama.
getWorldWidth
getWorldWidth()
Parametri: nessuno
Valore restituito:  number
La larghezza del mondo in pixel nel livello di zoom attuale. Per le proiezioni con un angolo di direzione di 90 o 270 gradi, questo valore corrisponde all'intervallo di pixel nell'asse Y.