Classe mappa
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.
Costruttore | |
---|---|
Map |
Map(mapDiv[, opts]) Parametri:
Crea una nuova mappa all'interno del contenitore HTML specificato, che in genere è un elemento DIV . |
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 la configurazione nel cloud (ad esempio Cloud Styling). |
Proprietà | |
---|---|
controls |
Tipo:
Array<MVCArray<HTMLElement>> Controlli aggiuntivi da allegare 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 |
Tipo:
MapTypeRegistry Un registro di MapType istanze per ID stringa. |
overlayMapTypes |
Tipi di mappe aggiuntivi da sovrapporre. I tipi di mappe overlay vengono visualizzati sopra la 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). |
Metodi | |
---|---|
fitBounds |
fitBounds(bounds[, padding]) Parametri:
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 modificare l'area visibile quando la mappa è nascosta, imposta la mappa su visibility: hidden , assicurandoti così che il div della mappa abbia le dimensioni effettive. Per le mappe vettoriali, questo metodo imposta l'inclinazione e l'orientamento della mappa sui valori predefiniti pari a zero. Chiamare questo metodo può causare un'animazione fluida mentre la mappa esegue la panoramica e lo zoom per adattarsi ai margini. L'animazione del metodo dipende da un'euristica interna. |
getBounds |
getBounds() Parametri: nessuno
Valore restituito:
LatLngBounds|undefined i limiti latitudine/lng dell'area visibile corrente.Restituisce i limiti latitudine/longitudine dell'area visibile corrente. Se è visibile più di una copia del mondo, i limiti di longitudine sono compresi tra -180 e 180 gradi inclusi. Se la mappa non è ancora stata inizializzata o non è al centro e non è stato impostato lo zoom, il risultato è undefined . Per le mappe vettoriali con un'inclinazione o un'intestazione diversi 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 |
getClickableIcons |
getClickableIcons() Parametri: nessuno
Valore restituito:
boolean|undefined Restituisce la cliccabilità delle icone della mappa. Un'icona della mappa rappresenta un punto d'interesse, chiamato anche PDI. Se il valore restituito è true , significa che è possibile fare clic sulle icone sulla mappa. |
getDatasetFeatureLayer |
getDatasetFeatureLayer(datasetId) Parametri:
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 di mappa della mappa o se non sono disponibili stili basati sui dati (nessun ID mappa, nessun riquadro vettoriale, nessun livello degli elementi con gli stili basati sui dati o set di dati configurati nello stile di mappa), viene registrato un errore e il valore FeatureLayer.isAvailable risultante sarà false. |
getDiv |
getDiv() Parametri: nessuno
Valore restituito:
HTMLElement il mapDiv della mappa. |
getFeatureLayer |
getFeatureLayer(featureType) Parametri:
Valore restituito:
FeatureLayer Restituisce il valore FeatureLayer dello specifico FeatureType . È necessario abilitare un FeatureLayer nella console Google Cloud. Se un FeatureLayer del FeatureType specificato non esiste su questa mappa o se gli stili basati sui dati non sono disponibili (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à 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) a partire dalla direzione cardinale nord. Se la mappa non è stata ancora inizializzata, il risultato è undefined . |
getHeadingInteractionEnabled |
getHeadingInteractionEnabled() Parametri: nessuno
Valore restituito:
boolean|null Indica se le interazioni con le intestazioni sono attivate. Questa opzione ha effetto solo quando la mappa è una mappa vettoriale. Se non viene impostato nel codice, verrà utilizzata la configurazione cloud per l'ID mappa (se disponibile). |
getMapCapabilities |
getMapCapabilities() Parametri: nessuno
Valore restituito:
MapCapabilities Comunica al chiamante le 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 il valore Projection corrente. 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 tipo di rendering corrente della mappa. |
getStreetView |
getStreetView() Parametri: nessuno
Valore restituito:
StreetViewPanorama la panoramica associata alla mappa.Restituisce il valore StreetViewPanorama predefinito associato alla mappa, che può essere un panorama predefinito incorporato all'interno della mappa o il panorama impostato utilizzando setStreetView() . Le modifiche apportate ai streetViewControl della mappa verranno applicate alla visualizzazione del panorama associato. |
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 immagini scattate direttamente dall'alto o 45 per immagini a 45°. Questo metodo non restituisce il valore impostato da setTilt . Per informazioni dettagliate, visita la pagina setTilt . |
getTiltInteractionEnabled |
getTiltInteractionEnabled() Parametri: nessuno
Valore restituito:
boolean|null Indica se le interazioni di inclinazione sono attivate. Questa opzione ha effetto solo quando la mappa è una mappa vettoriale. Se non viene impostato nel codice, verrà utilizzata la configurazione cloud per l'ID mappa (se disponibile). |
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
Imposta immediatamente la fotocamera della mappa sulle opzioni fotocamera target, senza animazione. |
panBy |
panBy(x, y) Parametri:
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. Nota che il sistema di coordinate sulla mappa aumenta da ovest a est (per i valori x) e da nord a sud (per i valori y). |
panTo |
panTo(latLng) Parametri:
Valore restituito: nessuno
Modifica il centro della mappa nell'elemento LatLng specificato. Se la modifica è inferiore all'altezza e alla larghezza della mappa, l'animazione della transizione sarà uniforme. |
panToBounds |
panToBounds(latLngBounds[, padding]) Parametri:
Valore restituito: nessuno
Esegue la panoramica della mappa in base alla quantità minima necessaria per contenere il valore LatLngBounds specificato. Non offre alcuna garanzia su dove saranno i limiti sulla mappa, ad eccezione del fatto che verrà eseguita una panoramica della mappa per mostrare il maggior numero possibile di limiti all'interno di {currentMapSizeInPx} - {padding} . Per le mappe raster e vettoriali, lo zoom, l'inclinazione e l'orientamento della mappa non subiranno modifiche. |
setCenter |
setCenter(latlng) Parametri:
Valore restituito: nessuno
|
setClickableIcons |
setClickableIcons(value) Parametri:
Valore restituito: nessuno
Consente di stabilire se è possibile fare clic sulle icone mappa o meno. Un'icona della 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:
Valore restituito: nessuno
Consente di impostare l'orientamento 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. |
setHeadingInteractionEnabled |
setHeadingInteractionEnabled(headingInteractionEnabled) Parametri:
Valore restituito: nessuno
Consente di impostare se le interazioni con le intestazioni sono abilitate. Questa opzione ha effetto solo quando la mappa è una mappa vettoriale. Se non viene impostato nel codice, verrà utilizzata la configurazione cloud per l'ID mappa (se disponibile). |
setMapTypeId |
setMapTypeId(mapTypeId) Parametri:
Valore restituito: nessuno
|
setOptions |
setOptions(options) Parametri:
Valore restituito: nessuno
|
setRenderingType |
setRenderingType(renderingType) Parametri:
Valore restituito: nessuno
Imposta il tipo di rendering corrente della mappa. |
setStreetView |
setStreetView(panorama) Parametri:
Valore restituito: nessuno
Associa StreetViewPanorama alla mappa. Questo panorama sostituisce il valore predefinito StreetViewPanorama , consentendo l'associazione della mappa a un panorama esterno al di fuori della mappa. Se imposti il panorama su null , il panorama incorporato predefinito ricollega alla mappa. |
setTilt |
setTilt(tilt) Parametri:
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, questa opzione controlla il comportamento di passaggio automatico relativo all'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 le immagini a 45° sono disponibili per l'area visibile e il livello di zoom correnti e torna a 0 quando le immagini a 45° non sono disponibili (comportamento predefinito). Le immagini a 45° sono disponibili solo per i tipi di mappe satellite e hybrid , 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 ; ciò potrebbe produrre effetti imprevedibili. |
setTiltInteractionEnabled |
setTiltInteractionEnabled(tiltInteractionEnabled) Parametri:
Valore restituito: nessuno
Consente di impostare se le interazioni di inclinazione sono attivate. Questa opzione ha effetto solo quando la mappa è una mappa vettoriale. Se non viene impostato nel codice, verrà utilizzata la configurazione cloud per l'ID mappa (se disponibile). |
setZoom |
setZoom(zoom) Parametri:
Valore restituito: nessuno
Imposta lo zoom della mappa. |
Ereditate:
addListener ,
bindTo ,
get ,
notify ,
set ,
setValues ,
unbind ,
unbindAll
|
Eventi | |
---|---|
bounds_changed |
function() Argomenti: nessuno
Questo evento viene attivato quando i limiti dell'area visibile vengono modificati. |
center_changed |
function() Argomenti: nessuno
Questo evento viene attivato quando la proprietà del centro mappa cambia. |
click |
function(event) Argomenti:
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 sia stato fatto clic su un'icona luogo, nel qual caso viene restituito un IconMouseEvent con un ID luogo. IconMouseEvent e MapMouseEvent sono identici, ad eccezione del fatto che IconMouseEvent ha il campo Place ID. 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 ha fatto clic su un indicatore o su una finestra informativa. |
contextmenu |
function(event) Argomenti:
Questo evento viene attivato quando l'evento del menu di contesto DOM viene attivato nel contenitore della mappa. |
dblclick |
function(event) Argomenti:
Questo evento viene attivato quando l'utente fa doppio clic sulla mappa. Tieni presente che l'evento di clic a volte si attiva una volta e a volte 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à di 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 il valore di renderingType viene modificato. |
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 viene modificata. |
|
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.
Proprietà | |
---|---|
backgroundColor optional |
Tipo:
string optional Colore utilizzato per lo sfondo del div della mappa. Questo colore sarà visibile quando i riquadri non saranno ancora stati caricati durante la panoramica dell'utente. 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 Predefinita:
true Quando false , non è possibile fare clic sulle icone mappa. Un'icona della 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 specificato direttamente durante la creazione della mappa. Se lo aggiorni in un secondo momento, i controlli potrebbero passare allo 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 dell'interfaccia utente predefiniti. L'override può essere eseguito 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 usare la proprietà |
|
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 quando passi il 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 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 il modo in cui l'API gestisce i gesti sulla mappa. Valori consentiti:
|
heading optional |
Tipo:
number optional L'intestazione delle immagini aeree in gradi, misurata in senso orario a partire dalla direzione cardinale nord. Le intestazioni vengono agganciate all'angolazione più vicina disponibile per la quale sono disponibili le immagini. |
headingInteractionEnabled optional |
Tipo:
boolean optional Predefinita:
false Indica se la mappa deve consentire all'utente di controllare l'orientamento (rotazione) della fotocamera. Questa opzione ha effetto solo quando la mappa è una mappa vettoriale. Se non viene impostato nel codice, verrà utilizzata la configurazione cloud per l'ID mappa (se disponibile). |
isFractionalZoomEnabled optional |
Tipo:
boolean optional Predefinito:
true per le mappe vettoriali e false per le mappe rasterSe 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 il controllo della mappa tramite 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. Map.DEMO_MAP_ID può essere utilizzato per provare funzionalità che richiedono un ID mappa, ma che non richiedono l'abilitazione del cloud. |
mapTypeControl optional |
Tipo:
boolean optional Lo stato iniziale attivato/disattivato del controllo del 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 il valore è true , non cancellare i contenuti del div Mappa. |
|
Tipo:
boolean optional Lo stato attivato/disattivato del controllo Pan. |
|
Tipo:
PanControlOptions optional Le opzioni di visualizzazione per il controllo Panoramica. |
renderingType optional |
Tipo:
RenderingType optional Predefinita:
RenderingType.RASTER Indica se la mappa deve essere una mappa raster o vettoriale. Questo parametro non può essere impostato o modificato dopo aver creato un'istanza di una mappa. Se non viene impostato, il tipo di rendering (se disponibile) verrà determinato dalla configurazione cloud per l'ID mappa. Tieni presente che le mappe vettoriali potrebbero non essere disponibili per tutti i dispositivi e i browser e, se necessario, la mappa utilizzerà una mappa raster. |
restriction optional |
Tipo:
MapRestriction optional Definisce un confine che limita l'area della mappa accessibile agli utenti. Se questa opzione è impostata, l'utente può eseguire la panoramica e lo zoom solo se la visualizzazione della videocamera rimane all'interno dei limiti. |
rotateControl optional |
Tipo:
boolean optional Lo stato attivato/disattivato del controllo di rotazione. |
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 della bilancia. |
scaleControlOptions optional |
Tipo:
ScaleControlOptions optional Le opzioni di visualizzazione iniziali per il controllo Bilancia. |
scrollwheel optional |
Tipo:
boolean optional Se false , disattiva lo zoom sulla mappa utilizzando la rotellina del mouse. La rotellina di scorrimento è attiva per impostazione predefinita. Nota: questa proprietà non è consigliata. Per disattivare lo zoom usando la rotellina di scorrimento, puoi usare la proprietà |
streetView optional |
Tipo:
StreetViewPanorama optional Un StreetViewPanorama da visualizzare quando il pegman di Street View viene rilasciato sulla mappa. Se non viene specificato alcun panorama, nel div della mappa viene visualizzato un valore predefinito StreetViewPanorama 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 ognuno dei tipi di mappa predefiniti. Tieni presente che per le modalità satellite /hybrid e terrain , questi stili si applicheranno solo a etichette e geometria. Questa funzionalità non è disponibile quando si utilizza un ID mappa o quando si utilizzano mappe vettoriali (utilizza invece la personalizzazione delle mappe basata su cloud). |
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, consente di controllare il comportamento di passaggio automatico per l'angolo di incidenza della mappa. Gli unici valori consentiti sono 0 e 45 . Se utilizzi il valore 0 , la mappa utilizza 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 su 0 quando le immagini a 45° non sono disponibili (comportamento predefinito). Le immagini a 45° sono disponibili solo per i tipi di mappe satellite e hybrid , 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 caso contrario potrebbero verificarsi effetti imprevedibili. |
tiltInteractionEnabled optional |
Tipo:
boolean optional Predefinita:
false Indica se la mappa deve consentire all'utente di controllare l'inclinazione della fotocamera. Questa opzione ha effetto solo quando la mappa è una mappa vettoriale. Se non viene impostato nel codice, verrà utilizzata la configurazione cloud per l'ID mappa (se disponibile). |
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. |
Classe 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" heading-interaction-disabled map-id="string" rendering-type="vector" tilt-interaction-disabled 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.
Costruttore | |
---|---|
MapElement |
MapElement([options]) Parametri:
|
Proprietà | |
---|---|
center |
Tipo:
LatLng|LatLngLiteral optional La latitudine/longitudine centrale della mappa.
Attributo HTML:
|
headingInteractionDisabled |
Tipo:
boolean optional Predefinita:
false Indica se la mappa deve consentire all'utente di controllare l'orientamento (rotazione) della fotocamera. Questa opzione ha effetto solo quando la mappa è una mappa vettoriale. Se non viene impostato nel codice, verrà utilizzata la configurazione cloud per l'ID mappa (se disponibile).
Attributo HTML:
|
innerMap |
Tipo:
Map Un riferimento all'elemento Map che il MapElement utilizza internamente. |
mapId |
Tipo:
string optional L'ID mappa della mappa. Questo parametro non può essere impostato o modificato dopo aver creato un'istanza di una mappa.
Map.DEMO_MAP_ID può essere utilizzato per provare funzionalità che richiedono un ID mappa, ma che non richiedono l'abilitazione del cloud.Attributo HTML:
|
renderingType |
Tipo:
RenderingType optional Predefinita:
RenderingType.VECTOR Indica se la mappa deve essere una mappa raster o vettoriale. Questo parametro non può essere impostato o modificato dopo aver creato un'istanza di una mappa. Se non viene impostato, il tipo di rendering (se disponibile) verrà determinato dalla configurazione cloud per l'ID mappa. Tieni presente che le mappe vettoriali potrebbero non essere disponibili per tutti i dispositivi e i browser e, se necessario, la mappa utilizzerà una mappa raster.
Attributo HTML:
|
tiltInteractionDisabled |
Tipo:
boolean optional Predefinita:
false Indica se la mappa deve consentire all'utente di controllare l'inclinazione della fotocamera. Questa opzione ha effetto solo quando la mappa è una mappa vettoriale. Se non viene impostato nel codice, verrà utilizzata la configurazione cloud per l'ID mappa (se disponibile).
Attributo HTML:
|
zoom |
Tipo:
number optional Il livello di zoom 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.
Attributo HTML:
|
Slot | |
---|---|
control-block-end-inline-center |
Posiziona l'elemento slot nella posizione ControlPosition.BLOCK_END_INLINE_CENTER . |
control-block-end-inline-end |
Posiziona l'elemento slot nella posizione ControlPosition.BLOCK_END_INLINE_END . |
control-block-end-inline-start |
Posiziona l'elemento slot nella posizione ControlPosition.BLOCK_END_INLINE_START . |
control-block-start-inline-center |
Posiziona l'elemento slot nella posizione ControlPosition.BLOCK_START_INLINE_CENTER . |
control-block-start-inline-end |
Posiziona l'elemento slot nella posizione ControlPosition.BLOCK_START_INLINE_END . |
control-block-start-inline-start |
Posiziona l'elemento slot nella posizione ControlPosition.BLOCK_START_INLINE_START . |
control-inline-end-block-center |
Posiziona l'elemento slot nella posizione ControlPosition.INLINE_END_BLOCK_CENTER . |
control-inline-end-block-end |
Posiziona l'elemento slot nella posizione ControlPosition.INLINE_END_BLOCK_END . |
control-inline-end-block-start |
Posiziona l'elemento slot nella posizione ControlPosition.INLINE_END_BLOCK_START . |
control-inline-start-block-center |
Posiziona l'elemento slot nella posizione ControlPosition.INLINE_START_BLOCK_CENTER . |
control-inline-start-block-end |
Posiziona l'elemento slot nella posizione ControlPosition.INLINE_START_BLOCK_END . |
control-inline-start-block-start |
Posiziona l'elemento slot nella posizione ControlPosition.INLINE_START_BLOCK_START . |
default |
Puoi creare componenti riutilizzabili intorno ai componenti web JavaScript di Maps, come AdvancedMarkerElement , utilizzando elementi personalizzati. Per impostazione predefinita, tutti gli elementi personalizzati aggiunti direttamente a MapElement verranno aggiunti a un'area annuncio e visualizzati in MapPanes.overlayMouseTarget . Tuttavia, i componenti web dell'API Maps JavaScript potrebbero essere riallocati negli slot interni di MapElement . |
Metodi | |
---|---|
addEventListener |
addEventListener(type, listener[, options]) Parametri:
Valore restituito:
void Configura una funzione che verrà chiamata ogni volta che l'evento specificato viene pubblicato nella destinazione. Consulta la colonna addEventListener |
removeEventListener |
removeEventListener(type, listener[, options]) Parametri:
Valore restituito:
void Rimuove dalla destinazione un listener di eventi precedentemente registrato con c. Vedi removeEventListener |
Eventi | |
---|---|
gmp-zoomchange |
function(event) Argomenti:
Questo evento viene attivato quando la proprietà di zoom della mappa viene modificata. |
Interfaccia MapElementOptions
Interfaccia google.maps.MapElementOptions
Oggetto MapElementOptions utilizzato per definire le proprietà che possono essere impostate su un MapElement.
Proprietà | |
---|---|
center optional |
Tipo:
LatLng|LatLngLiteral optional Leggi i MapElement.center . |
headingInteractionDisabled optional |
Tipo:
boolean optional |
mapId optional |
Tipo:
string optional Leggi i MapElement.mapId . |
renderingType optional |
Tipo:
RenderingType optional Leggi i MapElement.renderingType . |
tiltInteractionDisabled optional |
Tipo:
boolean optional Leggi i MapElement.tiltInteractionDisabled . |
zoom optional |
Tipo:
number optional Leggi i MapElement.zoom . |
Classe ZoomChangeEvent
google.maps.ZoomChangeEvent
classe
Questo evento viene creato in base al monitoraggio della variazione 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
L'elemento MapTypeStyle
è una raccolta di selettori e strumenti di stile che definiscono lo stile della mappa. I selettori specificano le funzionalità e/o gli elementi della mappa che devono essere interessati, mentre gli strumenti di stile specificano le modalità di modifica di tali elementi e funzionalità. Per maggiori dettagli, consulta la documentazione di riferimento sugli stili.
Proprietà | |
---|---|
stylers |
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 deve essere applicato 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 viene specificato, si presume che il valore sia 'all' . Per informazioni dettagliate sull'utilizzo e sui valori consentiti, consulta la documentazione di riferimento sugli stili. |
featureType optional |
Tipo:
string optional L'elemento o il gruppo di caratteristiche a cui deve essere applicato uno stiler. Campo facoltativo. Se featureType non viene specificato, si presume che il valore sia 'all' . Per informazioni dettagliate 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 sugli overlay e contiene tutti i campi mostrati di seguito.
Proprietà | |
---|---|
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 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 rispetto a quella di MapMouseEvent (ad es. un "clic" 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: 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 nella mappa. L'ID luogo di questo luogo è archiviato nel membro placeId. Per impedire la visualizzazione della 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 su cui è stato fatto clic. Questo ID luogo può essere utilizzato per ottenere ulteriori informazioni sull'elemento su cui è stato fatto clic. Scopri di più sugli ID luogo nella guida per gli sviluppatori dell'API Places. |
Ereditate:
domEvent ,
latLng
|
Metodi | |
---|---|
Ereditate:
stop
|
Costanti MapTypeId
google.maps.MapTypeId
costanti
Identificatori per i MapTypes 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 delle strade principali sulle immagini satellitari. |
ROADMAP |
Questo tipo di mappa visualizza una mappa stradale normale. |
SATELLITE |
Questo tipo di mappa mostra immagini satellitari. |
TERRAIN |
Questo tipo di mappa mostra mappe con elementi fisici come rilievi 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.
Costruttore | |
---|---|
MapTypeRegistry |
MapTypeRegistry() Parametri: nessuno
L'elemento MapTypeRegistry contiene la raccolta di tipi di mappe personalizzate disponibili per la mappa per il suo utilizzo. Ad esempio, l'API consulta questo registro per fornire l'elenco dei tipi di mappa disponibili all'interno dei controlli. |
Metodi | |
---|---|
set |
set(id, mapType) Parametri:
Valore restituito: nessuno
Imposta il registro per associare l'identificatore della stringa passata al MapType passato. |
Ereditate:
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à questi limiti.
Proprietà | |
---|---|
latLngBounds |
Se questa opzione è impostata, 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 possono limitare solo la latitudine. Per i limiti di solo latitudine, utilizza le longitudini 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 resi più restrittivi impostando il flag strictBounds su true . In questo modo si riduce di quanto un utente può diminuire lo zoom, assicurando che tutti gli elementi al di fuori dei limiti 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 possibilmente aree al di fuori dell'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.
Costruttore | |
---|---|
TrafficLayer |
TrafficLayer([opts]) Parametri:
Un livello che mostra il traffico stradale attuale. |
Metodi | |
---|---|
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
|
Ereditate:
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 Trafficstrato.
Proprietà | |
---|---|
autoRefresh optional |
Tipo:
boolean optional Predefinita:
true Indica se il livello di traffico si aggiorna automaticamente con informazioni aggiornate. |
map optional |
Tipo:
Map optional Mappa sulla quale visualizzare il livello del traffico. |
Classe TransitLayer
google.maps.TransitLayer
classe
Un livello per il trasporto pubblico.
Questa classe estende
MVCObject
.
Accedi chiamando const {TransitLayer} = await google.maps.importLibrary("maps")
. Consulta la sezione Librerie nell'API Maps JavaScript.
Costruttore | |
---|---|
TransitLayer |
TransitLayer() Parametri: nessuno
Un livello che mostra le linee di trasporto pubblico. |
Metodi | |
---|---|
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. |
Ereditate:
addListener ,
bindTo ,
get ,
notify ,
set ,
setValues ,
unbind ,
unbindAll
|
Classe BicyclingLayer
google.maps.BicyclingLayer
classe
Un livello che mostra piste ciclabili e percorsi.
Questa classe estende
MVCObject
.
Accedi chiamando const {BicyclingLayer} = await google.maps.importLibrary("maps")
. Consulta la sezione Librerie nell'API Maps JavaScript.
Costruttore | |
---|---|
BicyclingLayer |
BicyclingLayer() Parametri: nessuno
Un livello che mostra le piste ciclabili e i percorsi e fa retrocedere strade di grandi dimensioni. |
Metodi | |
---|---|
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. |
Ereditate:
addListener ,
bindTo ,
get ,
notify ,
set ,
setValues ,
unbind ,
unbindAll
|
Interfaccia CameraOptions
Interfaccia google.maps.CameraOptions
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 è l'area visibile della mappa. In una mappa vettoriale, questo poligono può essere un trapezio anziché un rettangolo, quando una mappa vettoriale presenta 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 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 è una mappa raster. |
UNINITIALIZED |
Indica che non è ancora chiaro 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 vengano caricati o inizializzati, ma piuttosto che la mappa corrente disponga dell'autorizzazione per utilizzare queste API. Consulta le proprietà per un elenco delle possibili funzionalità.
Proprietà | |
---|---|
isAdvancedMarkersAvailable optional |
Tipo:
boolean optional Se il valore è true, la 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 maggiori informazioni, visita la pagina https://goo.gle/gmp-isAdvancedMarkersAvailable. |
isDataDrivenStylingAvailable optional |
Tipo:
boolean optional Se il valore è true, la mappa è configurata correttamente per consentire l'utilizzo di stili basati sui dati per almeno un Feature Layer. Per saperne di più, visita le pagine https://goo.gle/gmp-data-driven-styling e https://goo.gle/gmp-FeatureLayerIsAvailable. |
isWebGLOverlayViewAvailable optional |
Tipo:
boolean optional Se il valore è true, questa mappa è configurata correttamente per consentire l'utilizzo di WebGLOverlayView . |