Maps

Classe Map

google.maps.Map classe

Questa classe estende MVCObject.

Accedi chiamando const {Map} = await google.maps.importLibrary("maps"). Consulta la sezione Librerie nell'API Maps JavaScript.

Map
Map(mapDiv[, opts])
Parametri: 
  • mapDivHTMLElement la mappa verrà visualizzata in modo da riempire questo elemento.
  • optsMapOptions optional opzioni
Crea una nuova mappa all'interno del contenitore HTML specificato, che in genere è un elemento DIV.
DEMO_MAP_ID ID mappa che può essere utilizzato per esempi di codice che richiedono un ID mappa. Questo ID mappa non è destinato all'utilizzo in applicazioni di produzione e non può essere utilizzato per funzionalità che richiedono la configurazione su cloud (come Cloud Styling).
controls
Controlli aggiuntivi da aggiungere alla mappa. Per aggiungere un controllo alla mappa, aggiungi <div> del controllo a MVCArray corrispondente al ControlPosition in cui deve essere visualizzato.
data
Tipo:  Data
Un'istanza di Data associata alla mappa. Aggiungi elementi a questo oggetto Data per visualizzarli comodamente su questa mappa.
mapTypes
Un registro di MapType istanze per ID stringa.
overlayMapTypes
Tipo:  MVCArray<MapType optional>
Tipi di mappe aggiuntivi da sovrapporre. I tipi di mappe overlay vengono visualizzati in cima alla mappa base a cui sono associati, nell'ordine in cui appaiono nell'array overlayMapTypes (gli overlay con valori di indice più alti vengono visualizzati davanti a quelli con valori di indice più bassi).
fitBounds
fitBounds(bounds[, padding])
Parametri: 
  • boundsLatLngBounds|LatLngBoundsLiteral limiti da mostrare.
  • paddingnumber|Padding optional spaziatura interna in pixel. I limiti verranno adattati alla parte della mappa rimanente dopo la rimozione della spaziatura interna. Un valore numerico restituirà la stessa spaziatura interna su tutti e quattro i lati. Fornisci qui 0 per creare un valore fitBounds idempotente nel risultato di getBounds.
Valore restituito: nessuno
Imposta l'area visibile in modo che contenga i limiti specificati.
Nota: quando la mappa è impostata su display: none, la funzione fitBounds legge le dimensioni della mappa come 0 x 0 e pertanto non fa nulla. Per cambiare la visualizzazione quando la mappa è nascosta, imposta la mappa su visibility: hidden, in modo che il div della mappa abbia le dimensioni effettive. Per le mappe vettoriali, questo metodo imposta l'inclinazione e l'intestazione della mappa sui valori predefiniti zero. La chiamata a questo metodo potrebbe causare un'animazione fluida quando la mappa esegue panoramiche e zoom per adattarsi ai limiti. L'animazione o meno di questo metodo dipende da un'euristica interna.
getBounds
getBounds()
Parametri: nessuno
Valore restituito:  LatLngBounds|undefined i limiti lat/lng dell'area visibile corrente.
Restituisce i limiti latitudine/lng dell'area visibile corrente. Se è visibile più di una copia del mondo, la longitudine dei limiti è compresa tra -180 e 180 gradi inclusi. Se la mappa non è ancora stata inizializzata o se al centro non è stato impostato lo zoom, il risultato è undefined. Per le mappe vettoriali con inclinazione o intestazione diversa da zero, i limiti latitudine/lng restituiti rappresentano il riquadro di delimitazione più piccolo che include l'area visibile dell'area visibile della mappa. Consulta la sezione MapCanvasProjection.getVisibleRegion per ottenere l'esatta regione visibile dell'area visibile della mappa.
getCenter
getCenter()
Parametri: nessuno
Valore restituito:  LatLng|undefined
Restituisce la posizione visualizzata al centro della mappa. Tieni presente che questo oggetto LatLng non è aggregato. Consulta la pagina LatLng per saperne di più. Se il centro o i limiti non sono stati impostati, il risultato è undefined.
getClickableIcons
getClickableIcons()
Parametri: nessuno
Valore restituito:  boolean|undefined
Restituisce la cliccabilità delle icone della mappa. L'icona di una mappa rappresenta un punto d'interesse, chiamato anche PDI. Se il valore restituito è true, significa che è possibile fare clic sulle icone sulla mappa.
BetagetDatasetFeatureLayer
getDatasetFeatureLayer(datasetId)
Parametri: 
  • datasetIdstring
Valore restituito:  FeatureLayer
Restituisce FeatureLayer per il valore datasetId specificato. Gli ID set di dati devono essere configurati nella console Google Cloud. Se l'ID del set di dati non è associato allo stile della mappa o se non sono disponibili stili basati sui dati (nessun ID mappa, nessun riquadro vettoriale, nessun livello di elemento di tipo Stili basati sui dati o set di dati configurati nello stile della mappa), viene registrato un errore e il risultato FeatureLayer.isAvailable sarà false.
getDiv
getDiv()
Parametri: nessuno
Valore restituito:  HTMLElement il mapDiv della mappa.
getFeatureLayer
getFeatureLayer(featureType)
Parametri: 
Valore restituito:  FeatureLayer
Restituisce il FeatureLayer dello specifico FeatureType. È necessario abilitare un FeatureLayer nella console Google Cloud. Se un FeatureLayer del valore FeatureType specificato non esiste su questa mappa o se lo stile basato sui dati non è disponibile (nessun ID mappa, nessun riquadro vettoriale e nessun FeatureLayer abilitato nello stile di mappa), viene registrato un errore e il valore FeatureLayer.isAvailable risultante sarà falso.
getHeading
getHeading()
Parametri: nessuno
Valore restituito:  number|undefined
Restituisce l'intestazione della bussola della mappa. Il valore dell'intestazione viene misurato in gradi (in senso orario) dalla direzione cardinale a nord. Se la mappa non è stata ancora inizializzata, il risultato è undefined.
getMapCapabilities
getMapCapabilities()
Parametri: nessuno
Valore restituito:  MapCapabilities
Informa il chiamante delle funzionalità correnti disponibili per la mappa in base all'ID mappa fornito.
getMapTypeId
getMapTypeId()
Parametri: nessuno
Valore restituito:  MapTypeId|string|undefined
getProjection
getProjection()
Parametri: nessuno
Valore restituito:  Projection|undefined
Restituisce l'attuale Projection. Se la mappa non è stata ancora inizializzata, il risultato è undefined. Ascolta l'evento projection_changed e controlla il relativo valore per assicurarti che non sia undefined.
getRenderingType
getRenderingType()
Parametri: nessuno
Valore restituito:  RenderingType
Restituisce il RenderingType corrente della mappa.
getStreetView
getStreetView()
Parametri: nessuno
Valore restituito:  StreetViewPanorama il panorama associato alla mappa.
Restituisce StreetViewPanorama predefinito associato alla mappa, che può essere un panorama predefinito incorporato all'interno della mappa o l'insieme di panoramiche utilizzando setStreetView(). Le modifiche al streetViewControl della mappa verranno applicate alla visualizzazione della panoramica delimitata.
getTilt
getTilt()
Parametri: nessuno
Valore restituito:  number|undefined
Restituisce l'angolo di incidenza corrente della mappa, in gradi dal piano dell'area visibile a quello della mappa. Per le mappe raster, il risultato sarà 0 per le immagini scattate direttamente dall'alto o 45 per le immagini a 45°. Questo metodo non restituisce il valore impostato da setTilt. Per informazioni dettagliate, visita la pagina setTilt.
getZoom
getZoom()
Parametri: nessuno
Valore restituito:  number|undefined
Restituisce lo zoom della mappa. Se lo zoom non è stato impostato, il risultato è undefined.
moveCamera
moveCamera(cameraOptions)
Parametri: 
Valore restituito: nessuno
Consente di impostare immediatamente la fotocamera della mappa sulle opzioni fotocamera target, senza animazione.
panBy
panBy(x, y)
Parametri: 
  • xnumber numero di pixel per spostare la mappa nella direzione x.
  • ynumber numero di pixel per spostare la mappa nella direzione y.
Valore restituito: nessuno
Modifica il centro della mappa in base alla distanza specificata in pixel. Se la distanza è inferiore alla larghezza e all'altezza della mappa, la transizione verrà animata in modo uniforme. Tieni presente che il sistema di coordinate della mappa aumenta da ovest a est (per valori x) e da nord a sud (per valori y).
panTo
panTo(latLng)
Parametri: 
Valore restituito: nessuno
Cambia il centro della mappa nel valore LatLng specificato. Se la modifica è inferiore alla larghezza e all'altezza della mappa, la transizione verrà animata in modo uniforme.
panToBounds
panToBounds(latLngBounds[, padding])
Parametri: 
  • latLngBoundsLatLngBounds|LatLngBoundsLiteral i limiti verso cui eseguire la panoramica della mappa.
  • paddingnumber|Padding optional spaziatura interna in pixel. Un valore numerico restituirà la stessa spaziatura interna su tutti e quattro i lati. Il valore predefinito è 0.
Valore restituito: nessuno
Consente di spostare la mappa in base alla quantità minima necessaria per contenere il valore LatLngBounds specificato. Non garantisce in alcun modo la posizione dei confini sulla mappa, tranne per il fatto che la mappa verrà panoramica in modo da mostrare il maggior numero possibile di confini all'interno di {currentMapSizeInPx} - {padding}. Per le mappe raster e vettoriali, lo zoom, l'inclinazione e l'intestazione della mappa non subiranno modifiche.
setCenter
setCenter(latlng)
Parametri: 
Valore restituito: nessuno
setClickableIcons
setClickableIcons(value)
Parametri: 
  • valueboolean
Valore restituito: nessuno
Controlla se è possibile fare clic o meno sulle icone della mappa. L'icona di una mappa rappresenta un punto d'interesse, chiamato anche PDI. Per disattivare la cliccabilità delle icone delle mappe, trasmetti un valore pari a false a questo metodo.
setHeading
setHeading(heading)
Parametri: 
  • headingnumber
Valore restituito: nessuno
Consente di impostare l'intestazione della bussola per la mappa misurata in gradi dalla direzione cardinale a nord. Per le mappe raster, questo metodo si applica solo alle immagini aeree.
setMapTypeId
setMapTypeId(mapTypeId)
Parametri: 
Valore restituito: nessuno
setOptions
setOptions(options)
Parametri: 
Valore restituito: nessuno
setStreetView
setStreetView(panorama)
Parametri: 
Valore restituito: nessuno
Associa un StreetViewPanorama alla mappa. Questa panoramica sostituisce il valore StreetViewPanorama predefinito, consentendo l'associazione della mappa a una panoramica esterna al di fuori della mappa. L'impostazione del panorama su null associa la panoramica incorporata predefinita alla mappa.
setTilt
setTilt(tilt)
Parametri: 
  • tiltnumber
Valore restituito: nessuno
Per le mappe vettoriali, imposta l'angolo di incidenza della mappa. I valori consentiti sono limitati a seconda del livello di zoom della mappa. Per le mappe raster, controlla il comportamento di passaggio automatico per l'angolo di incidenza della mappa. Gli unici valori consentiti sono 0 e 45. setTilt(0) fa sì che la mappa utilizzi sempre una vista dall'alto di 0°, indipendentemente dal livello di zoom e dall'area visibile. setTilt(45) fa sì che l'angolo di inclinazione passi automaticamente a 45 ogni volta che sono disponibili immagini a 45° per l'area visibile e il livello di zoom correnti. Inoltre, viene impostato su 0 quando non sono disponibili immagini a 45° (comportamento predefinito). Le immagini a 45° sono disponibili solo per i tipi di mappe satellite e hybrid, all'interno di alcune località e con alcuni livelli di zoom. Nota: getTilt restituisce l'angolo di inclinazione corrente, non il valore impostato da setTilt. Poiché getTilt e setTilt fanno riferimento a elementi diversi, non bind() la proprietà tilt; ciò potrebbe produrre effetti imprevedibili.
setZoom
setZoom(zoom)
Parametri: 
  • zoomnumber Valori di zoom più grandi corrispondono a una risoluzione più elevata.
Valore restituito: nessuno
Imposta lo zoom della mappa.
Ereditati: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
bounds_changed
function()
Argomenti: nessuno
Questo evento viene attivato quando i limiti dell'area visibile sono cambiati.
center_changed
function()
Argomenti: nessuno
Questo evento viene attivato quando la proprietà Centro mappa cambia.
click
function(event)
Argomenti: 
Questo evento viene attivato quando l'utente fa clic sulla mappa. Viene restituito un MapMouseEvent con le proprietà per la posizione selezionata, a meno che non sia stato fatto clic sull'icona di un luogo, nel qual caso viene restituito un IconMouseEvent con un ID luogo. IconMouseEvent e MapMouseEvent sono identici, tranne per il fatto che IconMouseEvent ha il campo ID luogo. L'evento può sempre essere considerato come un MapMouseEvent quando l'ID luogo non è importante. L'evento di clic non viene attivato se l'utente fa clic su un indicatore o su una finestra informativa.
contextmenu
function(event)
Argomenti: 
Questo evento viene attivato quando l'evento del menu contestuale DOM viene attivato sul contenitore della mappa.
dblclick
function(event)
Argomenti: 
Questo evento viene attivato quando l'utente fa doppio clic sulla mappa. Tieni presente che l'evento clic a volte viene attivato una volta e talvolta due volte, subito prima di questo.
drag
function()
Argomenti: nessuno
Questo evento viene attivato ripetutamente mentre l'utente trascina la mappa.
dragend
function()
Argomenti: nessuno
Questo evento viene attivato quando l'utente smette di trascinare la mappa.
dragstart
function()
Argomenti: nessuno
Questo evento viene attivato quando l'utente inizia a trascinare la mappa.
heading_changed
function()
Argomenti: nessuno
Questo evento viene attivato quando la proprietà dell'intestazione della mappa cambia.
idle
function()
Argomenti: nessuno
Questo evento viene attivato quando la mappa diventa inattiva dopo la panoramica o lo zoom.
isfractionalzoomenabled_changed
function()
Argomenti: nessuno
Questo evento viene attivato quando la proprietà isFractionalZoomEnabled è stata modificata.
mapcapabilities_changed
function()
Argomenti: nessuno
Questo evento viene attivato quando le funzionalità della mappa cambiano.
maptypeid_changed
function()
Argomenti: nessuno
Questo evento viene attivato quando la proprietà mapTypeId cambia.
mousemove
function(event)
Argomenti: 
Questo evento viene attivato ogni volta che il mouse dell'utente si sposta sul contenitore della mappa.
mouseout
function(event)
Argomenti: 
Questo evento viene attivato quando il mouse dell'utente esce dal contenitore della mappa.
mouseover
function(event)
Argomenti: 
Questo evento viene attivato quando il mouse dell'utente entra nel contenitore della mappa.
projection_changed
function()
Argomenti: nessuno
Questo evento viene attivato quando la proiezione viene modificata.
renderingtype_changed
function()
Argomenti: nessuno
Questo evento viene attivato quando viene modificato il valore di renderingType.
tilesloaded
function()
Argomenti: nessuno
Questo evento viene attivato al termine del caricamento dei riquadri visibili.
tilt_changed
function()
Argomenti: nessuno
Questo evento viene attivato quando la proprietà di inclinazione della mappa cambia.
zoom_changed
function()
Argomenti: nessuno
Questo evento viene attivato quando la proprietà di zoom della mappa cambia.
rightclick
function(event)
Argomenti: 
Questo evento viene attivato quando l'utente fa clic con il tasto destro del mouse sulla mappa.

Interfaccia MapOptions

Interfaccia google.maps.MapOptions

Oggetto MapOptions utilizzato per definire le proprietà che possono essere impostate su una mappa.

backgroundColor optional
Tipo:  string optional
Colore utilizzato per lo sfondo del div della mappa. Questo colore sarà visibile quando i riquadri non sono ancora stati caricati mentre l'utente esegue la panoramica. Questa opzione può essere impostata solo quando la mappa è inizializzata.
center optional
Tipo:  LatLng|LatLngLiteral optional
Il centro iniziale della mappa.
clickableIcons optional
Tipo:  boolean optional
Valore predefinito: true
Se il valore è false, non è possibile fare clic sulle icone mappa. L'icona di una mappa rappresenta un punto d'interesse, chiamato anche PDI.
controlSize optional
Tipo:  number optional
Dimensioni in pixel dei controlli visualizzati sulla mappa. Questo valore deve essere fornito direttamente durante la creazione della mappa. Se lo aggiorni in un secondo momento, i controlli potrebbero passare allo stato undefined. Regola solo i controlli eseguiti dall'API di Google Maps stessa. Non scala i controlli personalizzati creati dagli sviluppatori.
disableDefaultUI optional
Tipo:  boolean optional
Attiva/disattiva tutti i pulsanti predefiniti dell'interfaccia utente. Possono essere sostituiti singolarmente. Non disattiva i controlli da tastiera, che sono controllati separatamente dall'opzione MapOptions.keyboardShortcuts. Non disattiva i controlli dei gesti, che vengono controllati separatamente dall'opzione MapOptions.gestureHandling.
disableDoubleClickZoom optional
Tipo:  boolean optional
Attiva/disattiva lo zoom e centra al doppio clic. Questa opzione è abilitata per impostazione predefinita.

Nota: questa proprietà è sconsigliata. Per disattivare lo zoom al doppio clic, puoi utilizzare la proprietà gestureHandling e impostarla su "none".

draggable optional
Tipo:  boolean optional
Se false, impedisce il trascinamento della mappa. Il trascinamento è abilitato per impostazione predefinita.
draggableCursor optional
Tipo:  string optional
Il nome o l'URL del cursore da visualizzare al passaggio del mouse su una mappa trascinabile. Questa proprietà utilizza l'attributo CSS cursor per modificare l'icona. Come per la proprietà CSS, devi specificare almeno un cursore di fallback che non sia un URL. Ad esempio: draggableCursor: 'url(http://www.example.com/icon.png), auto;'.
draggingCursor optional
Tipo:  string optional
Il nome o l'URL del cursore da visualizzare quando la mappa viene trascinata. Questa proprietà utilizza l'attributo CSS cursor per modificare l'icona. Come per la proprietà CSS, devi specificare almeno un cursore di fallback che non sia un URL. Ad esempio: draggingCursor: 'url(http://www.example.com/icon.png), auto;'.
fullscreenControl optional
Tipo:  boolean optional
Lo stato attivato/disattivato del controllo a schermo intero.
fullscreenControlOptions optional
Tipo:  FullscreenControlOptions optional
Le opzioni di visualizzazione per il controllo a schermo intero.
gestureHandling optional
Tipo:  string optional
Questa impostazione controlla in che modo l'API gestisce i gesti sulla mappa. Valori consentiti:
  • "cooperative": scorri gli eventi e i gesti di tocco con un dito per scorrere la pagina, senza eseguire lo zoom o la panoramica della mappa. I gesti tattili con due dita consentono di eseguire la panoramica e lo zoom della mappa. Scorri gli eventi con il tasto Ctrl o il tasto ⌘ premuto per eseguire lo zoom sulla mappa.
    In questa modalità la mappa collabora con la pagina.
  • "greedy": tutti i gesti touch e gli eventi di scorrimento consentono di eseguire la panoramica o lo zoom della mappa.
  • "none": non è possibile eseguire la panoramica o lo zoom sulla mappa tramite i gesti dell'utente.
  • "auto" (impostazione predefinita). La gestione dei gesti è cooperativa o avida, a seconda che la pagina possa essere scorrevole o all'interno di un iframe.
heading optional
Tipo:  number optional
L'intestazione per le immagini aeree, espressa in gradi, misurata in senso orario dalla direzione cardinale a nord. Le intestazioni vengono agganciate all'angolazione più vicina disponibile per cui sono disponibili le immagini.
isFractionalZoomEnabled optional
Tipo:  boolean optional
Predefinito: true per le mappe vettoriali e false per le mappe raster
Indica se la mappa deve consentire livelli di zoom frazionari. Ascolta isfractionalzoomenabled_changed per sapere quando è stata impostata l'impostazione predefinita.
keyboardShortcuts optional
Tipo:  boolean optional
Se false, impedisce che la mappa venga controllata dalla tastiera. Le scorciatoie da tastiera sono abilitate per impostazione predefinita.
mapId optional
Tipo:  string optional
L'ID mappa della mappa. Questo parametro non può essere impostato o modificato dopo aver creato un'istanza di una mappa.
mapTypeControl optional
Tipo:  boolean optional
Lo stato iniziale attivato/disattivato del controllo Tipo di mappa.
mapTypeControlOptions optional
Tipo:  MapTypeControlOptions optional
Le opzioni di visualizzazione iniziali per il controllo Tipo di mappa.
mapTypeId optional
Tipo:  MapTypeId|string optional
Il mapping iniziale di MapTypeId. Il valore predefinito è ROADMAP.
maxZoom optional
Tipo:  number optional
Il livello di zoom massimo che verrà visualizzato sulla mappa. Se omesso, o impostato su null, viene utilizzato lo zoom massimo del tipo di mappa corrente. I valori di zoom validi sono numeri da zero fino al livello di zoom massimo supportato.
minZoom optional
Tipo:  number optional
Il livello di zoom minimo che verrà visualizzato sulla mappa. Se omesso, o impostato su null, viene utilizzato lo zoom minimo del tipo di mappa corrente. I valori di zoom validi sono numeri da zero fino al livello di zoom massimo supportato.
noClear optional
Tipo:  boolean optional
Se true, non cancellare i contenuti del div della mappa.
panControl optional
Tipo:  boolean optional
Lo stato attivato/disattivato del controllo Panoramica.

panControlOptions optional
Tipo:  PanControlOptions optional
Le opzioni di visualizzazione per il controllo Panoramica.

restriction optional
Tipo:  MapRestriction optional
Definisce un confine che limita l'area della mappa accessibile agli utenti. Quando questa impostazione è impostata, l'utente può eseguire la panoramica e lo zoom solo quando la visualizzazione della videocamera rimane entro i limiti del confine.
rotateControl optional
Tipo:  boolean optional
Lo stato attivato/disattivato del controllo Ruota.
rotateControlOptions optional
Tipo:  RotateControlOptions optional
Le opzioni di visualizzazione per il controllo Ruota.
scaleControl optional
Tipo:  boolean optional
Lo stato iniziale di attivazione/disattivazione del controllo Bilancia.
scaleControlOptions optional
Tipo:  ScaleControlOptions optional
Le opzioni di visualizzazione iniziali per il controllo Scale.
scrollwheel optional
Tipo:  boolean optional
Se false, disattiva lo zoom sulla mappa utilizzando la rotellina del mouse. La rotellina è attiva per impostazione predefinita.

Nota: questa proprietà è sconsigliata. Per disattivare lo zoom con la rotellina, puoi utilizzare la proprietà gestureHandling e impostarla su "cooperative" o "none".

streetView optional
Tipo:  StreetViewPanorama optional
Un StreetViewPanorama da mostrare quando il Pegman di Street View viene rilasciato sulla mappa. Se non viene specificata alcuna panoramica, verrà visualizzato un valore predefinito StreetViewPanorama in div della mappa quando il pegman viene rilasciato.
streetViewControl optional
Tipo:  boolean optional
Lo stato iniziale attivato/disattivato del controllo Pegman di Street View. Questo controllo fa parte dell'interfaccia utente predefinita e deve essere impostato su false quando visualizzi un tipo di mappa su cui non deve apparire l'overlay stradale di Street View (ad es. un tipo di mappa non Earth).
streetViewControlOptions optional
Tipo:  StreetViewControlOptions optional
Le opzioni di visualizzazione iniziali per il controllo Pegman di Street View.
styles optional
Tipo:  Array<MapTypeStyle> optional
Stili da applicare a ciascuno dei tipi di mappa predefiniti. Tieni presente che per le modalità satellite/hybrid e terrain, questi stili verranno applicati solo alle etichette e alla geometria.
tilt optional
Tipo:  number optional
Per le mappe vettoriali, imposta l'angolo di incidenza della mappa. I valori consentiti sono limitati a seconda del livello di zoom della mappa. Per le mappe raster, controlla il comportamento di passaggio automatico per l'angolo di incidenza della mappa. Gli unici valori consentiti sono 0 e 45. Il valore 0 fa sì che la mappa utilizzi sempre una vista dall'alto di 0°, indipendentemente dal livello di zoom e dall'area visibile. Il valore 45 fa sì che l'angolo di inclinazione passi automaticamente a 45 ogni volta che sono disponibili immagini a 45° per l'area visibile e il livello di zoom correnti. Viene impostato nuovamente su 0 quando non sono disponibili immagini a 45° (comportamento predefinito). Le immagini a 45° sono disponibili solo per i tipi di mappe satellite e hybrid, all'interno di alcune località e con alcuni livelli di zoom. Nota: getTilt restituisce l'angolo di inclinazione corrente, non il valore specificato da questa opzione. Poiché getTilt e questa opzione si riferiscono a cose diverse, non bind() la proprietà tilt; ciò potrebbe produrre effetti imprevedibili.
zoom optional
Tipo:  number optional
Il livello di zoom iniziale della mappa. I valori di zoom validi sono numeri da zero fino al livello di zoom massimo supportato. Valori di zoom più grandi corrispondono a una risoluzione più elevata.
zoomControl optional
Tipo:  boolean optional
Lo stato attivato/disattivato del controllo Zoom.
zoomControlOptions optional
Tipo:  ZoomControlOptions optional
Le opzioni di visualizzazione per il controllo Zoom.

MapElement

google.maps.MapElement classe

MapElement è una sottoclasse HTMLElement per il rendering delle mappe. Dopo aver caricato la libreria maps, è possibile creare una mappa in HTML. Ad esempio:

<gmp-map center="37.4220656,-122.0840897" zoom="10" map-id="DEMO_MAP_ID">
  <button slot="control-block-start-inline-end">Custom Control</button>
</gmp-map>

Internamente, utilizza Map, a cui è possibile accedere con la proprietà innerMap.

Elemento personalizzato:
<gmp-map center="lat,lng" map-id="string" zoom="number"></gmp-map>

Questa classe estende HTMLElement.

Questa classe implementa MapElementOptions.

Accedi chiamando const {MapElement} = await google.maps.importLibrary("maps"). Consulta la sezione Librerie nell'API Maps JavaScript.

center
Tipo:  LatLng|LatLngLiteral optional
La latitudine/longitudine centrale della mappa.
Attributo HTML:
  • <gmp-map center="lat,lng"></gmp-map>
innerMap
Tipo:  Map
Un riferimento all'elemento Map utilizzato internamente da MapElement.
mapId
Tipo:  string optional
L'ID della mappa. Per ulteriori informazioni, consulta la documentazione relativa all'ID mappa.
Attributo HTML:
  • <gmp-map map-id="string"></gmp-map>
zoom
Tipo:  number optional
Il livello di zoom della mappa.
Attributo HTML:
  • <gmp-map zoom="number"></gmp-map>
control-block-end-inline-center
Posiziona l'elemento asolato nella posizione ControlPosition.BLOCK_END_INLINE_CENTER.
control-block-end-inline-end
Posiziona l'elemento asolato nella posizione ControlPosition.BLOCK_END_INLINE_END.
control-block-end-inline-start
Posiziona l'elemento asolato nella posizione ControlPosition.BLOCK_END_INLINE_START.
control-block-start-inline-center
Posiziona l'elemento asolato nella posizione ControlPosition.BLOCK_START_INLINE_CENTER.
control-block-start-inline-end
Posiziona l'elemento asolato nella posizione ControlPosition.BLOCK_START_INLINE_END.
control-block-start-inline-start
Posiziona l'elemento asolato nella posizione ControlPosition.BLOCK_START_INLINE_START.
control-inline-end-block-center
Posiziona l'elemento asolato nella posizione ControlPosition.INLINE_END_BLOCK_CENTER.
control-inline-end-block-end
Posiziona l'elemento asolato nella posizione ControlPosition.INLINE_END_BLOCK_END.
control-inline-end-block-start
Posiziona l'elemento asolato nella posizione ControlPosition.INLINE_END_BLOCK_START.
control-inline-start-block-center
Posiziona l'elemento asolato nella posizione ControlPosition.INLINE_START_BLOCK_CENTER.
control-inline-start-block-end
Posiziona l'elemento asolato nella posizione ControlPosition.INLINE_START_BLOCK_END.
control-inline-start-block-start
Posiziona l'elemento asolato nella posizione ControlPosition.INLINE_START_BLOCK_START.
BetaaddEventListener
addEventListener(type, listener[, options])
Parametri: 
  • typestring una stringa sensibile alle maiuscole che rappresenta il tipo di evento da ascoltare.
  • listenerEventListener|EventListenerObject l'oggetto che riceve una notifica. Deve essere una funzione o un oggetto con il metodo handleEvent
  • optionsboolean|AddEventListenerOptions optional Vedi le opzioni. Gli eventi personalizzati supportano solo capture e passive.
Valore restituito:  void
Imposta una funzione che verrà chiamata ogni volta che l'evento specificato viene pubblicato nella destinazione. Vedi addEventListener
BetaremoveEventListener
removeEventListener(type, listener[, options])
Parametri: 
  • typestring una stringa che specifica il tipo di evento per il quale rimuovere un listener di eventi.
  • listenerEventListener|EventListenerObject il listener di eventi del gestore di eventi da rimuovere dalla destinazione dell'evento.
  • optionsboolean|EventListenerOptions optional Vedi le opzioni
Valore restituito:  void
Rimuove dalla destinazione un listener di eventi precedentemente registrato con hreflang. Vedi removeEventListener
gmp-zoomchange
function(event)
Argomenti: 
Questo evento viene attivato quando la proprietà di zoom della mappa cambia.

Interfaccia MapElementOptions

Interfaccia google.maps.MapElementOptions

Oggetto MapElementOptions utilizzato per definire le proprietà che possono essere impostate su un MapElement.

center optional
Tipo:  LatLng|LatLngLiteral optional
Il centro iniziale della mappa.
mapId optional
Tipo:  string optional
L'ID mappa della mappa. Questo parametro non può essere impostato o modificato dopo aver creato un'istanza di una mappa.
zoom optional
Tipo:  number optional
Il livello di zoom iniziale della mappa. I valori di zoom validi sono numeri da zero fino al livello di zoom massimo supportato. Valori di zoom più grandi corrispondono a una risoluzione più elevata.

ZoomChangeEvent

google.maps.ZoomChangeEvent classe

Questo evento viene creato dal monitoraggio della modifica dello zoom.

Questa classe estende Event.

Accedi chiamando const {ZoomChangeEvent} = await google.maps.importLibrary("maps"). Consulta la sezione Librerie nell'API Maps JavaScript.

Interfaccia MapTypeStyle

Interfaccia google.maps.MapTypeStyle

MapTypeStyle è una raccolta di selettori e stili che definiscono l'impostazione di uno stile per la mappa. I selettori specificano gli elementi e/o gli elementi della mappa che devono essere interessati, mentre gli strumenti di stile specificano le modalità di modifica di tali elementi ed elementi. Per maggiori dettagli, consulta la documentazione di riferimento sugli stili.

stylers
Tipo:  Array<Object>
Le regole di stile da applicare agli elementi e agli elementi della mappa selezionati. Le regole vengono applicate nell'ordine specificato in questo array. Per le linee guida sull'utilizzo e sui valori consentiti, consulta la documentazione di riferimento sugli stili.
elementType optional
Tipo:  string optional
L'elemento a cui applicare uno styler. Un elemento è un aspetto visivo di un elemento sulla mappa. Esempio: un'etichetta, un'icona, il tratto o il riempimento applicati alla geometria e altro ancora. Campo facoltativo. Se elementType non è specificato, si presume che il valore sia 'all'. Per i dettagli sull'utilizzo e sui valori consentiti, consulta la documentazione di riferimento sugli stili.
featureType optional
Tipo:  string optional
L'elemento o il gruppo di elementi a cui deve essere applicato uno styler. Campo facoltativo. Se featureType non è specificato, si presume che il valore sia 'all'. Per i dettagli sull'utilizzo e sui valori consentiti, consulta la documentazione di riferimento sugli stili.

Interfaccia MapMouseEvent

Interfaccia google.maps.MapMouseEvent

Questo oggetto viene restituito da vari eventi del mouse sulla mappa e dagli overlay e contiene tutti i campi mostrati di seguito.

domEvent
L'evento DOM nativo corrispondente. Gli sviluppatori non devono fare affidamento sulla definizione e coerenza delle proprietà target, currentTarget, relatedTarget e path. Gli sviluppatori non devono fare affidamento sulla struttura DOM dell'implementazione interna dell'API di Google Maps. A causa della mappatura interna degli eventi, domEvent potrebbe avere una semantica diversa da quella di MapMouseEvent (ad esempio, un "clic" MapMouseEvent potrebbe avere un domEvent di tipo KeyboardEvent).
latLng optional
Tipo:  LatLng optional
La latitudine/longitudine sotto il cursore quando si è verificato l'evento.
stop
stop()
Parametri: nessuno
Valore restituito:  void
Impedisce l'ulteriore propagazione di questo evento.

Interfaccia IconMouseEvent

Interfaccia google.maps.IconMouseEvent

Questo oggetto viene inviato in un evento quando un utente fa clic su un'icona sulla mappa. L'ID luogo di questo luogo è archiviato nel membro placeId. Per evitare che venga visualizzata la finestra informativa predefinita, chiama il metodo stop() su questo evento per evitare che venga propagato. Scopri di più sugli ID luogo nella guida per gli sviluppatori dell'API Places.

Questa interfaccia estende MapMouseEvent.

placeId optional
Tipo:  string optional
L'ID del luogo su cui è stato fatto clic. Questo ID luogo può essere utilizzato per eseguire query su ulteriori informazioni sull'elemento su cui è stato fatto clic.

Scopri di più sugli ID luogo nella guida per gli sviluppatori dell'API Places.

Ereditati: domEvent, latLng
Ereditato: stop

costanti MapTypeId

google.maps.MapTypeId costanti

Identificatori per i MapTypes comuni. Specificale in base a un valore o utilizzando il nome della costante. Ad esempio, 'satellite' o google.maps.MapTypeId.SATELLITE.

Accedi chiamando const {MapTypeId} = await google.maps.importLibrary("maps"). Consulta la sezione Librerie nell'API Maps JavaScript.

HYBRID Questo tipo di mappa mostra un livello trasparente delle strade principali nelle immagini satellitari.
ROADMAP Questo tipo di mappa mostra una normale mappa stradale.
SATELLITE Questo tipo di mappa mostra immagini satellitari.
TERRAIN Questo tipo di mappa mostra mappe con caratteristiche fisiche come terreno e vegetazione.

MapTypeRegistry

google.maps.MapTypeRegistry classe

Un registro per le istanze MapType, chiavi in base all'ID MapType.

Questa classe estende MVCObject.

Accedi chiamando const {MapTypeRegistry} = await google.maps.importLibrary("maps"). Consulta la sezione Librerie nell'API Maps JavaScript.

MapTypeRegistry
MapTypeRegistry()
Parametri: nessuno
L'elemento MapTypeRegistry contiene la raccolta di tipi di mappe personalizzate disponibili per la mappa per il suo utilizzo. L'API consulta questo registro quando fornisce l'elenco dei tipi di mappa disponibili all'interno dei controlli, ad esempio.
set
set(id, mapType)
Parametri: 
  • idstring identificatore del MapType da aggiungere al registro.
  • mapTypeMapType|* oggetto MapType da aggiungere al registro.
Valore restituito: nessuno
Imposta il registro per associare l'identificatore della stringa passata al MapType passato.
Ereditati: addListener, bindTo, get, notify, setValues, unbind, unbindAll

Interfaccia MapRestriction

Interfaccia google.maps.MapRestriction

Una restrizione che può essere applicata alla mappa. La visualizzazione della mappa non supererà questi limiti.

latLngBounds
Se questa impostazione è impostata, l'utente può eseguire la panoramica e lo zoom solo all'interno dei limiti specificati. I limiti possono limitare sia la longitudine che la latitudine oppure solo la latitudine. Per i limiti di sola latitudine, utilizza le longitudine ovest ed est rispettivamente -180 e 180, ad esempio latLngBounds: {north: northLat, south: southLat, west: -180, east: 180}.
strictBounds optional
Tipo:  boolean optional
I limiti possono essere resi più restrittivi impostando il flag strictBounds su true. Questo riduce di quanto un utente può diminuire lo zoom, garantendo che tutti gli elementi al di fuori dei limiti limitati rimangano nascosti. Il valore predefinito è false, il che significa che un utente può diminuire lo zoom finché non viene visualizzata l'intera area delimitata, incluse eventuali aree esterne all'area delimitata.

classe TrafficLayer

google.maps.TrafficLayer classe

Un livello di traffico.

Questa classe estende MVCObject.

Accedi chiamando const {TrafficLayer} = await google.maps.importLibrary("maps"). Consulta la sezione Librerie nell'API Maps JavaScript.

TrafficLayer
TrafficLayer([opts])
Parametri: 
Un livello che mostra il traffico stradale attuale.
getMap
getMap()
Parametri: nessuno
Valore restituito:  Map
Restituisce la mappa su cui è visualizzato il livello.
setMap
setMap(map)
Parametri: 
Valore restituito: nessuno
Visualizza il livello sulla mappa specificata. Se la mappa è impostata su null, il livello verrà rimosso.
setOptions
setOptions(options)
Parametri: 
Valore restituito: nessuno
Ereditati: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

Interfaccia TrafficLayerOptions

Interfaccia google.maps.TrafficLayerOptions

Oggetto TrafficlayerOptions utilizzato per definire le proprietà che possono essere impostate su un Trafficlayer.

autoRefresh optional
Tipo:  boolean optional
Valore predefinito: true
Indica se il livello di traffico si aggiorna automaticamente con informazioni aggiornate.
map optional
Tipo:  Map optional
Mappa su cui visualizzare il livello di traffico.

Classe TransitLayer

google.maps.TransitLayer classe

Un livello di trasporto pubblico.

Questa classe estende MVCObject.

Accedi chiamando const {TransitLayer} = await google.maps.importLibrary("maps"). Consulta la sezione Librerie nell'API Maps JavaScript.

TransitLayer
TransitLayer()
Parametri: nessuno
Un livello che mostra le linee di trasporto pubblico.
getMap
getMap()
Parametri: nessuno
Valore restituito:  Map
Restituisce la mappa su cui è visualizzato il livello.
setMap
setMap(map)
Parametri: 
Valore restituito: nessuno
Visualizza il livello sulla mappa specificata. Se la mappa è impostata su null, il livello verrà rimosso.
Ereditati: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

BicyclingLayer

google.maps.BicyclingLayer classe

Un livello che mostra le piste ciclabili e i percorsi.

Questa classe estende MVCObject.

Accedi chiamando const {BicyclingLayer} = await google.maps.importLibrary("maps"). Consulta la sezione Librerie nell'API Maps JavaScript.

BicyclingLayer
BicyclingLayer()
Parametri: nessuno
Un livello che mostra le piste ciclabili e i percorsi e che fa retrocedere grandi strade.
getMap
getMap()
Parametri: nessuno
Valore restituito:  Map
Restituisce la mappa su cui è visualizzato il livello.
setMap
setMap(map)
Parametri: 
Valore restituito: nessuno
Visualizza il livello sulla mappa specificata. Se la mappa è impostata su null, il livello verrà rimosso.
Ereditati: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

Interfaccia CameraOptions

Interfaccia google.maps.CameraOptions

Utilizzato per impostare le opzioni della fotocamera della mappa.

center optional
Tipo:  LatLngLiteral|LatLng optional
heading optional
Tipo:  number optional
tilt optional
Tipo:  number optional
zoom optional
Tipo:  number optional

Interfaccia VisibleRegion

Interfaccia google.maps.VisibleRegion

Contiene i quattro punti che definiscono il poligono a quattro lati, che rappresenta la regione visibile della mappa. Su una mappa vettoriale, questo poligono può essere un trapezio anziché un rettangolo, quando una mappa vettoriale ha un'inclinazione.

farLeft
Tipo:  LatLng
farRight
Tipo:  LatLng
latLngBounds
Tipo:  LatLngBounds
Il riquadro di delimitazione più piccolo che include l'area visibile.
nearLeft
Tipo:  LatLng
nearRight
Tipo:  LatLng

costanti RenderingType

google.maps.RenderingType costanti

Accedi chiamando const {RenderingType} = await google.maps.importLibrary("maps"). Consulta la sezione Librerie nell'API Maps JavaScript.

RASTER Indica che la mappa è una mappa raster.
UNINITIALIZED Indica che non è ancora noto se la mappa sia vettoriale o raster, perché l'inizializzazione della mappa non è ancora terminata.
VECTOR Indica che la mappa è una mappa vettoriale.

Interfaccia MapCapabilities

Interfaccia google.maps.MapCapabilities

Oggetto contenente un'istantanea delle funzionalità attualmente disponibili per la mappa. Tieni presente che questo non significa necessariamente che i moduli pertinenti siano caricati o inizializzati, ma piuttosto che la mappa corrente abbia l'autorizzazione per utilizzare queste API. Consulta le proprietà per un elenco delle possibili funzionalità.

isAdvancedMarkersAvailable optional
Tipo:  boolean optional
Se true, questa mappa è configurata correttamente per consentire l'utilizzo di indicatori avanzati. Tieni presente che devi comunque importare la libreria marker per utilizzare gli indicatori avanzati. Per ulteriori informazioni, visita la pagina https://goo.gle/gmp-isAdvancedMarkersAvailable.
isDataDrivenStylingAvailable optional
Tipo:  boolean optional
Se il valore è true, questa mappa è configurata correttamente per consentire l'utilizzo di stili basati sui dati per almeno un Feature Layer. Per ulteriori informazioni, visita le pagine https://goo.gle/gmp-data-driven-styling e https://goo.gle/gmp-FeatureLayerIsAvailable.