Classe Map
google.maps.Map
classe
Questo corso si estende
MVCObject
.
Accesso chiamando il numero const {Map} = await google.maps.importLibrary("maps")
.
Consulta 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 gli 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 la personalizzazione basata su cloud). |
Proprietà | |
---|---|
controls |
Tipo:
Array<MVCArray<HTMLElement>> Controlli aggiuntivi da allegare alla mappa. Per aggiungere un controllo alla mappa, aggiungi il <div> del controllo al MVCArray corrispondente al ControlPosition in cui deve essere visualizzato. |
data |
Tipo:
Data Un'istanza di Data , associata alla mappa. Aggiungi funzionalità a questo oggetto Data per visualizzarle comodamente su questa mappa. |
mapTypes |
Tipo:
MapTypeRegistry Un registro delle istanze MapType per ID stringa. |
overlayMapTypes |
Tipi di mappe aggiuntivi da sovrapporre. I tipi di mappe in overlay vengono visualizzati sopra la mappa di base a cui sono collegati, 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 0x0 e pertanto non esegue alcuna operazione. Per modificare l'area visibile mentre la mappa è nascosta, imposta la mappa su visibility: hidden , in modo che il div della mappa abbia una dimensione effettiva. Per le mappe vettoriali, questo metodo imposta l'inclinazione e la direzione della mappa sui valori predefiniti pari a zero. La chiamata a questo metodo può causare un'animazione fluida mentre la mappa si sposta e si ingrandisce per adattarsi ai limiti. L'animazione di 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 del viewport corrente. Se è visibile più di una copia del mondo, l'intervallo dei limiti in longitudine va da -180 a 180 gradi inclusi. Se la mappa non è ancora stata inizializzata o il centro e lo zoom non sono stati impostati, il risultato è undefined . Per le mappe vettoriali con inclinazione o direzione diverse da zero, i limiti di latitudine/longitudine restituiti rappresentano il più piccolo rettangolo di selezione che include la regione visibile del riquadro della mappa. Consulta MapCanvasProjection.getVisibleRegion per ottenere la regione visibile esatta dell'area visibile della mappa. |
getCenter |
getCenter() Parametri: nessuno
Valore restituito:
LatLng|undefined |
getClickableIcons |
getClickableIcons() Parametri: nessuno
Valore restituito:
boolean|undefined Restituisce la possibilità di fare clic sulle icone della mappa. Un'icona della mappa rappresenta un punto d'interesse, noto anche come PDI. Se il valore restituito è true , le icone sono selezionabili sulla mappa. |
|
getDatasetFeatureLayer(datasetId) Parametri:
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 set di dati non è associato allo stile di mappa della mappa o se lo stile basato sui dati non è disponibile (nessun ID mappa, nessuna tessera vettoriale, nessun livello di funzionalità o set di dati di stile basato sui dati configurato nello stile di mappa), viene registrato un errore e il valore di FeatureLayer.isAvailable risultante sarà false. |
getDiv |
getDiv() Parametri: nessuno
Valore restituito:
HTMLElement mapDiv della mappa. |
getFeatureLayer |
getFeatureLayer(featureType) Parametri:
Valore restituito:
FeatureLayer Restituisce il FeatureLayer dello specifico FeatureType . Un FeatureLayer deve essere abilitato nella console Google Cloud. Se un FeatureLayer del FeatureType specificato non esiste su questa mappa o se lo stile basato sui dati non è disponibile (nessun ID mappa, nessun riquadro vettoriale e nessun FeatureLayer abilitato nello stile di mappa), viene registrato un errore e il FeatureLayer.isAvailable risultante sarà false. |
getHeading |
getHeading() Parametri: nessuno
Valore restituito:
number|undefined Restituisce l'orientamento della mappa. Il valore della direzione viene misurato in gradi (in senso orario) rispetto alla direzione cardinale nord. Se la mappa non è ancora inizializzata, il risultato è undefined . |
getHeadingInteractionEnabled |
getHeadingInteractionEnabled() Parametri: nessuno
Valore restituito:
boolean|null Restituisce un valore che indica se le interazioni con i titoli sono attive. Questa opzione è efficace solo quando la mappa è una mappa vettoriale. Se non è impostato nel codice, verrà utilizzata la configurazione cloud per l'ID mappa (se disponibile). |
getInternalUsageAttributionIds |
getInternalUsageAttributionIds() Parametri: nessuno
Valore restituito:
Iterable<string>|null Restituisce l'elenco degli ID attribuzione utilizzo, che aiutano Google a capire quali librerie ed esempi sono utili agli sviluppatori, ad esempio l'utilizzo di una libreria di clustering dei marcatori. |
getMapCapabilities |
getMapCapabilities() Parametri: nessuno
Valore restituito:
MapCapabilities Informa il chiamante delle funzionalità attuali disponibili per la mappa in base all'ID mappa fornito. |
getMapTypeId |
getMapTypeId() Parametri: nessuno
Valore restituito:
MapTypeId|string|undefined |
getProjection |
getProjection() Parametri: nessuno
Valore restituito:
Projection|undefined Restituisce l' Projection corrente. Se la mappa non è 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 valore RenderingType corrente 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 nella mappa o il panorama impostato utilizzando setStreetView() . Le modifiche apportate al streetViewControl della mappa si rifletteranno nella visualizzazione di un panorama vincolato. |
getTilt |
getTilt() Parametri: nessuno
Valore restituito:
number|undefined Restituisce l'angolo di incidenza attuale della mappa, in gradi dal piano della finestra al piano 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 i dettagli, visita la pagina setTilt . |
getTiltInteractionEnabled |
getTiltInteractionEnabled() Parametri: nessuno
Valore restituito:
boolean|null Restituisce un valore che indica se le interazioni di inclinazione sono attive. Questa opzione è efficace solo quando la mappa è una mappa vettoriale. Se non è impostato nel codice, verrà utilizzata la configurazione cloud per l'ID mappa (se disponibile). |
getZoom |
getZoom() Parametri: nessuno
Valore restituito:
number|undefined Restituisce il livello di zoom della mappa. Se lo zoom non è stato impostato, il risultato è undefined . |
moveCamera |
moveCamera(cameraOptions) Parametri:
Valore restituito:nessuno
Imposta immediatamente la videocamera della mappa sulle opzioni della videocamera di destinazione, senza animazione. |
panBy |
panBy(x, y) Parametri:
Valore restituito:nessuno
Modifica il centro della mappa della distanza specificata in pixel. Se la distanza è inferiore sia alla larghezza che all'altezza della mappa, la transizione sarà animata in modo fluido. 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 restituito:nessuno
Modifica il centro della mappa in base al valore LatLng specificato. Se la modifica è inferiore sia alla larghezza che all'altezza della mappa, la transizione verrà animata in modo fluido. |
panToBounds |
panToBounds(latLngBounds[, padding]) Parametri:
Valore restituito:nessuno
Esegue la panoramica della mappa in base all'importo minimo necessario per contenere il LatLngBounds specificato. Non garantisce la posizione dei limiti sulla mappa, ma la mappa verrà spostata in modo da mostrare il maggior numero possibile di limiti all'interno di {currentMapSizeInPx} - {padding} . Per le mappe raster e vettoriali, lo zoom, l'inclinazione e la direzione della mappa non verranno modificati. |
setCenter |
setCenter(latlng) Parametri:
Valore restituito:nessuno
|
setClickableIcons |
setClickableIcons(value) Parametri:
Valore restituito:nessuno
Controlla se le icone della mappa sono selezionabili o meno. Un'icona della mappa rappresenta un punto d'interesse, noto anche come PDI. Per disattivare la possibilità di fare clic sulle icone della mappa, passa un valore di false a questo metodo. |
setHeading |
setHeading(heading) Parametri:
Valore restituito:nessuno
Imposta l'orientamento della bussola per la mappa misurato in gradi dalla direzione cardinale nord. Per le mappe raster, questo metodo si applica solo alle immagini aeree. |
setHeadingInteractionEnabled |
setHeadingInteractionEnabled(headingInteractionEnabled) Parametri:
Valore restituito:nessuno
Determina se le interazioni con le intestazioni sono attivate. Questa opzione è efficace solo quando la mappa è una mappa vettoriale. Se non è 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 l'attuale RenderingType della mappa. |
setStreetView |
setStreetView(panorama) Parametri:
Valore restituito:nessuno
Collega un StreetViewPanorama alla mappa. Questo panorama sostituisce StreetViewPanorama predefinito, consentendo alla mappa di essere associata a un panorama esterno. Se imposti il panorama su null , il panorama incorporato predefinito viene nuovamente associato 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, controlla il comportamento di commutazione automatica 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 visualizzazione dall'alto a 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 il viewport correnti e torni 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 mappe satellite e hybrid , in alcune località e a determinati livelli di zoom. Nota:getTilt restituisce l'angolo di inclinazione corrente, non il valore impostato da setTilt . Poiché getTilt e setTilt si riferiscono a cose diverse, non bind() la proprietà tilt , altrimenti potresti ottenere effetti imprevedibili. |
setTiltInteractionEnabled |
setTiltInteractionEnabled(tiltInteractionEnabled) Parametri:
Valore restituito:nessuno
Determina se le interazioni di inclinazione sono attive. Questa opzione è efficace solo quando la mappa è una mappa vettoriale. Se non è 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. |
Ereditato:
addListener ,
bindTo ,
get ,
notify ,
set ,
setValues ,
unbind ,
unbindAll
|
Eventi | |
---|---|
bounds_changed |
function() Argomenti: nessuno
Questo evento viene attivato quando i limiti della finestra vengono modificati. |
center_changed |
function() Argomenti: nessuno
Questo evento viene attivato quando cambia la proprietà del centro della mappa. |
click |
function(event) Argomenti:
Questo evento viene attivato quando l'utente fa clic sulla mappa. Viene restituito un MapMouseEvent con le proprietà della posizione su cui è stato fatto clic, a meno che non sia stata selezionata un'icona di 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 MapMouseEvent quando l'ID luogo non è importante. L'evento di clic non viene attivato se è stato fatto clic su un indicatore o una finestra informativa. |
contextmenu |
function(event) Argomenti:
Questo evento viene attivato quando viene attivato l'evento DOM contextmenu 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 viene attivato 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. Nota: l'evento dragend NON viene attivato quando l'utente smette di spostare la mappa utilizzando la tastiera. Utilizza invece l'evento Map.idle per determinare quando l'utente ha smesso di spostare o 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 cambia la proprietà dell'intestazione della mappa. |
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 cambiano le funzionalità della mappa. |
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 renderingType è cambiato. |
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 cambia la proprietà di inclinazione della mappa. |
zoom_changed |
function() Argomenti: nessuno
Questo evento viene attivato quando cambia la proprietà di zoom della mappa. |
|
function(event) Argomenti:
Questo evento viene attivato quando l'utente fa clic con il tasto destro del mouse sulla mappa. |
Interfaccia MapOptions
google.maps.MapOptions
interfaccia
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 lo spostamento dell'utente. Questa opzione può essere impostata solo quando la mappa viene inizializzata. |
cameraControl optional |
Tipo:
boolean optional Lo stato di attivazione/disattivazione del controllo della videocamera. |
cameraControlOptions optional |
Tipo:
CameraControlOptions optional Le opzioni di visualizzazione per il controllo della videocamera. |
center optional |
Tipo:
LatLng|LatLngLiteral optional Il centro iniziale della mappa. |
clickableIcons optional |
Tipo:
boolean optional Predefinito:
true Quando false , le icone della mappa non sono selezionabili. Un'icona della mappa rappresenta un punto d'interesse, noto anche come PDI. |
colorScheme optional |
Tipo:
ColorScheme|string optional Predefinito:
ColorScheme.LIGHT La combinazione di colori iniziale della mappa. Questa opzione può essere impostata solo quando la mappa viene inizializzata. |
controlSize optional |
Tipo:
number optional Dimensioni in pixel dei controlli visualizzati sulla mappa. Questo valore deve essere fornito direttamente durante la creazione della mappa. L'aggiornamento successivo di questo valore potrebbe portare i controlli in uno stato undefined . Governa solo i controlli eseguiti dall'API Maps stessa. Non scala i controlli personalizzati creati dagli sviluppatori. |
disableDefaultUI optional |
Tipo:
boolean optional Attiva/disattiva tutti i pulsanti dell'interfaccia utente predefinita. Possono essere sostituite singolarmente. Non disattiva i controlli da tastiera, che sono controllati separatamente dall'opzione MapOptions.keyboardShortcuts . Non disattiva i controlli tramite gesti, che vengono controllati separatamente dall'opzione MapOptions.gestureHandling . |
disableDoubleClickZoom optional |
Tipo:
boolean optional Attiva/disattiva lo zoom e il centro con il doppio clic. Abilitato per impostazione predefinita. Nota: questa proprietà non è consigliata. Per disattivare lo zoom con doppio clic, puoi utilizzare la proprietà |
|
Tipo:
boolean optional Se false , impedisce di trascinare la 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 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 |
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 per le immagini aeree in gradi misurati in senso orario dalla direzione cardinale nord. Le intestazioni vengono allineate all'angolo disponibile più vicino per il quale sono disponibili immagini. |
headingInteractionEnabled optional |
Tipo:
boolean optional Predefinito:
false Indica se la mappa deve consentire all'utente di controllare l'orientamento (rotazione) della videocamera. Questa opzione è efficace solo quando la mappa è una mappa vettoriale. Se non è impostato nel codice, verrà utilizzata la configurazione cloud per l'ID mappa (se disponibile). |
internalUsageAttributionIds optional |
Tipo:
Iterable<string> optional Predefinito:
null Aggiunge un ID attribuzione utilizzo all'inizializzatore, che aiuta Google a capire quali librerie ed esempi sono utili agli sviluppatori, ad esempio l'utilizzo di una libreria di clustering dei marcatori. Per disattivare l'invio dell'ID attribuzione utilizzo, puoi eliminare questa proprietà o sostituire il valore con una stringa vuota. Verranno inviati solo i valori univoci. Le modifiche a questo valore dopo l'istanza potrebbero essere ignorate. |
isFractionalZoomEnabled optional |
Tipo:
boolean optional Predefinito:
true per le mappe vettoriali e false per le mappe rasterIndica se la mappa deve consentire livelli di zoom frazionari. Ascolta isfractionalzoomenabled_changed per sapere quando è stata impostata l'impostazione predefinita. |
keyboardShortcuts optional |
Tipo:
boolean optional Se false , impedisce il controllo della mappa tramite la tastiera. Le scorciatoie da tastiera sono attive per impostazione predefinita. |
mapId optional |
Tipo:
string optional L'ID mappa della mappa. Questo parametro non può essere impostato o modificato dopo l'istanza di una mappa. Map.DEMO_MAP_ID può essere utilizzato per provare funzionalità che richiedono un ID mappa, ma non l'attivazione del cloud. |
mapTypeControl optional |
Tipo:
boolean optional Lo stato iniziale di attivazione/disattivazione del controllo Tipo di mappa. |
mapTypeControlOptions optional |
Tipo:
MapTypeControlOptions optional Le opzioni di visualizzazione iniziali per il controllo Tipo di mappa. |
mapTypeId optional |
Tipo:
MapTypeId|string optional Il tipo di mappa iniziale di Map. Il valore predefinito è ROADMAP . |
maxZoom optional |
Tipo:
number optional Il livello di zoom massimo che verrà visualizzato sulla mappa. Se omesso o impostato su null , viene utilizzato lo zoom massimo del tipo di mappa corrente. I valori di zoom validi sono numeri da zero fino al livello di zoom massimo supportato. |
minZoom optional |
Tipo:
number optional Il livello di zoom minimo che verrà visualizzato sulla mappa. Se omesso o impostato su null , viene utilizzato lo zoom minimo del tipo di mappa corrente. I valori di zoom validi sono numeri da zero fino al livello di zoom massimo supportato. |
noClear optional |
Tipo:
boolean optional Se true , non cancellare i contenuti del div della mappa. |
|
Tipo:
boolean optional Lo stato di attivazione/disattivazione del controllo Panoramica. |
|
Tipo:
PanControlOptions optional Le opzioni di visualizzazione per il controllo Pan. |
renderingType optional |
Tipo:
RenderingType optional Predefinito:
RenderingType.RASTER Indica se la mappa deve essere una mappa raster o vettoriale. Questo parametro non può essere impostato o modificato dopo l'istanza di una mappa. Se non impostato, la configurazione cloud per l'ID mappa determinerà il tipo di rendering (se disponibile). Tieni presente che le mappe vettoriali potrebbero non essere disponibili per tutti i dispositivi e i browser e la mappa verrà ripristinata come mappa raster in base alle necessità. |
restriction optional |
Tipo:
MapRestriction optional Definisce un confine che limita l'area della mappa accessibile agli utenti. Una volta impostato, un utente può eseguire panoramica e zoom solo se la visualizzazione della videocamera rimane entro i limiti del confine. |
rotateControl optional |
Tipo:
boolean optional Lo stato di attivazione/disattivazione del controllo Ruota. |
rotateControlOptions optional |
Tipo:
RotateControlOptions optional Le opzioni di visualizzazione per il controllo Ruota. |
scaleControl optional |
Tipo:
boolean optional Lo stato iniziale di attivazione/disattivazione del controllo 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 tramite la rotellina del mouse. La rotellina è attiva per impostazione predefinita. Nota: questa proprietà non è consigliata. Per disattivare lo zoom tramite la rotellina del mouse, puoi utilizzare la proprietà |
streetView optional |
Tipo:
StreetViewPanorama optional Un StreetViewPanorama da visualizzare quando il Pegman di Street View viene rilasciato sulla mappa. Se non viene specificata alcuna panoramica, quando viene rilasciato l'omino Pegman, nella div della mappa viene visualizzata una StreetViewPanorama predefinita. |
streetViewControl optional |
Tipo:
boolean optional Lo stato iniziale di attivazione/disattivazione del controllo Pegman di Street View. 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 delle strade di Street View (ad esempio, un tipo di mappa non terrestre). |
streetViewControlOptions optional |
Tipo:
StreetViewControlOptions optional Le opzioni di visualizzazione iniziali per il controllo Pegman di Street View. |
styles optional |
Tipo:
Array<MapTypeStyle> optional Stili da applicare a ciascuno dei tipi di mappa predefiniti. Tieni presente che per le modalità satellite /hybrid e terrain , questi stili verranno applicati solo alle etichette e alla geometria. Questa funzionalità non è disponibile quando utilizzi un ID mappa o 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, controlla il comportamento di commutazione automatica 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 visualizzazione dall'alto a 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 finestra corrente e torni 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 mappe satellite e hybrid , in alcune località e a determinati livelli di zoom. Nota:getTilt restituisce l'angolo di inclinazione corrente, non il valore specificato da questa opzione. Poiché getTilt e questa opzione si riferiscono a cose diverse, non bind() la proprietà tilt , altrimenti potrebbero verificarsi effetti imprevedibili. |
tiltInteractionEnabled optional |
Tipo:
boolean optional Predefinito:
false Indica se la mappa deve consentire il controllo dell'inclinazione della videocamera da parte dell'utente. Questa opzione è efficace solo quando la mappa è una mappa vettoriale. Se non è 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ù elevati corrispondono a una risoluzione maggiore. |
zoomControl optional |
Tipo:
boolean optional Lo stato di attivazione/disattivazione del controllo dello zoom. |
zoomControlOptions optional |
Tipo:
ZoomControlOptions optional Le opzioni di visualizzazione per il controllo dello zoom. |
Classe MapElement
google.maps.MapElement
classe
MapElement è una sottoclasse di 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 internal-usage-attribution-ids="id1 id2" map-id="string" rendering-type="vector" tilt-interaction-disabled zoom="number"></gmp-map>
Questo corso si estende
HTMLElement
.
Questa classe implementa
MapElementOptions
.
Accesso chiamando il numero const {MapElement} = await google.maps.importLibrary("maps")
.
Consulta Librerie nell'API Maps JavaScript.
Costruttore | |
---|---|
MapElement |
MapElement([options]) Parametri:
|
Proprietà | |
---|---|
center |
Tipo:
LatLng|LatLngLiteral optional La latitudine/longitudine del centro della mappa.
Attributo HTML:
|
headingInteractionDisabled |
Tipo:
boolean optional Predefinito:
false Indica se la mappa deve consentire all'utente di controllare l'orientamento (rotazione) della videocamera. Questa opzione è efficace solo quando la mappa è una mappa vettoriale. Se non è impostato nel codice, verrà utilizzata la configurazione cloud per l'ID mappa (se disponibile).
Attributo HTML:
|
innerMap |
Tipo:
Map Un riferimento a Map che MapElement utilizza internamente. |
internalUsageAttributionIds |
Tipo:
Iterable<string> optional Predefinito:
null Aggiunge un ID attribuzione utilizzo all'inizializzatore, che aiuta Google a capire quali librerie ed esempi sono utili agli sviluppatori, ad esempio l'utilizzo di una libreria di clustering dei marcatori. Per disattivare l'invio dell'ID attribuzione utilizzo, puoi eliminare questa proprietà o sostituire il valore con una stringa vuota. Verranno inviati solo i valori univoci. Le modifiche a questo valore dopo l'istanza potrebbero essere ignorate.
Attributo HTML:
|
mapId |
Tipo:
string optional L'ID mappa della mappa. Questo parametro non può essere impostato o modificato dopo l'istanza di una mappa.
Map.DEMO_MAP_ID può essere utilizzato per provare funzionalità che richiedono un ID mappa, ma non l'attivazione del cloud.Attributo HTML:
|
renderingType |
Tipo:
RenderingType optional Predefinito:
RenderingType.VECTOR Indica se la mappa deve essere una mappa raster o vettoriale. Questo parametro non può essere impostato o modificato dopo l'istanza di una mappa. Se non impostato, la configurazione cloud per l'ID mappa determinerà il tipo di rendering (se disponibile). Tieni presente che le mappe vettoriali potrebbero non essere disponibili per tutti i dispositivi e i browser e la mappa verrà ripristinata come mappa raster in base alle necessità.
Attributo HTML:
|
tiltInteractionDisabled |
Tipo:
boolean optional Predefinito:
false Indica se la mappa deve consentire il controllo dell'inclinazione della videocamera da parte dell'utente. Questa opzione è efficace solo quando la mappa è una mappa vettoriale. Se non è 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ù elevati corrispondono a una risoluzione maggiore.
Attributo HTML:
|
Slot | |
---|---|
control-block-end-inline-center |
Posiziona l'elemento inserito nella posizione ControlPosition.BLOCK_END_INLINE_CENTER . |
control-block-end-inline-end |
Posiziona l'elemento inserito nella posizione ControlPosition.BLOCK_END_INLINE_END . |
control-block-end-inline-start |
Posiziona l'elemento inserito nella posizione ControlPosition.BLOCK_END_INLINE_START . |
control-block-start-inline-center |
Posiziona l'elemento inserito nella posizione ControlPosition.BLOCK_START_INLINE_CENTER . |
control-block-start-inline-end |
Posiziona l'elemento inserito nella posizione ControlPosition.BLOCK_START_INLINE_END . |
control-block-start-inline-start |
Posiziona l'elemento inserito nella posizione ControlPosition.BLOCK_START_INLINE_START . |
control-inline-end-block-center |
Posiziona l'elemento inserito nella posizione ControlPosition.INLINE_END_BLOCK_CENTER . |
control-inline-end-block-end |
Posiziona l'elemento inserito nella posizione ControlPosition.INLINE_END_BLOCK_END . |
control-inline-end-block-start |
Posiziona l'elemento inserito nella posizione ControlPosition.INLINE_END_BLOCK_START . |
control-inline-start-block-center |
Posiziona l'elemento inserito nella posizione ControlPosition.INLINE_START_BLOCK_CENTER . |
control-inline-start-block-end |
Posiziona l'elemento inserito nella posizione ControlPosition.INLINE_START_BLOCK_END . |
control-inline-start-block-start |
Posiziona l'elemento inserito 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 inseriti e visualizzati in MapPanes.overlayMouseTarget . Tuttavia, i componenti web dell'API Maps JavaScript possono essere riassegnati agli slot interni di MapElement . |
Metodi | |
---|---|
|
addEventListener(type, listener[, options]) Parametri:
Valore restituito:
void Configura una funzione che verrà chiamata ogni volta che l'evento specificato viene inviato alla destinazione. Vedi addEventListener. |
|
removeEventListener(type, listener[, options]) Parametri:
Valore restituito:
void Rimuove dal target un listener di eventi registrato in precedenza con addEventListener. Vedi removeEventListener. |
Eventi | |
---|---|
gmp-zoomchange |
function(event) Argomenti:
Questo evento viene attivato quando cambia la proprietà di zoom della mappa. |
MapElementOptions
google.maps.MapElementOptions
interfaccia
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 |
internalUsageAttributionIds optional |
Tipo:
Iterable<string> 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 . |
ZoomChangeEvent class
google.maps.ZoomChangeEvent
classe
Questo evento viene creato dalla modifica dello zoom del monitoraggio.
Questo corso si estende
Event
.
Accesso chiamando il numero const {ZoomChangeEvent} = await google.maps.importLibrary("maps")
.
Consulta Librerie nell'API Maps JavaScript.
Interfaccia MapTypeStyle
google.maps.MapTypeStyle
interfaccia
MapTypeStyle
è una raccolta di selettori e stili che definiscono lo stile della mappa. I selettori specificano gli elementi e/o le funzionalità della mappa da modificare, mentre gli stili specificano la modalità di modifica. Per maggiori dettagli, consulta il riferimento allo stile.
Proprietà | |
---|---|
stylers |
Le regole di stile da applicare agli elementi e alle funzionalità della mappa selezionati. Le regole vengono applicate nell'ordine specificato in questo array. Per le linee guida sull'utilizzo e i valori consentiti, consulta il riferimento di stile. |
elementType optional |
Tipo:
string optional L'elemento a cui deve essere applicato uno stile. Un elemento è un aspetto visivo di una funzionalità sulla mappa. Esempio: un'etichetta, un'icona, il tratto o il riempimento applicato alla geometria e altro ancora. (Facoltativo) Se elementType non è specificato, si presume che il valore sia 'all' . Per i dettagli sull'utilizzo e sui valori consentiti, consulta il riferimento allo stile. |
featureType optional |
Tipo:
string optional La funzionalità o il gruppo di funzionalità a cui deve essere applicato uno stile. (Facoltativo) Se featureType non è specificato, si presume che il valore sia 'all' . Per i dettagli sull'utilizzo e sui valori consentiti, consulta il riferimento allo stile. |
MapMouseEvent interfaccia
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.
Proprietà | |
---|---|
domEvent |
L'evento DOM nativo corrispondente. Gli sviluppatori non devono fare affidamento sulle proprietà target , currentTarget , relatedTarget e path per la definizione e la coerenza. Gli sviluppatori non devono fare affidamento sulla struttura DOM dell'implementazione interna dell'API Maps. A causa della mappatura interna degli eventi, domEvent potrebbe avere una semantica diversa da 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
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 è memorizzato nel membro placeId. Per impedire la visualizzazione della finestra informativa predefinita, chiama il metodo stop() su questo evento per impedirne la propagazione. 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 luogo del luogo su cui è stato fatto clic. Questo ID luogo può essere utilizzato per richiedere ulteriori informazioni sulla funzionalità 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 ColorScheme
google.maps.ColorScheme
costanti
Identificatori per le combinazioni di colori della mappa. Specificali per valore o utilizzando il nome della costante. Ad esempio, 'FOLLOW_SYSTEM'
o google.maps.ColorScheme.FOLLOW_SYSTEM
.
Accesso chiamando il numero const {ColorScheme} = await google.maps.importLibrary("core")
.
Consulta Librerie nell'API Maps JavaScript.
Costanti | |
---|---|
DARK |
La combinazione di colori scuri per una mappa. |
FOLLOW_SYSTEM |
La combinazione di colori viene selezionata in base alle preferenze di sistema. |
LIGHT |
La combinazione di colori chiari per una mappa. Valore predefinito per Maps JavaScript legacy. |
Costanti MapTypeId
google.maps.MapTypeId
costanti
Identificatori per MapType comuni. Specificali per valore o utilizzando il nome della costante. Ad esempio, 'satellite'
o google.maps.MapTypeId.SATELLITE
.
Accesso chiamando il numero const {MapTypeId} = await google.maps.importLibrary("maps")
.
Consulta 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 cartina stradale. |
SATELLITE |
Questo tipo di mappa mostra le immagini satellitari. |
TERRAIN |
Questo tipo di mappa mostra mappe con caratteristiche fisiche come il terreno e la vegetazione. |
MapTypeRegistry class
google.maps.MapTypeRegistry
classe
Un registro per le istanze MapType, indicizzate per ID MapType.
Questo corso si estende
MVCObject
.
Accesso chiamando il numero const {MapTypeRegistry} = await google.maps.importLibrary("maps")
.
Consulta Librerie nell'API Maps JavaScript.
Costruttore | |
---|---|
MapTypeRegistry |
MapTypeRegistry() Parametri: nessuno
MapTypeRegistry contiene la raccolta di tipi di mappe personalizzati disponibili per la mappa. L'API consulta questo registro quando fornisce l'elenco dei tipi di mappe disponibili all'interno dei controlli, ad esempio. |
Metodi | |
---|---|
set |
set(id, mapType) Parametri:
Valore restituito:nessuno
Imposta il registro in modo da associare l'identificatore stringa passato al MapType passato. |
Ereditato:
addListener ,
bindTo ,
get ,
notify ,
setValues ,
unbind ,
unbindAll
|
Interfaccia MapRestriction
google.maps.MapRestriction
interfaccia
Una limitazione che può essere applicata alla mappa. Il riquadro della mappa non supererà queste limitazioni.
Proprietà | |
---|---|
latLngBounds |
Se impostato, un utente può eseguire la panoramica e lo zoom solo all'interno dei limiti specificati. I limiti possono restringere sia la longitudine che la latitudine oppure solo la latitudine. Per i limiti di sola latitudine, utilizza le longitudini ovest ed est di -180 e 180, rispettivamente, 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 il livello di zoom out che un utente può applicare, garantendo che tutto ciò che si trova al di fuori dei limiti ristretti rimanga nascosto. Il valore predefinito è false , il che significa che un utente può ridurre lo zoom fino a visualizzare l'intera area delimitata, che potrebbe includere anche aree al di fuori di essa. |
TrafficLayer class
google.maps.TrafficLayer
classe
Un livello del traffico.
Questo corso si estende
MVCObject
.
Accesso chiamando il numero const {TrafficLayer} = await google.maps.importLibrary("maps")
.
Consulta 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|null Restituisce la mappa su cui viene visualizzato questo livello. |
setMap |
setMap(map) Parametri:
Valore restituito:nessuno
Esegue il rendering del livello sulla mappa specificata. Se la mappa è impostata su null , il livello verrà rimosso. |
setOptions |
setOptions(options) Parametri:
Valore restituito:nessuno
|
Ereditato:
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 TrafficLayer.
Proprietà | |
---|---|
autoRefresh optional |
Tipo:
boolean optional Predefinito:
true Se il livello del traffico si aggiorna automaticamente con le informazioni aggiornate. |
map optional |
Tipo:
Map optional Mappa su cui visualizzare il livello del traffico. |
TransitLayer class
google.maps.TransitLayer
classe
Un livello di trasporto pubblico.
Questo corso si estende
MVCObject
.
Accesso chiamando il numero const {TransitLayer} = await google.maps.importLibrary("maps")
.
Consulta 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|null Restituisce la mappa su cui viene visualizzato questo livello. |
setMap |
setMap(map) Parametri:
Valore restituito:
void Esegue il rendering del livello sulla mappa specificata. Se la mappa è impostata su null , il livello verrà rimosso. |
Ereditato:
addListener ,
bindTo ,
get ,
notify ,
set ,
setValues ,
unbind ,
unbindAll
|
Classe BicyclingLayer
google.maps.BicyclingLayer
classe
Un livello che mostra le corsie e i percorsi ciclabili.
Questo corso si estende
MVCObject
.
Accesso chiamando il numero const {BicyclingLayer} = await google.maps.importLibrary("maps")
.
Consulta Librerie nell'API Maps JavaScript.
Costruttore | |
---|---|
BicyclingLayer |
BicyclingLayer() Parametri: nessuno
Un livello che mostra piste ciclabili e sentieri e declassa le strade di grandi dimensioni. |
Metodi | |
---|---|
getMap |
getMap() Parametri: nessuno
Valore restituito:
Map|null Restituisce la mappa su cui viene visualizzato questo livello. |
setMap |
setMap(map) Parametri:
Valore restituito:
void Esegue il rendering del livello sulla mappa specificata. Se la mappa è impostata su null , il livello verrà rimosso. |
Ereditato:
addListener ,
bindTo ,
get ,
notify ,
set ,
setValues ,
unbind ,
unbindAll
|
Interfaccia CameraOptions
google.maps.CameraOptions
interfaccia
Utilizzato per impostare le opzioni della videocamera 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
google.maps.VisibleRegion
interfaccia
Contiene i quattro punti che definiscono il poligono a quattro lati che rappresenta la regione visibile della mappa. Su una mappa vettoriale, questo poligono può essere un trapezio anziché un rettangolo, quando la mappa vettoriale è inclinata.
Proprietà | |
---|---|
farLeft |
Tipo:
LatLng |
farRight |
Tipo:
LatLng |
latLngBounds |
Tipo:
LatLngBounds Il riquadro di selezione più piccolo che include la regione visibile. |
nearLeft |
Tipo:
LatLng |
nearRight |
Tipo:
LatLng |
Costanti RenderingType
google.maps.RenderingType
costanti
Accesso chiamando il numero const {RenderingType} = await google.maps.importLibrary("maps")
.
Consulta Librerie nell'API Maps JavaScript.
Costanti | |
---|---|
RASTER |
Indica che la mappa è una mappa raster. |
UNINITIALIZED |
Indica che non è ancora noto se la mappa è vettoriale o raster, perché l'inizializzazione non è ancora terminata. |
VECTOR |
Indica che la mappa è una mappa vettoriale. |
Interfaccia MapCapabilities
google.maps.MapCapabilities
interfaccia
Oggetto contenente uno snapshot 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 ha l'autorizzazione per utilizzare queste API. Consulta le proprietà per un elenco delle funzionalità possibili.
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 i marcatori avanzati. Per maggiori informazioni, visita la pagina https://goo.gle/gmp-isAdvancedMarkersAvailable. |
isDataDrivenStylingAvailable optional |
Tipo:
boolean optional Se è vero, questa mappa è configurata correttamente per consentire l'utilizzo di stili basati sui dati per almeno un FeatureLayer. Per maggiori informazioni, visita le pagine https://goo.gle/gmp-data-driven-styling e https://goo.gle/gmp-FeatureLayerIsAvailable. |
isWebGLOverlayViewAvailable optional |
Tipo:
boolean optional Se è true, questa mappa è configurata correttamente per consentire l'utilizzo di WebGLOverlayView . |