Maps

Classe mappatura

google.maps.Map corso

Questa lezione si estende a MVCObject.

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

Costruttore
Map	Map(mapDiv[, opts]) Parametri:  mapDiv:  HTMLElement la mappa verrà visualizzata per riempire questo elemento. opts:  MapOptions optional opzioni Crea una nuova mappa all'interno del contenitore HTML specificato, che in genere è un elemento DIV.

Proprietà
controls	Tipo:  Array<MVCArray<HTMLElement>> Controlli aggiuntivi da allegare alla mappa. Per aggiungere un controllo alla mappa, aggiungi l'intestazione <div> del controllo al valore MVCArray corrispondente al valore ControlPosition in cui deve essere eseguito il rendering.
data	Tipo:  Data Un'istanza di Data, associata alla mappa. Aggiungi elementi a questo oggetto Data per visualizzarli comodamente su questa mappa.
mapTypes	Tipo:  MapTypeRegistry Un registro di MapType istanze in base all'ID stringa.
overlayMapTypes	Tipo:  MVCArray<MapType optional> Altri tipi di mappa da sovrapporre. I tipi di mappa in overlay verranno visualizzati nella parte superiore della mappa di base a cui sono allegati, nell'ordine di visualizzazione nell'array di overlayMapTypes (gli overlay con valori di indice più elevati vengono visualizzati davanti agli overlay con valori di indice più bassi).

Metodi
fitBounds	fitBounds(bounds[, padding]) Parametri:  bounds:  LatLngBounds|LatLngBoundsLiteral limiti da mostrare. padding:  number|Padding optional Spaziatura interna in pixel. I limiti verranno inseriti nella parte della mappa che rimarrà dopo che la spaziatura interna sarà stata rimossa. Un valore numerico produrrà la stessa spaziatura interna su tutti e quattro i lati. Inserisci 0 qui per rendere un 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 esegue alcuna azione. Per modificare l'area visibile mentre la mappa è nascosta, imposta la mappa su visibility: hidden, in modo che le dimensioni del div della mappa siano effettive. Per le mappe vettoriali, questo metodo imposta l'inclinazione e l'intestazione della mappa sui valori zero predefiniti. Se chiami questo metodo, puoi creare un'animazione fluida mentre la mappa si sposta e lo zoom si adatta ai limiti. La possibilità di animare questo metodo dipende da un'euristica interna.
getBounds	getBounds() Parametri: nessuna Valore restituito:  LatLngBounds|undefined i limiti di latitudine/longitudine dell'area visibile corrente. Restituisce i limiti di latitudine/longitudine dell'area visibile corrente. Se sono visibili più copie del mondo, i limiti di longitudine variano da -180 a 180 gradi inclusi. Se la mappa non è ancora stata inizializzata o non è stata impostata lo zoom e il centro, il risultato è undefined. Per le mappe vettoriali con inclinazione o direzione diverse da zero, i limiti di latitudine/longitudine corrispondenti rappresentano il riquadro di delimitazione più piccolo che include l'area visibile dell'area visibile della mappa. Visualizza MapCanvasProjection.getVisibleRegion per ottenere la regione visibile esatta dell'area visibile della mappa.
getCenter	getCenter() Parametri: nessuna 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: nessuna Valore restituito:  boolean|undefined Restituisce la cliccabilità delle icone della mappa. L'icona di una mappa rappresenta un punto di interesse, noto anche come PDI. Se il valore restituito è true, è possibile fare clic sulle icone sulla mappa.
getDatasetFeatureLayer	Avviso:disponibile solo nel canale v=beta. getDatasetFeatureLayer(datasetId) Parametri:  datasetId:  string Valore restituito:  FeatureLayer Restituisce il FeatureLayer per il 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 della mappa o se lo stile basato sui dati non è disponibile (nessun ID mappa, nessun riquadro vettoriale, nessun livello di funzionalità per lo stile basato sui dati o set di dati configurati nello stile della mappa), viene registrato un errore e il valore FeatureLayer.isAvailable risultante è false.
getDiv	getDiv() Parametri: nessuna Valore restituito:  HTMLElement il mappaDiv della mappa.
getFeatureLayer	getFeatureLayer(featureType) Parametri:  featureType:  FeatureType Valore restituito:  FeatureLayer Restituisce il FeatureLayer di FeatureType specifico. È necessario abilitare FeatureLayer in Google Cloud Console. Se FeatureLayer sulla FeatureType specificata non esiste su questa mappa o se lo stile basato sui dati non è disponibile (nessun ID mappa, nessun riquadro vettoriale e FeatureLayer non attivato nello stile mappa), viene registrato un errore e il risultato FeatureLayer.isAvailable è false.
getHeading	getHeading() Parametri: nessuna 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 verso nord. Se la mappa non è ancora stata inizializzata, il risultato è undefined.
getMapCapabilities	getMapCapabilities() Parametri: nessuna Valore restituito:  MapCapabilities Informa il chiamante delle funzioni correnti disponibili per la mappa in base all'ID mappa fornito.
getMapTypeId	getMapTypeId() Parametri: nessuna Valore restituito:  MapTypeId|string|undefined
getProjection	getProjection() Parametri: nessuna Valore restituito:  Projection|undefined Restituisce l'attuale Projection. Se la mappa non è ancora stata inizializzata, il risultato è undefined. Ascolta l'evento projection_changed e controllane il valore per assicurarti che non sia undefined.
getRenderingType	getRenderingType() Parametri: nessuna Valore restituito:  RenderingType Restituisce l'attuale RenderingType della mappa.
getStreetView	getStreetView() Parametri: nessuna Valore restituito:  StreetViewPanorama la panoramica associata alla mappa. Restituisce la StreetViewPanorama predefinita associata alla mappa, che può essere un panorama predefinito incorporato all'interno della mappa, oppure la panoramica impostata utilizzando setStreetView(). Le modifiche all'elemento streetViewControl della mappa verranno riportate nella visualizzazione di una panoramica di questo tipo.
getTilt	getTilt() Parametri: nessuna Valore restituito:  number|undefined Restituisce l'angolo di incidenza corrente della mappa, in gradi, dal piano di visualizzazione al piano della mappa. Per le mappe raster, il risultato sarà 0 per le immagini scattate direttamente in alto o 45 per quelle a 45°. Questo metodo non restituisce il valore impostato da setTilt. Per informazioni dettagliate, visita la pagina setTilt.
getZoom	getZoom() Parametri: nessuna Valore restituito:  number|undefined Restituisce lo zoom della mappa. Se lo zoom non è stato impostato, il risultato è undefined.
moveCamera	moveCamera(cameraOptions) Parametri:  cameraOptions:  CameraOptions Valore restituito: nessuno Immediatamente, la fotocamera della mappa imposta le opzioni della fotocamera target, senza animazione.
panBy	panBy(x, y) Parametri:  x:  number numero di pixel per spostare la mappa nella direzione x. y:  number 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 sarà animata senza problemi. Tieni presente che il sistema di coordinate della mappa aumenta da ovest a est (per i valori x) e da nord a sud (per i valori y).
panTo	panTo(latLng) Parametri:  latLng:  LatLng|LatLngLiteral la nuova latitudine/longitudine del centro della mappa. Valore restituito: nessuno Modifica il centro della mappa con il valore LatLng specificato. Se la modifica è inferiore sia alla larghezza che all'altezza della mappa, la transizione sarà animata senza problemi.
panToBounds	panToBounds(latLngBounds[, padding]) Parametri:  latLngBounds:  LatLngBounds|LatLngBoundsLiteral i limiti in cui eseguire la panoramica della mappa. padding:  number|Padding optional Spaziatura interna in pixel. Un valore numerico produrrà la stessa spaziatura interna su tutti e quattro i lati. Il valore predefinito è 0. Valore restituito: nessuno Esplora la mappa in base alla quantità minima necessaria per contenere la LatLngBounds specificata. Non è garantito che verranno posizionati i confini sulla mappa, ma la mappa verrà eseguita per mostrare il maggior numero possibile di confini all'interno di {currentMapSizeInPx} - {padding}. né per le mappe raster né per quelle vettoriali, lo zoom, l'inclinazione e l'intestazione della mappa non subiranno modifiche.
setCenter	setCenter(latlng) Parametri:  latlng:  LatLng|LatLngLiteral Valore restituito: nessuno
setClickableIcons	setClickableIcons(value) Parametri:  value:  boolean Valore restituito: nessuno Stabilisce se le icone della mappa sono cliccabili o meno. L'icona di una mappa rappresenta un punto di interesse, noto anche come PDI. Per disattivare la cliccabilità delle icone mappa, passa un valore di false a questo metodo.
setHeading	setHeading(heading) Parametri:  heading:  number Valore restituito: nessuno Imposta l'intestazione della bussola per la mappa misurata in gradi dalla direzione cardinale nord. Per le mappe raster, questo metodo si applica solo alle immagini aeree.
setMapTypeId	setMapTypeId(mapTypeId) Parametri:  mapTypeId:  MapTypeId|string Valore restituito: nessuno
setOptions	setOptions(options) Parametri:  options:  MapOptions optional Valore restituito: nessuno
setStreetView	setStreetView(panorama) Parametri:  panorama:  StreetViewPanorama optional la panoramica da associare alla mappa. Valore restituito: nessuno Consente di associare StreetViewPanorama alla mappa. Questa panoramica sostituisce il valore predefinito StreetViewPanorama, consentendo l'associazione della mappa a un panorama esterno al di fuori della mappa. Se imposti la panoramica su null, la mappa panoramica predefinita viene associata alla mappa.
setTilt	setTilt(tilt) Parametri:  tilt:  number 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 automatico del cambio 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 il livello di zoom e l'area visibile correnti e torna a 0 ogni volta che non sono disponibili immagini a 45° (questo è il comportamento predefinito). Le immagini a 45° sono disponibili solo per i tipi di mappa 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 cose diverse, non bind() la proprietà tilt, in quanto ciò potrebbe produrre effetti imprevedibili.
setZoom	setZoom(zoom) Parametri:  zoom:  number valori di zoom più grandi corrispondono a una risoluzione più elevata. Valore restituito: nessuno Consente di impostare lo zoom della mappa.
Ereditato: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

Costanti
DEMO_MAP_ID	ID mappa che può essere utilizzato per esempi di codice che richiedono un ID mappa. Questo ID mappa non è destinato all'uso in applicazioni di produzione e non può essere utilizzato per funzionalità che richiedono una configurazione cloud (come Cloud Styling).

Eventi
bounds_changed	function() Argomenti: nessuna Questo evento viene attivato quando i limiti dell'area visibile sono cambiati.
center_changed	function() Argomenti: nessuna Questo evento viene attivato quando la proprietà Maps Center cambia.
click	function(event) Argomenti:  event:  MapMouseEvent|IconMouseEvent Questo evento viene attivato quando l'utente fa clic sulla mappa. Viene restituito un MapMouseEvent con proprietà per la località selezionata, a meno che non venga 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 trattato come un MapMapEvent quando l'ID luogo non è importante. L'evento di clic non viene attivato se è stato fatto clic su un indicatore o su una finestra informativa.
contextmenu	function(event) Argomenti:  event:  MapMouseEvent Questo evento viene attivato quando l'evento del menu contestuale DOM viene attivato sul contenitore della mappa.
dblclick	function(event) Argomenti:  event:  MapMouseEvent Questo evento viene attivato quando l'utente fa doppio clic sulla mappa. Tieni presente che a volte l'evento di clic viene attivato una e due volte, prima di questo evento.
drag	function() Argomenti: nessuna Questo evento viene attivato ripetutamente mentre l'utente trascina la mappa.
dragend	function() Argomenti: nessuna Questo evento viene attivato quando l'utente smette di trascinare la mappa.
dragstart	function() Argomenti: nessuna Questo evento viene attivato quando l'utente inizia a trascinare la mappa.
heading_changed	function() Argomenti: nessuna Questo evento viene attivato quando la proprietà dell'intestazione della mappa cambia.
idle	function() Argomenti: nessuna Questo evento viene attivato quando la mappa diventa inattiva dopo la panoramica o lo zoom.
isfractionalzoomenabled_changed	function() Argomenti: nessuna Questo evento viene attivato quando la proprietà isFractionalZoomEnabled è stata modificata.
mapcapabilities_changed	function() Argomenti: nessuna Questo evento viene attivato quando le funzionalità della mappa cambiano.
maptypeid_changed	function() Argomenti: nessuna Questo evento viene attivato quando la proprietà mapTypeId cambia.
mousemove	function(event) Argomenti:  event:  MapMouseEvent Questo evento viene attivato ogni volta che il mouse dell'utente passa sopra il contenitore della mappa.
mouseout	function(event) Argomenti:  event:  MapMouseEvent Questo evento viene attivato quando il mouse dell'utente esce dal contenitore della mappa.
mouseover	function(event) Argomenti:  event:  MapMouseEvent Questo evento viene attivato quando il mouse dell'utente accede al contenitore della mappa.
projection_changed	function() Argomenti: nessuna Questo evento viene attivato quando la proiezione è cambiata.
renderingtype_changed	function() Argomenti: nessuna Questo evento viene attivato quando il renderingType è cambiato.
tilesloaded	function() Argomenti: nessuna Questo evento viene attivato quando il caricamento dei riquadri visibili è terminato.
tilt_changed	function() Argomenti: nessuna Questo evento viene attivato quando la proprietà di inclinazione della mappa cambia.
zoom_changed	function() Argomenti: nessuna Questo evento viene attivato quando la proprietà di zoom della mappa cambia.
rightclick	Obsoleto: utilizza invece l'evento Map.contextmenu per supportare pattern di utilizzo come clic di controllo e macOS. function(event) Argomenti:  event:  MapMouseEvent 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.

Proprietà
backgroundColor optional	Tipo:  string optional Colore utilizzato per lo sfondo del div mappa. Questo colore sarà visibile quando i riquadri non sono ancora stati caricati durante la panoramica dell'utente. Questa opzione può essere impostata solo quando la mappa viene inizializzata.
center optional	Tipo:  LatLng|LatLngLiteral optional Il centro di Google Maps iniziale.
clickableIcons optional	Tipo:  boolean optional Predefinito: true Quando false, non è possibile fare clic sulle icone mappa. L'icona di una mappa rappresenta un punto di interesse, noto anche come PDI.
controlSize optional	Tipo:  number optional Dimensioni in pixel dei controlli visualizzati sulla mappa. Questo valore deve essere fornito direttamente al momento della creazione della mappa; in seguito, l'aggiornamento di questo valore potrebbe rendere i controlli undefined. Regola solo i controlli effettuati dall'API di Google Maps stessa. Non scala i controlli personalizzati creati dallo sviluppatore.
disableDefaultUI optional	Tipo:  boolean optional Attiva/disattiva tutti i pulsanti UI predefiniti. Può essere sostituita singolarmente. Non disattiva i controlli della tastiera, che sono controllati separatamente dall'opzione MapOptions.keyboardShortcuts. Non disattiva i controlli tramite gesti, che sono controllati separatamente dall'opzione MapOptions.gestureHandling.
disableDoubleClickZoom optional	Tipo:  boolean optional Attiva/disattiva lo zoom e il centro al doppio clic. Questa opzione è abilitata per impostazione predefinita. Nota: questa proprietà non è consigliata. Per disattivare lo zoom al doppio clic, puoi utilizzare la proprietà gestureHandling e impostarla su "none".
draggable optional	Obsoleto: obsoleto nel 2017. Per disattivare il trascinamento sulla mappa, puoi utilizzare la proprietà gestureHandling e impostarla su "none". Tipo:  boolean optional Se false, non è possibile trascinare la mappa. Il trascinamento è attivato per impostazione predefinita.
draggableCursor optional	Tipo:  string optional Il nome o l'URL del cursore da visualizzare quando si passa il mouse sopra 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 riserva 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 riserva 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": fai scorrere gli eventi e i gesti di tocco con un dito sulla pagina senza eseguire lo zoom o la panoramica della mappa. Esegui una panoramica e lo zoom della mappa con due dita al tocco. Scorri gli eventi con un tasto Ctrl o ⌘ premuto, per ingrandire la mappa. In questa modalità la mappa coopera con la pagina. "greedy": tutti i gesti tattili e gli eventi di scorrimento eseguono una panoramica o lo zoom della mappa. "none": non è possibile eseguire la panoramica o lo zoom della mappa tramite i gesti dell'utente. "auto": (impostazione predefinita) la gestione dei gesti è cooperativa o avida, a seconda che la pagina sia scorrevole o in un iframe.
heading optional	Tipo:  number optional L'intestazione delle immagini aeree in gradi misurata in senso orario dalla direzione cardinale verso nord. Le intestazioni vengono agganciate all'angolo più vicino disponibile per il quale 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 configurata 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. Impossibile impostare o modificare questo parametro 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 L'ID mappa mappa inizialmente. Il valore predefinito è ROADMAP.
maxZoom optional	Tipo:  number optional Il livello massimo di zoom che verrà visualizzato sulla mappa. Se omessa, o impostata su null, viene utilizzato lo zoom massimo dal tipo di mappa corrente. I valori di zoom validi sono numeri compresi tra zero e il livello di zoom massimo supportato.
minZoom optional	Tipo:  number optional Il livello di zoom minimo che verrà visualizzato sulla mappa. Se omessa, oppure impostata su null, viene utilizzato lo zoom minimo del tipo di mappa corrente. I valori di zoom validi sono numeri compresi tra zero e il 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 Pan. Nota: il controllo Pan non è disponibile nella nuova versione dei controlli introdotta nella versione 3.22 dell'API JavaScript di Google Maps. Durante l'utilizzo delle versioni 3.22 e v3.23, puoi scegliere di utilizzare l'insieme di controlli precedente anziché i nuovi controlli, rendendo così disponibile il controllo Pan come parte del vecchio set di controlli. Consulta la sezione Novità dei controlli della mappa v3.22.
panControlOptions optional	Tipo:  PanControlOptions optional Le opzioni di visualizzazione per il controllo Pan. Nota: il controllo Pan non è disponibile nella nuova versione dei controlli introdotta nella versione 3.22 dell'API JavaScript di Google Maps. Durante l'utilizzo delle versioni 3.22 e v3.23, puoi scegliere di utilizzare l'insieme di controlli precedente anziché i nuovi controlli, rendendo così disponibile il controllo Pan come parte del vecchio set di controlli. Consulta la sezione Novità dei controlli della mappa v3.22.
restriction optional	Tipo:  MapRestriction optional Definisce un confine che limita l'area della mappa accessibile agli utenti. Quando è impostato, un utente può eseguire panoramica e 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 attivato/disattivato del controllo Scala.
scaleControlOptions optional	Tipo:  ScaleControlOptions optional Le opzioni di visualizzazione iniziale per il controllo Scala.
scrollwheel optional	Tipo:  boolean optional Se false, disattiva lo zoom sulla mappa utilizzando la rotellina del mouse. La rotellina è abilitata per impostazione predefinita. Nota: questa proprietà non è consigliata. Per disattivare lo zoom utilizzando la rotellina, puoi utilizzare la proprietà gestureHandling e impostarla su "cooperative" o "none".
streetView optional	Tipo:  StreetViewPanorama optional Un StreetViewPanorama da visualizzare quando il piombo di Street View viene rilasciato sulla mappa. Se non viene specificato alcun panorama, verrà visualizzato un valore predefinito StreetViewPanorama in div quando viene eseguito l'esclusione di Maps.
streetViewControl optional	Tipo:  boolean optional Lo stato iniziale di attivazione/disattivazione del controllo Street View Pegman. Questo controllo fa parte dell'interfaccia utente predefinita e deve essere impostato su false quando viene visualizzato un tipo di mappa su cui non deve essere visualizzata la sovrapposizione sulla strada (ad es. un tipo di mappa non di Earth).
streetViewControlOptions optional	Tipo:  StreetViewControlOptions optional Le opzioni di visualizzazione iniziale per il controllo Street View Pegman.
styles optional	Tipo:  Array<MapTypeStyle> optional Stili da applicare a ogni tipo di mappa predefinito. 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 automatico del cambio 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 il livello di zoom e l'area visibile correnti e torna a 0 ogni volta che non sono disponibili immagini a 45° (questo è il comportamento predefinito). Le immagini a 45° sono disponibili solo per i tipi di mappa 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 fanno riferimento a cose diverse, non bind() la proprietà tilt; in quanto ciò potrebbe produrre effetti imprevedibili.
zoom optional	Tipo:  number optional Il livello di zoom iniziale della mappa. I valori di zoom validi sono numeri compresi tra zero e il 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.

Classe MapElement

google.maps.MapElement corso

Avviso:disponibile solo nel canale v=beta.

MapElement è una sottoclasse HTMLElement per la visualizzazione 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"></gmp-map>

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

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

Questa lezione si estende a HTMLElement.

Questo corso implementa MapElementOptions.

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

Proprietà
center	Tipo:  LatLng|LatLngLiteral optional Attributo HTML: <gmp-map center="lat,lng"></gmp-map>
innerMap	Tipo:  Map Un riferimento al Map che MapElement utilizza internamente.
mapId	Tipo:  string optional Attributo HTML: <gmp-map map-id="string"></gmp-map>
zoom	Tipo:  number optional Attributo HTML: <gmp-map zoom="number"></gmp-map>

Metodi
addEventListener	Avviso:disponibile solo nel canale v=beta. addEventListener(type, listener[, options]) Parametri:  type:  string una stringa sensibile alle maiuscole che rappresenta il tipo di evento da ascoltare. listener:  EventListener|EventListenerObject l'oggetto che riceve una notifica. Deve essere una funzione o un oggetto con il metodo handleEvent options:  boolean|AddEventListenerOptions optional consulta 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 📺
removeEventListener	Avviso:disponibile solo nel canale v=beta. removeEventListener(type, listener[, options]) Parametri:  type:  string una stringa che specifica il tipo di evento per il quale rimuovere un listener di eventi. listener:  EventListener|EventListenerObject il listener di eventi del gestore di eventi da rimuovere dal target dell'evento. options:  boolean|EventListenerOptions optional consulta le opzioni Valore restituito:  void Rimuove un listener di eventi precedentemente registrato con HSTS dal target. Vedi removeEvent listener

Interfaccia MapElementOptions

Interfaccia google.maps.MapElementOptions

Avviso:disponibile solo nel canale v=beta.

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

Proprietà
center optional	Tipo:  LatLng|LatLngLiteral optional Il centro di Google Maps iniziale.
mapId optional	Tipo:  string optional L'ID mappa della mappa. Impossibile impostare o modificare questo parametro 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 compresi tra zero e il livello di zoom massimo supportato. Valori di zoom più grandi corrispondono a una risoluzione più elevata.

Interfaccia MapTypeStyle

Interfaccia google.maps.MapTypeStyle

MapTypeStyle è una raccolta di selettori e stilisti che definiscono lo stile della mappa. I selettori specificano le funzionalità della mappa e/o gli elementi che devono essere interessati, mentre gli stilisti specificano come devono essere modificati. Per maggiori dettagli, consulta il riferimento allo stile.

Proprietà
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 il riferimento allo stile.
elementType optional	Tipo:  string optional L'elemento a cui deve essere applicato uno stile. Un elemento è un aspetto visivo di un elemento sulla mappa. Ad esempio, un'etichetta, un'icona, un tratto o un riempimento applicati alla geometria e altro ancora. Campo facoltativo. Se elementType non è specificato, si presume che il valore sia 'all'. Per informazioni dettagliate sull'utilizzo e sui valori consentiti, consulta il riferimento allo stile.
featureType optional	Tipo:  string optional La caratteristica, o il gruppo di caratteristiche, a cui deve essere applicato uno stile. Campo facoltativo. Se featureType non è specificato, si presume che il valore sia 'all'. Per informazioni dettagliate sull'utilizzo e sui valori consentiti, consulta il riferimento allo stile.

Interfaccia di MapMouseEvent

Interfaccia google.maps.MapMouseEvent

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

Proprietà
domEvent	Tipo:  MouseEvent|TouchEvent|PointerEvent|KeyboardEvent|Event L'evento DOM nativo corrispondente. Gli sviluppatori non devono fare affidamento sulle proprietà target, currentTarget, relatedTarget e path che vengono definite e coerenti. Gli sviluppatori non devono inoltre fare affidamento sulla struttura DOM dell'implementazione interna dell'API di Google Maps. A causa della mappatura degli eventi interna, il domEvent potrebbe avere una semantica diversa dal MapMouseEvent (ad esempio, un "clic" per MapMouseEvent potrebbe avere un domEvent di tipo KeyboardEvent).
latLng optional	Tipo:  LatLng optional La latitudine/longitudine che si trovava sotto il cursore quando si è verificato l'evento.

Metodi
stop	stop() Parametri: nessuna Valore restituito:  void Impedisce ulteriormente la 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 della mappa. L'ID luogo di questo luogo è memorizzato 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.

Proprietà
placeId optional	Tipo:  string optional L'ID del luogo che ha ricevuto un clic. Questo ID luogo può essere utilizzato per richiedere ulteriori informazioni sull'elemento su cui è stato fatto clic. Scopri di più sugli ID luogo nella guida per gli sviluppatori dell'API Places.
Ereditato: domEvent, latLng

Metodi
Ereditato: stop

Costanti MapTypeId

google.maps.MapTypeId costanti

Identificatori per i MapMap comuni. Specificali in base al 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.

Costanti
HYBRID	Questo tipo di mappa mostra un livello trasparente di strade principali sulle 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 elementi fisici come il rilievo e la vegetazione.

Classe MapTypeRegistry

google.maps.MapTypeRegistry corso

Un registro di istanze MapType, con chiave mediante ID MapType.

Questa lezione si estende a MVCObject.

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

Costruttore
MapTypeRegistry	MapTypeRegistry() Parametri: nessuna MapTypeRegistry contiene la raccolta di tipi di mappe personalizzate disponibili per la mappa per il suo utilizzo. L'API consulta, ad esempio, questo registro quando fornisce l'elenco dei tipi di mappa disponibili all'interno dei controlli.

Metodi
set	set(id, mapType) Parametri:  id:  string identificatore del MapType da aggiungere al registro. mapType:  MapType|* oggetto MapType da aggiungere al registro. Valore restituito: nessuno Imposta il Registro di sistema per associare l'identificatore di stringa passato al MapType passato.
Ereditato: addListener, bindTo, get, notify, setValues, unbind, unbindAll

Interfaccia MapRestriction

Interfaccia google.maps.MapRestriction

Una restrizione che può essere applicata alla mappa. L'area visibile della mappa non supererà queste limitazioni.

Proprietà
latLngBounds	Tipo:  LatLngBounds|LatLngBoundsLiteral Quando è impostato, un 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 la sola latitudine. Per i limiti di sola latitudine, utilizza rispettivamente la longitudine ovest e est di -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. In questo modo è possibile ridurre lo zoom al di là dell'utente, mantenendo tutto nascosto al di fuori dei limiti. L'impostazione predefinita è false, il che significa che un utente può diminuire lo zoom finché non viene visualizzata l'intera area delimitata, incluse le aree esterne all'area delimitata.

Classe Traffic Layer

google.maps.TrafficLayer corso

Un livello di traffico.

Questa lezione si estende a MVCObject.

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

Costruttore
TrafficLayer	TrafficLayer([opts]) Parametri:  opts:  TrafficLayerOptions optional Un livello che mostra il traffico stradale attuale.

Metodi
getMap	getMap() Parametri: nessuna Valore restituito:  Map Restituisce la mappa su cui viene visualizzato questo livello.
setMap	setMap(map) Parametri:  map:  Map Valore restituito: nessuno Visualizza il livello sulla mappa specificata. Se la mappa è impostata su null, il livello verrà rimosso.
setOptions	setOptions(options) Parametri:  options:  TrafficLayerOptions Valore restituito: nessuno
Ereditato: 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 dataLayer.

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

Classe Transitlayer

google.maps.TransitLayer corso

Un livello di trasporto pubblico.

Questa lezione si estende a MVCObject.

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

Costruttore
TransitLayer	TransitLayer() Parametri: nessuna Un livello che mostra le linee di trasporto pubblico.

Metodi
getMap	getMap() Parametri: nessuna Valore restituito:  Map Restituisce la mappa su cui viene visualizzato questo livello.
setMap	setMap(map) Parametri:  map:  Map Valore restituito: nessuno Visualizza il livello sulla mappa specificata. Se la mappa è impostata su null, il livello verrà rimosso.
Ereditato: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

lezione Bicyclinglayer

google.maps.BicyclingLayer corso

Un livello che mostra le piste ciclabili e i percorsi.

Questa lezione si estende a MVCObject.

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

Costruttore
BicyclingLayer	BicyclingLayer() Parametri: nessuna Un livello che mostra piste ciclabili e percorsi e retrocede strade di grandi dimensioni.

Metodi
getMap	getMap() Parametri: nessuna Valore restituito:  Map Restituisce la mappa su cui viene visualizzato questo livello.
setMap	setMap(map) Parametri:  map:  Map Valore restituito: nessuno Visualizza il livello sulla mappa specificata. Se la mappa è impostata su null, il livello verrà rimosso.
Ereditato: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

Interfaccia VideocameraOptions

Interfaccia google.maps.CameraOptions

Avviso:disponibile solo nel canale v=beta.

Utilizzato per impostare le opzioni della fotocamera della mappa.

Proprietà
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 l'area visibile della mappa. Su una mappa vettoriale questo poligono può essere un trapezio anziché un rettangolo, quando una mappa vettoriale ha un'inclinazione.

Proprietà
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 di RenderingType

google.maps.RenderingType costanti

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

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

Interfaccia MapCapbility

Interfaccia google.maps.MapCapabilities

Oggetto contenente un'istantanea delle funzionalità attualmente disponibili per la mappa. Tieni presente che ciò non significa necessariamente che i moduli pertinenti siano caricati o inizializzati, ma piuttosto che la mappa corrente è autorizzata a utilizzare queste API. Consulta le proprietà per un elenco di possibili funzionalità.

Proprietà
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 true, questa mappa è configurata correttamente per consentire l'uso di stili basati sui dati per almeno un Feature Layer. Per ulteriori informazioni, visita le pagine https://goo.gle/gmp-data-drive-styling e https://goo.gle/gmp-Feature LayerIsAvailable.