Maps

lezione Map

lezione google.maps.Map

Questo corso estende MVCObject.

Quando usi v=beta, puoi accedervi chiamando const {Map} = await google.map.importLibrary("maps"). Consulta la sezione Librerie nell'API Maps JavaScript.

Map
Map(mapDiv[, opts])
Parametri:
  • mapDiv: HTMLElement verrà visualizzato la mappa per riempire questo elemento.
  • opts:  opzioni MapOptions optional
Crea una nuova mappa all'interno del contenitore HTML specificato, che di solito è un elemento DIV.
controls
Controlli aggiuntivi da allegare alla mappa. Per aggiungere un controllo alla mappa, aggiungi <div> a MVCArray corrispondente al 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 mostrarli comodamente su questa mappa.
mapTypes
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 di overlay verranno visualizzati sopra la mappa di base alla quale sono collegati, nell'ordine in cui sono visualizzati nell'array di overlayMapTypes (gli overlay con valori di indice più elevati vengono visualizzati davanti agli overlay con valori di indice più bassi).
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 la rimozione della spaziatura interna. Un valore numerico restituirà la stessa spaziatura su tutti e 4 i lati. Fornisci 0 qui per rendere un'opzione fitBounds idempotente sul risultato di getBounds.
Valore di restituzione: nessuno
Consente di impostare l'area visibile per contenere 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 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 visualizzare un'animazione fluida mentre la mappa esegue la panoramica e lo zoom in base ai bordi. La possibilità di animare questo metodo dipende da un'euristica interna.
getBounds
getBounds()
Parametri: nessuno
Valore restituito: LatLngBounds|undefined I limiti di latitudine/longitudine dell'area visibile corrente.
Restituisce i limiti di latitudine/longitudine dell'area visibile corrente. Se è visibile più di una copia del mondo, i limiti variano in longitudine da -180 a 180 gradi inclusi. Se la mappa non è ancora stata inizializzata o al centro e lo zoom non è stato impostato, il risultato è undefined. Per le mappe vettoriali con inclinazione o intestazione diversa da zero, i limiti di latitudine/longitudine restituiti rappresentano i riquadri di delimitazione più piccoli che includono l'area visibile della mappa. Visualizza MapCanvasProjection.getVisibleRegion per conoscere la regione esatta visibile dell'area visibile della mappa.
getCenter
getCenter()
Parametri: nessuno
Valore restituito: LatLng|undefined
Restituisce la posizione mostrata al centro della mappa. Tieni presente che questo oggetto LatLng non viene aggregato. Leggi i LatLng per avere ulteriori informazioni. 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 mappa. L'icona mappa rappresenta un punto d'interesse, noto anche come PDI. Se il valore restituito è true, le icone sono selezionabili sulla mappa.
getDiv
getDiv()
Parametri: nessuno
Valore restituito: HTMLElement il mappaDiv della mappa.
BetagetFeatureLayer
getFeatureLayer(featureType)
Parametri:
Valore restituito: FeatureLayer
Restituisce il FeatureLayer della FeatureType specifica. È necessario attivare un FeatureLayer in Google Cloud Console. Se FeatureLayer in FeatureType non esiste su questa mappa o se lo stile basato sui dati non è disponibile (nessun ID mappa, nessun riquadro vettoriale e nessun FeatureLayer attivato nello stile mappa), viene registrato un errore e il risultato FeatureLayer.isAvailable sarà false.
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 verso nord. Se la mappa non è ancora stata inizializzata, il risultato è undefined.
BetagetMapCapabilities
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 la proprietà Projection corrente. 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: nessuno
Valore restituito: RenderingType
Restituisce l'attuale RenderingType della mappa.
getStreetView
getStreetView()
Parametri: nessuno
Valore restituito: StreetViewPanorama il panorama associato alla mappa.
Restituisce il StreetViewPanorama predefinito associato alla mappa, che può essere un panorama predefinito incorporato all'interno della mappa o il panorama impostato utilizzando setStreetView(). Le modifiche al streetViewControl della mappa verranno riportate nella visualizzazione di questo panorama limitato.
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 dettagli, 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 di restituzione: nessuno
Imposta subito la fotocamera della mappa sulle opzioni della fotocamera target, senza animazione.
panBy
panBy(x, y)
Parametri:
  • x: number numero di pixel per spostare la mappa nella direzione x.
  • ynumber numero di pixel per spostare la mappa nella direzione y.
Valore di restituzione: nessuno
Modifica il centro della mappa in base alla distanza specificata in pixel. Se la distanza è inferiore sia alla larghezza sia all'altezza della mappa, la transizione verrà eseguita 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:
Valore di restituzione: nessuno
Modifica il centro della mappa con il LatLng specificato. Se la modifica è inferiore sia alla larghezza che all'altezza della mappa, la transizione verrà eseguita senza problemi.
panToBounds
panToBounds(latLngBounds[, padding])
Parametri:
  • latLngBounds: LatLngBounds|LatLngBoundsLiteral i limiti di esplorazione della mappa.
  • paddingnumber|Padding optional Spaziatura interna in pixel. Un valore numerico restituirà la stessa spaziatura su tutti e 4 i lati. Il valore predefinito è 0.
Valore di restituzione: nessuno
Esplora la mappa in base alla quantità minima necessaria per contenere il LatLngBounds specificato. Ciò non garantisce se sulla mappa saranno presenti i confini, tranne per il fatto che verrà eseguita la panoramica automatica della mappa per mostrare il maggior numero possibile di limiti all'interno di {currentMapSizeInPx} - {padding}. Sia per le mappe raster sia per quelle vettoriali, lo zoom, l'inclinazione e l'intestazione della mappa non vengono modificati.
setCenter
setCenter(latlng)
Parametri:
Valore di restituzione: nessuno
setClickableIcons
setClickableIcons(value)
Parametri:
  • valueboolean
Valore di restituzione: nessuno
Controlla se le icone mappa sono cliccabili o meno. L'icona mappa rappresenta un punto d'interesse, noto anche come PDI. Per disattivare la cliccabilità delle icone mappa, passa un valore di false a questo metodo.
setHeading
setHeading(heading)
Parametri:
  • headingnumber
Valore di restituzione: nessuno
Imposta l'intestazione della bussola per la mappa misurata in gradi dalla direzione cardinale verso nord. Per le mappe raster, questo metodo si applica solo alle immagini aeree.
setMapTypeId
setMapTypeId(mapTypeId)
Parametri:
Valore di restituzione: nessuno
setOptions
setOptions(options)
Parametri:
Valore di restituzione: nessuno
setStreetView
setStreetView(panorama)
Parametri:
Valore di restituzione: nessuno
Consente di associare un elemento StreetViewPanorama alla mappa. Questo panorama sostituisce il valore predefinito StreetViewPanorama, consentendo alla mappa di associarsi a un panorama esterno al di fuori della mappa. Se imposti la panoramica su null, la panoramica incorporata predefinita viene di nuovo mappata alla mappa.
setTilt
setTilt(tilt)
Parametri:
  • tilt: number
Valore di restituzione: 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 in modo che la mappa utilizzi sempre una visualizzazione dall'alto di 0°, indipendentemente dal livello di zoom e dall'area visibile. setTilt(45) causa il passaggio automatico dell'angolo di inclinazione a 45 ogni volta che sono disponibili immagini di 45° per il livello di zoom e l'area visibile correnti, e torna a 0 ogni volta che le immagini a 45° non sono disponibili (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; poiché ciò potrebbe produrre effetti imprevedibili.
setZoom
setZoom(zoom)
Parametri:
  • zoom: number valori di zoom più grandi corrispondono a una risoluzione più elevata.
Valore di restituzione: nessuno
Consente di impostare lo zoom della mappa.
Ereditata: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
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 la configurazione cloud (come Cloud Styling).
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à Maps Center cambia.
click
function(event)
Argomenti:
Questo evento viene attivato quando l'utente fa clic sulla mappa. Viene restituito un MapMouseEvent con proprietà per la sede selezionata, a meno che non venga fatto clic sull'icona di un luogo, nel qual caso viene restituito un IconaMouseEvent 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 del luogo non è importante. L'evento di clic non viene attivato se viene fatto clic su un indicatore o su una finestra informativa.
contextmenu
function(event)
Argomenti:
Questo evento viene attivato quando l'evento DOM contestualimenu viene attivato nel contenitore mappa.
dblclick
function(event)
Argomenti:
Questo evento viene attivato quando l'utente fa doppio clic sulla mappa. Tieni presente che anche l'evento di clic si attiva 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 è cambiata.
Betamapcapabilities_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 è cambiata.
renderingtype_changed
function()
Argomenti: nessuno
Questo evento viene attivato quando viene modificato il renderingType.
tilesloaded
function()
Argomenti: nessuno
Questo evento viene attivato quando i riquadri visibili sono terminati.
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à 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 di MapOptions

google.maps.MapOptions interfaccia

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 mappa. Questo colore sarà visibile quando i riquadri non sono stati ancora caricati durante la panoramica dell'utente. Questa opzione può essere impostata soltanto quando la mappa viene inizializzata.
center optional
Tipo: LatLng|LatLngLiteral optional
Il centro mappa iniziale.
clickableIcons optional
Tipo: boolean optional
Predefinito: true
Quando false, non è possibile fare clic sulle icone mappa. L'icona mappa rappresenta un punto d'interesse, noto anche come PDI.
controlSize optional
Tipo: number optional
Le dimensioni in pixel dei controlli che vengono visualizzati sulla mappa. Questo valore deve essere fornito direttamente in fase di creazione della mappa. Aggiornando questo valore in un secondo momento, i controlli potrebbero avere lo stato 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. Possono essere sostituiti singolarmente. Non disattiva i controlli da 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 la centratura 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
Tipo: boolean optional
Se false, la mappa non viene trascinata. Il trascinamento è attivo 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 di attivazione/disattivazione del controllo a schermo intero.
fullscreenControlOptions optional
Le opzioni di visualizzazione per il controllo Schermo intero.
gestureHandling optional
Tipo: string optional
Questa impostazione controlla il modo in cui l'API gestisce i gesti sulla mappa. Valori consentiti:
  • "cooperative": scorri gli eventi e i gesti di tocco con un dito nella pagina e non eseguire lo zoom o la panoramica della mappa. Con i gesti di due dita, esegui una panoramica e lo zoom della mappa. Scorri gli eventi con un tasto Ctrl o ⌘ premuto per eseguire lo zoom sulla mappa.
    In questa modalità la mappa collabora con la pagina.
  • "greedy": tutti i gesti di tocco e gli eventi di scorrimento consentono di eseguire una panoramica o lo zoom sulla mappa.
  • "none": la mappa non può essere panoramica o ingrandita tramite gesti dell'utente.
  • "auto" (impostazione predefinita): la gestione dei gesti è cooperativa o golosa, a seconda che sia possibile scorrere la pagina o in un iframe.
heading optional
Tipo: number optional
La direzione delle immagini aeree in gradi misurata in senso orario dalla direzione cardinale verso nord. Le intestazioni vengono agganciate all'angolo più vicino 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 hai impostato i valori predefiniti.
keyboardShortcuts optional
Tipo: boolean optional
Se false, la tastiera non viene controllata dalla tastiera. Le scorciatoie da tastiera sono attivate 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 iniziale. Il valore predefinito è ROADMAP.
maxZoom optional
Tipo: number optional
Il livello massimo di zoom 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 minimo di zoom 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 mappa.
panControl optional
Tipo: boolean optional
Lo stato di attivazione/disattivazione del controllo Pan.

Nota: il controllo Pan non è disponibile nel nuovo set di controlli introdotto nella versione 3.22 dell'API JavaScript di Google Maps. Durante l'uso delle versioni 3.22 e v3.23, puoi scegliere di utilizzare l'insieme di controlli precedente anziché i nuovi controlli, rendendo così disponibile l'insieme di controlli nel vecchio insieme. 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 nel nuovo set di controlli introdotto nella versione 3.22 dell'API JavaScript di Google Maps. Durante l'uso delle versioni 3.22 e v3.23, puoi scegliere di utilizzare l'insieme di controlli precedente anziché i nuovi controlli, rendendo così disponibile l'insieme di controlli nel vecchio insieme. 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. Se impostato, l'utente può eseguire panoramica e zoom solo se la visualizzazione della videocamera rimane entro i limiti.
rotateControl optional
Tipo: boolean optional
Lo stato di attivazione/disattivazione del controllo di rotazione.
rotateControlOptions optional
Tipo: RotateControlOptions optional
Le opzioni di visualizzazione del controllo Ruota.
scaleControl optional
Tipo: boolean optional
Lo stato iniziale attivato/disattivato del controllo Scala.
scaleControlOptions optional
Tipo: ScaleControlOptions optional
Le opzioni di visualizzazione iniziali per il controllo Scala.
scrollwheel optional
Tipo: boolean optional
Se false, disattiva lo zoom sulla mappa utilizzando una rotellina del mouse. La rotellina di scorrimento è abilitata per impostazione predefinita.

Nota: questa proprietà non è consigliata. Per disattivare lo zoom con la rotella di scorrimento, puoi utilizzare la proprietà gestureHandling e impostarla su "cooperative" o "none".

streetView optional
Tipo: StreetViewPanorama optional
Un StreetViewPanorama da visualizzare quando il piccante di Street View viene rilasciato sulla mappa. Se non viene specificato alcun panorama, verrà visualizzato un StreetViewPanorama predefinito in div della mappa quando Pegman viene rilasciato.
streetViewControl optional
Tipo: boolean optional
Lo stato iniziale attivato/disattivato del controllo di 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 l'overlay stradale di Street View non deve essere visualizzato (ad es. un tipo di mappa non Earth).
streetViewControlOptions optional
Le opzioni di visualizzazione iniziali per il controllo Street View Hadoop.
styles optional
Tipo: Array<MapTypeStyle> optional
Stili da applicare a ciascun tipo di mappa predefinito. Tieni presente che per le modalità satellite/hybrid e terrain, questi stili verranno applicati solo alle etichette e alla geometrica.
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 la visualizzazione correnti. Inoltre, torna a 0 per tutte le immagini a 45° non disponibili (è 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; poiché 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 maggiori corrispondono a una risoluzione maggiore.
zoomControl optional
Tipo: boolean optional
Lo stato di attivazione/disattivazione del controllo Zoom.
zoomControlOptions optional
Tipo: ZoomControlOptions optional
Le opzioni di visualizzazione per il controllo Zoom.

Interfaccia MapTypeStyle

google.maps.MapTypeStyle interfaccia

MapTypeStyle è una raccolta di selettori e stilisti che definiscono lo stile della mappa. I selettori specificano gli elementi e/o gli elementi della mappa interessati e gli stilisti specificano in che modo tali elementi e/o elementi devono essere modificati. Per maggiori dettagli, consulta la documentazione di riferimento per lo stile.

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 sullo stile.
elementType optional
Tipo: string optional
L'elemento a cui applicare uno stile di stile. Un elemento è un aspetto visivo di un elemento sulla mappa. Ad esempio, un'etichetta, un'icona, un tratto o riempimento applicato alla geometria e altro ancora. (Facoltativo) Se elementType non è specificato, si presume che il valore sia 'all'. Per informazioni dettagliate sull'utilizzo e sui valori consentiti, consulta la documentazione di riferimento per lo stile.
featureType optional
Tipo: string optional
La funzionalità o il gruppo di funzionalità a cui applicare uno stile di stile. (Facoltativo) Se featureType non è specificato, si presume che il valore sia 'all'. Per informazioni dettagliate sull'utilizzo e sui valori consentiti, consulta la documentazione di riferimento per lo stile.

Interfaccia di MapMouseEvent

google.maps.MapMouseEvent interfaccia

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

domEvent
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 interna degli eventi, domEvent potrebbe avere una semantica diversa da MapMouseEvent (ad esempio, un "clic" di 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.
stop
stop()
Parametri: nessuno
Valore restituito: void
Impedisce la propagazione ulteriore di questo evento.

Interfaccia IconMouseEvent

google.maps.IconMouseEvent interfaccia

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() per 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 sul quale è stato fatto clic. Questo ID luogo può essere utilizzato per richiedere maggiori informazioni sull'elemento su cui è stato fatto clic.

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

Ereditata: domEvent, latLng
Ereditata: stop

Costanti MapTypeId

google.maps.MapTypeId costanti

Identificatori per i tipi di mappa comuni. Specificale in base al valore o utilizzando il nome della costante. Ad esempio, 'satellite' o google.maps.MapTypeId.SATELLITE.

Quando usi v=beta, puoi accedervi chiamando const {MapTypeId} = await google.map.importLibrary("maps"). Consulta la sezione Librerie nell'API Maps JavaScript.

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 caratteristiche fisiche come rilievo e vegetazione.

Classe MapTypeRegistry

lezione google.maps.MapTypeRegistry

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

Questo corso estende MVCObject.

Quando usi v=beta, puoi accedervi chiamando const {MapTypeRegistry} = await google.map.importLibrary("maps"). Consulta la sezione Librerie nell'API Maps JavaScript.

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

Interfaccia di MapRestriction

google.maps.MapRestriction interfaccia

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

latLngBounds
Se impostato, l'utente può eseguire solo la panoramica e lo zoom entro i limiti specificati. I limiti possono limitare sia la longitudine sia la latitudine oppure solo la latitudine. Per i limiti di sola latitudine, utilizza le lunghezze ovest e est, rispettivamente di -180 e 180, ad esempio latLngBounds: {north: northLat, south: southLat, west: -180, east: 180}.
strictBounds optional
Tipo: boolean optional
I limiti possono essere più restrittivi impostando il flag strictBounds su true. Questo riduce la distanza per cui un utente può diminuire lo zoom, mantenendo tutto nascosto al di fuori dei limiti. L'impostazione predefinita è false, ossia un utente può diminuire lo zoom fino a quando non viene visualizzata l'intera area delimitata, includendo potenzialmente quelle esterne all'area delimitata.

Classe TrafficLayer

lezione google.maps.TrafficLayer

Un livello di traffico.

Questo corso estende MVCObject.

Quando usi v=beta, puoi accedervi chiamando const {TrafficLayer} = await google.map.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 viene visualizzato questo livello.
setMap
setMap(map)
Parametri:
Valore di restituzione: nessuno
Visualizza il livello sulla mappa specificata. Se la mappa è impostata su null, il livello verrà rimosso.
setOptions
setOptions(options)
Parametri:
Valore di restituzione: nessuno
Ereditata: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

Interfaccia TrafficLayerOptions

google.maps.TrafficLayerOptions interfaccia

Oggetto TrafficLayerOptions utilizzato per definire le proprietà che possono essere impostate su un livello del traffico.

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.

lezione TransitLayer

lezione google.maps.TransitLayer

Un livello di trasporto pubblico.

Questo corso estende MVCObject.

Quando usi v=beta, puoi accedervi chiamando const {TransitLayer} = await google.map.importLibrary("maps"). Consulta la sezione Librerie nell'API Maps JavaScript.

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

lezione BicyclingLayer

lezione google.maps.BicyclingLayer

Un livello che mostra piste ciclabili e percorsi.

Questo corso estende MVCObject.

Quando usi v=beta, puoi accedervi chiamando const {BicyclingLayer} = await google.map.importLibrary("maps"). Consulta la sezione Librerie nell'API Maps JavaScript.

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

Interfaccia di cameraOptions

google.maps.CameraOptions interfaccia

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

google.maps.VisibleRegion interfaccia

Contiene i quattro punti che definiscono il poligono su quattro lati della 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
Il riquadro di delimitazione più piccolo che include l'area visibile.
nearLeft
Tipo: LatLng
nearRight
Tipo: LatLng

Costanti di RenderingType

google.maps.RenderingType costanti

Quando usi v=beta, puoi accedervi chiamando const {RenderingType} = await google.map.importLibrary("maps"). Consulta la sezione Librerie nell'API Maps JavaScript.

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

Interfaccia di MapCapabilities

google.maps.MapCapabilities interfaccia

Oggetto contenente un'istantanea delle funzionalità attualmente disponibili per la mappa. Consulta le proprietà per un elenco di possibili funzionalità.

isAdvancedMarkersAvailable optional
Tipo: boolean optional
isDataDrivenStylingAvailable optional
Tipo: boolean optional