Image overlays

Interfaccia MapType

Interfaccia google.maps.MapType

Questa interfaccia definisce il tipo di mappa e viene in genere utilizzata per i tipi di mappa personalizzati. Immutabile.

maxZoom
Tipo: number
Il livello di zoom massimo per la mappa quando viene visualizzato questo MapType. Obbligatorio per i MapType di base, ignorato per i MapType di overlay.
minZoom
Tipo: number
Il livello di zoom minimo per la mappa quando viene visualizzato questo MapType. Facoltativo; il valore predefinito è 0.
radius
Tipo: number
Raggio del pianeta per la mappa, in metri. Facoltativo; il valore predefinito è il raggio equatoriale della Terra di 6378137 metri.
alt
facoltativo
Tipo: string optional
Testo alternativo da visualizzare quando si passa il mouse sopra il pulsante di questo MapType nel MapTypeControl. Facoltativo.
name
facoltativo
Tipo: string optional
Nome da visualizzare nel MapTypeControl. Facoltativo.
projection
facoltativo
Tipo: Projection optional
La proiezione utilizzata per eseguire il rendering di questo MapType. Facoltativo; il valore predefinito è Mercatore.
tileSize
facoltativo
Tipo: Size optional
Le dimensioni di ogni riquadro. Obbligatorio.
getTile
getTile(tileCoord, zoom, ownerDocument)
Parametri:
  • tileCoord: Point coordinate dei riquadri.
  • zoom: number Zoom riquadro.
  • ownerDocument: Document il documento proprietario di questo riquadro.
Valore restituito: Element|null Tile risultante.
Restituisce un riquadro per le coordinate dei riquadri (x, y) e il livello di zoom specificati. Questo riquadro verrà aggiunto all'ownerDocument specificato. Non disponibile per i tipi di mappa base.
releaseTile
releaseTile(tile)
Parametri:
  • tile: Element optional Tile da rilasciare.
Valore restituito: void
Rilascia il riquadro specificato, eseguendo le operazioni di pulizia necessarie. Il riquadro fornito sarà già stato rimosso dal documento. Facoltativo.

Interfaccia Projection

Interfaccia google.maps.Projection

Interfaccia di proiezione.

fromLatLngToPoint
fromLatLngToPoint(latLng[, point])
Parametri:
Valore restituito: Point|null
Esegue la conversione dal cilindro LatLng al piano Point. Questa interfaccia specifica una funzione che implementa la conversione dai valori LatLng specificati alle coordinate del mondo nella proiezione della mappa. L'API di Maps chiama questo metodo quando deve tracciare le posizioni sullo schermo. Gli oggetti Projection devono implementare questo metodo, ma possono restituire null se la proiezione non può calcolare Point.
fromPointToLatLng
fromPointToLatLng(pixel[, noClampNoWrap])
Parametri:
  • pixel: Point
  • noClampNoWrap: boolean optional
Valore restituito: LatLng|null
Questa interfaccia specifica una funzione che implementa la conversione dalle coordinate del mondo su una proiezione della mappa ai valori LatLng. L'API di Maps chiama questo metodo quando deve tradurre le azioni sullo schermo in posizioni sulla mappa. Gli oggetti Projection devono implementare questo metodo, ma possono restituire null se la proiezione non può calcolare LatLng.

Classe ImageMapType

google.maps.ImageMapType class
extends MVCObject
implements MapType
library "maps"

Questa classe implementa l'interfaccia MapType e viene fornita per il rendering dei tile di immagini.

const {ImageMapType} = await google.maps.importLibrary("maps");
ImageMapType
ImageMapType(opts)
Parametri:
Crea un ImageMapType utilizzando le ImageMapTypeOptions fornite
alt
Tipo: string optional
maxZoom
Tipo: number
minZoom
Tipo: number
name
Tipo: string optional
projection
Tipo: Projection optional
radius
Tipo: number
tileSize
Tipo: Size optional
getOpacity
getOpacity()
Parametri: nessuno
Valore restituito: number opacity L'opacità corrente.
Restituisce il livello di opacità (da 0 (trasparente) a 1.0) dei riquadri ImageMapType.
getTile
getTile(tileCoord, zoom, ownerDocument)
Parametri:
  • tileCoord: Point optional coordinate dei riquadri.
  • zoom: zoom del riquadro number.
  • ownerDocument: Document optional il documento proprietario di questo riquadro.
Valore restituito: Element|null Tile risultante.
releaseTile
releaseTile(tileDiv)
Parametri:
  • tileDiv: Element optional Tile da rilasciare.
Valore restituito: nessuno
setOpacity
setOpacity(opacity)
Parametri:
  • opacity: number la nuova opacità.
Valore restituito: nessuno
Imposta il livello di opacità (da 0 (trasparente) a 1.0) dei riquadri ImageMapType.
Ereditate: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
tilesloaded
function()
Argomenti: nessuno
Questo evento viene attivato al termine del caricamento dei riquadri visibili.

Interfaccia ImageMapTypeOptions

Interfaccia google.maps.ImageMapTypeOptions

Questa classe viene utilizzata per creare un MapType che esegue il rendering dei riquadri delle immagini.

alt
facoltativo
Tipo: string optional
Testo alternativo da visualizzare quando si passa il mouse sopra il pulsante di questo MapType nel MapTypeControl.
getTileUrl
facoltativo
Tipo: function(Point, number): (string optional) optional
Restituisce una stringa (URL) per le coordinate dei riquadri (x, y) e il livello di zoom specificati.
maxZoom
facoltativo
Tipo: number optional
Il livello di zoom massimo per la mappa quando viene visualizzato questo MapType.
minZoom
facoltativo
Tipo: number optional
Il livello di zoom minimo per la mappa quando viene visualizzato questo MapType. Facoltativo.
name
facoltativo
Tipo: string optional
Nome da visualizzare nel MapTypeControl.
opacity
facoltativo
Tipo: number optional
L'opacità da applicare ai riquadri. L'opacità deve essere specificata come un valore in virgola mobile compreso tra 0 e 1,0, dove 0 è completamente trasparente e 1 è completamente opaco.
tileSize
facoltativo
Tipo: Size optional
La dimensione del riquadro.

Classe GroundOverlay

google.maps.GroundOverlay class
extends MVCObject
library "maps"

Un overlay immagine rettangolare sulla mappa.

const {GroundOverlay} = await google.maps.importLibrary("maps");
GroundOverlay
GroundOverlay(url, bounds[, opts])
Parametri:
Crea un overlay del terreno dall'URL dell'immagine fornito e dal relativo LatLngBounds. L'immagine viene ridimensionata per adattarsi ai limiti attuali e proiettata utilizzando la proiezione della mappa corrente.
getBounds
getBounds()
Parametri: nessuno
Valore restituito: LatLngBounds|null
Recupera il valore LatLngBounds di questo overlay.
getMap
getMap()
Parametri: nessuno
Valore restituito: Map|null
Restituisce la mappa su cui viene visualizzato questo overlay del terreno.
getOpacity
getOpacity()
Parametri: nessuno
Valore restituito: number
Restituisce l'opacità di questo overlay del terreno.
getUrl
getUrl()
Parametri: nessuno
Valore restituito: string
Recupera l'URL dell'immagine proiettata.
setMap
setMap(map)
Parametri:
  • map: Map optional
Valore restituito: nessuno
Esegue il rendering dell'overlay del terreno sulla mappa specificata. Se la mappa è impostata su null, l'overlay viene rimosso.
setOpacity
setOpacity(opacity)
Parametri:
  • opacity: number
Valore restituito: nessuno
Imposta l'opacità di questo overlay del terreno.
Ereditate: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
click
function(event)
Argomenti:
Questo evento viene attivato quando l'evento di clic DOM viene attivato su GroundOverlay.
dblclick
function(event)
Argomenti:
Questo evento viene attivato quando l'evento dblclick del DOM viene attivato su GroundOverlay.

Interfaccia GroundOverlayOptions

Interfaccia google.maps.GroundOverlayOptions

Questo oggetto definisce le proprietà che possono essere impostate su un oggetto GroundOverlay.

clickable
facoltativo
Tipo: boolean optional
Se true, l'overlay del terreno può ricevere eventi del mouse.
map
facoltativo
Tipo: Map optional
La mappa su cui visualizzare l'overlay.
opacity
facoltativo
Tipo: number optional
Valore predefinito: 1.0
L'opacità dell'overlay, espressa come numero compreso tra 0 e 1. Facoltativo.

Classe StyledMapType

google.maps.StyledMapType class
extends MVCObject
implements MapType
library "maps"

Crea un MapType con uno stile personalizzato.

const {StyledMapType} = await google.maps.importLibrary("maps");
StyledMapType
StyledMapType(styles[, options])
Parametri:
Crea un MapType con stile con le opzioni specificate. StyledMapType accetta un array di MapTypeStyle, in cui ogni MapTypeStyle viene applicato alla mappa in modo consecutivo. Un MapTypeStyle successivo che applica gli stessi MapTypeStyler agli stessi selettori di un MapTypeStyle precedente sostituirà quest'ultimo MapTypeStyle.

Tieni presente che StyledMapType non è supportato quando è impostato un ID mappa. Se utilizzi entrambi, riceverai un avviso nella console.
alt
Tipo: string
maxZoom
Tipo: number
minZoom
Tipo: number
name
Tipo: string
projection
Tipo: Projection optional
radius
Tipo: number
tileSize
Tipo: Size optional
getTile
getTile(tileCoord, zoom, ownerDocument)
Parametri:
  • tileCoord: Point optional coordinate dei riquadri.
  • zoom: zoom del riquadro number.
  • ownerDocument: Document optional il documento proprietario di questo riquadro.
Valore restituito: Element|null Tile risultante.
releaseTile
releaseTile(tile)
Parametri:
  • tile: Element optional Tile da rilasciare.
Valore restituito: nessuno
Ereditate: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

Interfaccia StyledMapTypeOptions

Interfaccia google.maps.StyledMapTypeOptions

Questa classe viene utilizzata per specificare le opzioni durante la creazione di un StyledMapType. Queste opzioni non possono essere modificate dopo la creazione dell'istanza di StyledMapType.

alt
facoltativo
Tipo: string optional
Testo da visualizzare quando il mouse viene passato sopra il pulsante di questo MapType nel controllo del tipo di mappa.
maxZoom
facoltativo
Tipo: number optional
Il livello di zoom massimo per la mappa quando viene visualizzato questo MapType. Facoltativo.
minZoom
facoltativo
Tipo: number optional
Il livello di zoom minimo per la mappa quando viene visualizzato questo MapType. Facoltativo.
name
facoltativo
Tipo: string optional
Il nome da visualizzare nel controllo del tipo di mappa.