Mappa classe
google.maps.Map
classe
Questo corso si estende
MVCObject
.
Accedi 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 Cloud Styling). |
Proprietà | |
---|---|
controls |
Tipo:
Array<MVCArray<HTMLElement>> Controlli aggiuntivi da collegare alla mappa. Per aggiungere un controllo alla mappa, aggiungi il relativo <div> a MVCArray corrispondente a ControlPosition in cui deve essere eseguito il rendering. |
data |
Tipo:
Data Un'istanza di Data , associata alla mappa. Aggiungi caratteristiche a questo oggetto Data per visualizzarle comodamente su questa mappa. |
mapTypes |
Tipo:
MapTypeRegistry Un registro di istanze MapType per ID stringa. |
overlayMapTypes |
Altri tipi di mappe 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ù elevati vengono visualizzati davanti agli overlay 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: se la mappa è impostata su display: none , la funzione fitBounds legge le dimensioni della mappa come 0x0 e pertanto non esegue alcuna azione. Per modificare l'area visibile quando la mappa è nascosta, imposta la mappa su visibility: hidden , in modo che l'elemento div della mappa abbia le dimensioni effettive. Per le mappe vettoriali, questo metodo imposta l'inclinazione e la direzione della mappa sui valori zero predefiniti. La chiamata di questo metodo potrebbe causare un'animazione fluida mentre la mappa esegue panoramiche e zoom per adattarsi ai limiti. La presenza o meno di animazioni in questo metodo dipende da un'euristica interna. |
getBounds |
getBounds() Parametri: nessuno
Valore restituito:
LatLngBounds|undefined limiti latitudine/longitudine dell'area visibile corrente.Restituisce i limiti latitudine/longitudine dell'area visibile corrente. Se è visibile più di una copia del mondo, i limiti vanno da -180 a 180 gradi (inclusi). Se la mappa non è ancora stata inizializzata o se il centro e lo zoom non sono stati impostati, il risultato è undefined . Per le mappe vettoriali con inclinazione o intestazione diversa da zero, i limiti di latitudine/longitudine restituiti rappresentano il riquadro di delimitazione più piccolo che include la regione visibile dell'area visibile della mappa. Consulta la sezione MapCanvasProjection.getVisibleRegion per ottenere l'esatta area 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. L'icona di una mappa rappresenta un punto d'interesse, chiamato anche PDI. Se il valore restituito è true , le icone sono selezionabili sulla mappa. |
|
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 lo stile basato sui dati non è disponibile (nessun ID mappa, nessun riquadro vettoriale, nessun livello degli elementi per stile basato sui dati o set di dati configurati nello stile di mappa), viene registrato un errore e il valore FeatureLayer.isAvailable risultante sarà falso. |
getDiv |
getDiv() Parametri: nessuno
Valore restituito:
HTMLElement mapDiv della mappa. |
getFeatureLayer |
getFeatureLayer(featureType) Parametri:
Valore restituito:
FeatureLayer Restituisce il valore FeatureLayer dello specifico FeatureType . È necessario attivare un FeatureLayer nella console Google Cloud. Se FeatureLayer degli elementi FeatureType specificati non esiste su questa mappa o se non sono disponibili stili basati sui dati (nessun ID mappa, riquadri vettoriali e FeatureLayer non abilitati nello stile di mappa), viene registrato un errore e il valore FeatureLayer.isAvailable risultante sarà falso. |
getHeading |
getHeading() Parametri: nessuno
Valore restituito:
number|undefined Restituisce l'orientamento della mappa. Il valore dell'orientamento viene misurato in gradi (in senso orario) dalla direzione cardinale verso nord. Se la mappa non è ancora inizializzata, il risultato è undefined . |
getHeadingInteractionEnabled |
getHeadingInteractionEnabled() Parametri: nessuno
Valore restituito:
boolean|null Indica se le interazioni con le intestazioni sono attivate. Questa opzione è attiva solo se la mappa è una mappa vettoriale. Se non viene impostata nel codice, (se disponibile) verrà utilizzata la configurazione cloud per l'ID mappa. |
getMapCapabilities |
getMapCapabilities() Parametri: nessuno
Valore restituito:
MapCapabilities Informa il chiamante sulle 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 il valore Projection corrente. Se la mappa non è ancora inizializzata, il risultato è undefined . Ascolta l'evento projection_changed e controlla il suo 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 la panoramica associata alla mappa.Restituisce il limite predefinito di StreetViewPanorama alla mappa, che può essere una panoramica predefinita incorporata nella mappa o il panorama impostato utilizzando setStreetView() . Le modifiche apportate all'elemento streetViewControl della mappa verranno applicate nella visualizzazione della panoramica associata. |
getTilt |
getTilt() Parametri: nessuno
Valore restituito:
number|undefined Restituisce l'angolo di incidenza corrente della mappa, in gradi dal piano dell'area visibile 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 informazioni dettagliate, visita la pagina setTilt . |
getTiltInteractionEnabled |
getTiltInteractionEnabled() Parametri: nessuno
Valore restituito:
boolean|null Indica se le interazioni di inclinazione sono attivate. Questa opzione è attiva solo se la mappa è una mappa vettoriale. Se non viene impostata nel codice, (se disponibile) verrà utilizzata la configurazione cloud per l'ID mappa. |
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 della 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 sia alla larghezza che all'altezza della mappa, la transizione verrà animata in modo uniforme. Tieni presente che il sistema di coordinate della mappa aumenta da ovest a est (per i valori x) e da nord a sud (per i valori y). |
panTo |
panTo(latLng) Parametri:
Valore restituito: nessuno
Modifica il centro della mappa nel valore LatLng specificato. Se la modifica è inferiore sia alla larghezza che all'altezza della mappa, la transizione verrà animata in modo uniforme. |
panToBounds |
panToBounds(latLngBounds[, padding]) Parametri:
Valore restituito: nessuno
Sposta la mappa in base alla quantità minima necessaria per contenere l'elemento LatLngBounds specificato. Non garantisce la posizione dei confini sulla mappa, ad eccezione del fatto che la mappa verrà panoramica per mostrare il maggior numero possibile di confini all'interno di {currentMapSizeInPx} - {padding} . Per le mappe raster e vettoriali, lo zoom, l'inclinazione e l'orientamento della mappa rimangono invariati. |
setCenter |
setCenter(latlng) Parametri:
Valore restituito: nessuno
|
setClickableIcons |
setClickableIcons(value) Parametri:
Valore restituito: nessuno
Consente di stabilire se è possibile fare clic sulle icone della mappa o meno. L'icona di una mappa rappresenta un punto d'interesse, chiamato anche PDI. Per disattivare la cliccabilità delle icone mappa, passa il valore 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 verso 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 attivate. Questa opzione è attiva solo se la mappa è una mappa vettoriale. Se non viene impostata nel codice, (se disponibile) verrà utilizzata la configurazione cloud per l'ID mappa. |
setMapTypeId |
setMapTypeId(mapTypeId) Parametri:
Valore restituito: nessuno
|
setOptions |
setOptions(options) Parametri:
Valore restituito: nessuno
|
setRenderingType |
setRenderingType(renderingType) Parametri:
Valore restituito: nessuno
Imposta il valore RenderingType corrente della mappa. |
setStreetView |
setStreetView(panorama) Parametri:
Valore restituito: nessuno
Associa un StreetViewPanorama alla mappa. Questa panoramica sostituisce il valore predefinito StreetViewPanorama , consentendo alla mappa di essere associata a una panoramica esterna all'esterno della mappa. Se imposti la panoramica su null , la panoramica incorporata predefinita si lega nuovamente 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 in base al livello di zoom della mappa. Per le mappe raster, consente di stabilire il comportamento di passaggio automatico in base 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 sono disponibili immagini a 45° per l'area visibile e il livello di zoom correnti, per poi tornare 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 , per 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 si riferiscono a cose diverse, non bind() la proprietà tilt ; ciò potrebbe produrre effetti imprevedibili. |
setTiltInteractionEnabled |
setTiltInteractionEnabled(tiltInteractionEnabled) Parametri:
Valore restituito: nessuno
Consente di impostare se attivare o meno le interazioni di inclinazione. Questa opzione è attiva solo se la mappa è una mappa vettoriale. Se non viene impostata nel codice, (se disponibile) verrà utilizzata la configurazione cloud per l'ID mappa. |
setZoom |
setZoom(zoom) Parametri:
Valore restituito: nessuno
Consente di impostare 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 dell'area visibile sono stati modificati. |
center_changed |
function() Argomenti:nessuno.
Questo evento viene attivato quando la proprietà Centro mappa viene modificata. |
click |
function(event) Argomenti:
Questo evento viene attivato quando l'utente fa clic sulla mappa. Viene restituito un MapMouseEvent con le proprietà della 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 ID luogo. L'evento può sempre essere trattato come un MapMouseEvent quando l'ID luogo non è importante. L'evento di clic non viene attivato se è stato fatto clic su un indicatore o su una finestra informativa. |
contextmenu |
function(event) Argomenti:
Questo evento viene attivato quando l'evento del menu contestuale 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 a volte l'evento di clic 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à 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 viene 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 viene modificata. |
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 è stato 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à zoom sulla mappa viene modificata. |
|
function(event) Argomenti:
Questo evento viene attivato quando l'utente fa clic con il tasto destro del mouse sulla mappa. |
MapOptions interfaccia
google.maps.MapOptions
interfaccia
Oggetto MapOptions utilizzato per definire le proprietà che è possibile impostare su una mappa.
Proprietà | |
---|---|
backgroundColor optional |
Tipo:
string optional Colore utilizzato per lo sfondo del tag div della mappa. Questo colore sarà visibile quando i riquadri non sono stati ancora caricati durante la panoramica dell'utente. Questa opzione può essere impostata solo quando la mappa è inizializzata. |
center optional |
Tipo:
LatLng|LatLngLiteral optional Il centro mappa iniziale. |
clickableIcons optional |
Tipo:
boolean optional Predefinita:
true Quando false , non è possibile fare clic sulle icone della mappa. L'icona di una mappa rappresenta un punto d'interesse, chiamato anche PDI. |
|
Tipo:
ColorScheme|string optional Predefinita:
ColorScheme.LIGHT La combinazione di colori iniziale della mappa. Questa opzione può essere impostata solo quando la mappa è inizializzata. |
controlSize optional |
Tipo:
number optional Dimensioni in pixel dei controlli visualizzati sulla mappa. Questo valore deve essere specificato direttamente durante la creazione della mappa. L'aggiornamento di questo valore in un secondo momento potrebbe portare i controlli a uno 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 predefiniti dell'interfaccia utente. 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 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à |
|
Tipo:
boolean optional Se false , impedisce che la mappa venga trascinata. 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 viene trascinata la mappa. 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 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 Orientamento per le immagini aeree in gradi misurati in senso orario dalla direzione cardinale verso nord. Le intestazioni sono agganciate all'angolo disponibile più vicino per cui sono disponibili le immagini. |
headingInteractionEnabled optional |
Tipo:
boolean optional Predefinita:
false Indica se la mappa deve consentire il controllo dell'utente dell'intestazione della fotocamera (rotazione). Questa opzione è attiva solo se la mappa è una mappa vettoriale. Se non viene impostata nel codice, (se disponibile) verrà utilizzata la configurazione cloud per l'ID mappa. |
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 che la mappa sia controllata dalla 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 aver creato l'istanza di una mappa. Puoi utilizzare Map.DEMO_MAP_ID per provare funzionalità che richiedono un ID mappa, ma non l'abilitazione per il 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 iniziale del controllo Tipo di mappa. |
mapTypeId optional |
Tipo:
MapTypeId|string optional Il MapTypeId iniziale. 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 mappa. |
|
Tipo:
boolean optional Lo stato attivato/disattivato del controllo Panoramica. |
|
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 l'istanza di una mappa. Se non viene impostato, la configurazione del 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 che, se necessario, riporteranno una mappa raster. |
restriction optional |
Tipo:
MapRestriction optional Definisce un confine che limita l'area della mappa accessibile agli utenti. Se questa impostazione è impostata, l'utente può eseguire panoramiche e zoom solo mentre la visualizzazione della videocamera rimane all'interno dei limiti del confine. |
rotateControl optional |
Tipo:
boolean optional Lo stato attivato/disattivato del controllo 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 della bilancia. |
scaleControlOptions optional |
Tipo:
ScaleControlOptions optional Le opzioni di visualizzazione iniziale per il controllo Scala. |
scrollwheel optional |
Tipo:
boolean optional Se false , disattiva lo zoom sulla mappa utilizzando la rotellina di scorrimento del mouse. La rotellina di scorrimento è attiva per impostazione predefinita. Nota: questa proprietà non è consigliata. Per disattivare lo zoom con la rotellina, puoi usare la proprietà |
streetView optional |
Tipo:
StreetViewPanorama optional Un StreetViewPanorama da visualizzare quando il Pegman di Street View viene inserito sulla mappa. Se non viene specificata alcuna panoramica, quando il Pegman viene rilasciato, verrà visualizzato un valore StreetViewPanorama predefinito nel riquadro div della mappa. |
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 visualizzato l'overlay stradale di Street View (ad es. un tipo di mappa non Earth). |
streetViewControlOptions optional |
Tipo:
StreetViewControlOptions optional Le opzioni di visualizzazione iniziali per il controllo Pegman di Street View. |
styles optional |
Tipo:
Array<MapTypeStyle> optional Stili da applicare a ciascuno dei tipi di mappe 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 se 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 in base al livello di zoom della mappa. Per le mappe raster, consente di stabilire il comportamento di passaggio automatico in base all'angolo di incidenza della mappa. Gli unici valori consentiti sono 0 e 45 . Il valore 0 fa sì che la mappa utilizzi sempre una vista dall'alto di 0°, indipendentemente dal livello di zoom e dall'area visibile. Il valore 45 fa sì che l'angolo di inclinazione passi automaticamente a 45 ogni volta che sono disponibili immagini a 45° per l'area visibile e il livello di zoom correnti, per poi tornare 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 , per 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 ; ciò potrebbe produrre 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 è attiva solo se la mappa è una mappa vettoriale. Se non viene impostata nel codice, (se disponibile) verrà utilizzata la configurazione cloud per l'ID mappa. |
zoom optional |
Tipo:
number optional Il livello di zoom iniziale della mappa. I valori di zoom validi sono numeri da zero fino al livello di zoom massimo supportato. Valori di zoom maggiori corrispondono a una risoluzione più elevata. |
zoomControl optional |
Tipo:
boolean optional Lo stato attivato/disattivato del controllo Zoom. |
zoomControlOptions optional |
Tipo:
ZoomControlOptions optional Le opzioni di visualizzazione per il controllo Zoom. |
MapElement classe
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>
Questo corso si estende
HTMLElement
.
Questa classe implementa
MapElementOptions
.
Accedi 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 al centro della mappa.
Attributo HTML:
|
headingInteractionDisabled |
Tipo:
boolean optional Predefinita:
false Indica se la mappa deve consentire il controllo dell'utente dell'intestazione della fotocamera (rotazione). Questa opzione è attiva solo se la mappa è una mappa vettoriale. Se non viene impostata nel codice, (se disponibile) verrà utilizzata la configurazione cloud per l'ID mappa.
Attributo HTML:
|
innerMap |
Tipo:
Map Un riferimento all'elemento Map che MapElement utilizza internamente. |
mapId |
Tipo:
string optional L'ID mappa della mappa. Questo parametro non può essere impostato o modificato dopo aver creato l'istanza di una mappa. Puoi utilizzare
Map.DEMO_MAP_ID per provare funzionalità che richiedono un ID mappa, ma non l'abilitazione per il 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 l'istanza di una mappa. Se non viene impostato, la configurazione del 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 che, se necessario, riporteranno 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 è attiva solo se la mappa è una mappa vettoriale. Se non viene impostata 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 maggiori corrispondono a una risoluzione più elevata.
Attributo HTML:
|
Metodi | |
---|---|
|
addEventListener(type, listener[, options]) Parametri:
Valore restituito:
void Imposta una funzione che verrà richiamata ogni volta che l'evento specificato viene pubblicato per la destinazione. Vedi addEventListener |
|
removeEventListener(type, listener[, options]) Parametri:
Valore restituito:
void Rimuove dal target un listener di eventi registrato in precedenza con adobe. Vedi removeEventListener |
Eventi | |
---|---|
gmp-zoomchange |
function(event) Argomenti:
Questo evento viene attivato quando la proprietà zoom sulla mappa viene modificata. |
MapElementOptions interfaccia
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 |
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 classe
google.maps.ZoomChangeEvent
classe
Questo evento viene creato dal monitoraggio della modifica dello zoom.
Questo corso si estende
Event
.
Accedi chiamando il numero const {ZoomChangeEvent} = await google.maps.importLibrary("maps")
. Consulta Librerie nell'API Maps JavaScript.
MapTypeStyle interfaccia
google.maps.MapTypeStyle
interfaccia
MapTypeStyle
è una raccolta di selettori e stili di stile che definiscono lo stile della mappa. I selettori specificano le funzionalità e/o gli elementi della mappa che devono essere interessati, mentre i selettori specificano in che modo questi elementi e caratteristiche devono essere modificati. Per maggiori dettagli, consulta la documentazione relativa allo stile.
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 sullo stile. |
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. (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 relativa allo stile. |
featureType optional |
Tipo:
string optional La funzione o il gruppo di caratteristiche a cui deve essere applicato uno stilista. (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 relativa allo stile. |
MapMouseEvent interfaccia
google.maps.MapMouseEvent
interfaccia
Questo oggetto viene restituito da vari eventi del mouse sulla mappa e in 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 sulla coerenza delle proprietà target , currentTarget , relatedTarget e path . Inoltre, gli sviluppatori non devono fare affidamento sulla struttura DOM dell'implementazione interna dell'API di Google Maps. A causa della mappatura interna degli eventi, domEvent potrebbe avere una semantica diversa da quella MapMouseEvent (ad es. un "clic" di MapMouseEvent potrebbe avere un domEvent di tipo KeyboardEvent ). |
latLng optional |
Tipo:
LatLng optional La latitudine/longitudine sotto il cursore quando si è verificato l'evento. |
Metodi | |
---|---|
stop |
stop() Parametri: nessuno
Valore restituito:
void Impedisce la propagazione ulteriore di questo evento. |
IconMouseEvent interfaccia
google.maps.IconMouseEvent
interfaccia
Questo oggetto viene inviato in un evento quando un utente fa clic su un'icona della mappa. L'ID di questo luogo è memorizzato nel membro placeId. Per evitare che venga visualizzata la 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 si estende
MapMouseEvent
.
Proprietà | |
---|---|
placeId optional |
Tipo:
string optional L'ID del luogo su cui è stato fatto clic. Questo ID luogo può essere utilizzato per richiedere ulteriori informazioni sull'elemento su cui è stato fatto clic. Scopri di più sugli ID luogo nella guida per gli sviluppatori dell'API Places. |
Ereditato:
domEvent ,
latLng
|
Metodi | |
---|---|
Ereditato:
stop
|
Schema Colori costanti
google.maps.ColorScheme
costanti
Identificatori per le combinazioni di colori delle mappe. Specificali in base al valore o utilizzando il nome della costante. Ad esempio, 'FOLLOW_SYSTEM'
o google.maps.ColorScheme.FOLLOW_SYSTEM
.
Accedi 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 la versione precedente di Maps JS. |
MapTypeId costanti
google.maps.MapTypeId
costanti
Identificatori per MapType comuni. Specificali in base al valore o utilizzando il nome della costante. Ad esempio, 'satellite'
o google.maps.MapTypeId.SATELLITE
.
Accedi chiamando il numero const {MapTypeId} = await google.maps.importLibrary("maps")
. Consulta Librerie nell'API Maps JavaScript.
Costanti | |
---|---|
HYBRID |
Questo tipo di mappa visualizza un livello trasparente delle strade principali sulle immagini satellitari. |
ROADMAP |
Questo tipo di mappa mostra una normale cartina stradale. |
SATELLITE |
Questo tipo di mappa visualizza immagini satellitari. |
TERRAIN |
Questo tipo di mappa mostra mappe con elementi fisici come terreno e vegetazione. |
MapTypeRegistry classe
google.maps.MapTypeRegistry
classe
Un registro per le istanze MapType, con chiavi basate sull'ID MapType.
Questo corso si estende
MVCObject
.
Accedi 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 personalizzate disponibili per la mappa per il suo utilizzo. Ad esempio, l'API consulta questo registro quando fornisce l'elenco dei tipi di mappe disponibili all'interno dei controlli. |
Metodi | |
---|---|
set |
set(id, mapType) Parametri:
Valore restituito: nessuno
Imposta il registro in modo da associare l'identificatore della stringa passata al MapType passato. |
Ereditato:
addListener ,
bindTo ,
get ,
notify ,
setValues ,
unbind ,
unbindAll
|
MapRestriction interfaccia
google.maps.MapRestriction
interfaccia
Una restrizione che può essere applicata alla mappa. L'area visibile della mappa non supera queste limitazioni.
Proprietà | |
---|---|
latLngBounds |
Quando questa impostazione è impostata, un utente può eseguire la panoramica e lo zoom solo all'interno dei limiti specificati. I limiti possono limitare sia la longitudine sia la latitudine oppure possono limitare solo la latitudine. Per i limiti di sola latitudine, utilizza le coordinate ovest e est rispettivamente pari a -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 la distanza a cui l'utente può diminuire lo zoom, garantendo che tutti gli elementi al di fuori dei limiti limitati rimangano nascosti. Il valore predefinito è false , il che significa che un utente può diminuire lo zoom fino a visualizzare l'intera area delimitata, includendo potenzialmente aree al di fuori di quest'ultima. |
TrafficLayer classe
google.maps.TrafficLayer
classe
Un livello di traffico.
Questo corso si estende
MVCObject
.
Accedi 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 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
|
Ereditato:
addListener ,
bindTo ,
get ,
notify ,
set ,
setValues ,
unbind ,
unbindAll
|
TrafficLayerOptions interfaccia
google.maps.TrafficLayerOptions
interfaccia
Oggetto TrafficlayerOptions utilizzato per definire le proprietà che è possibile impostare su un Trafficlayer.
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 in cui visualizzare il livello di traffico. |
TransitLayer classe
google.maps.TransitLayer
classe
Un livello di trasporto pubblico.
Questo corso si estende
MVCObject
.
Accedi 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 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. |
Ereditato:
addListener ,
bindTo ,
get ,
notify ,
set ,
setValues ,
unbind ,
unbindAll
|
BicyclingLayer classe
google.maps.BicyclingLayer
classe
Un livello che mostra corsie e percorsi ciclabili.
Questo corso si estende
MVCObject
.
Accedi chiamando il numero const {BicyclingLayer} = await google.maps.importLibrary("maps")
. Consulta Librerie nell'API Maps JavaScript.
Costruttore | |
---|---|
BicyclingLayer |
BicyclingLayer() Parametri: nessuno
Un livello che visualizza le corsie e i percorsi ciclabili e fa retrocedere le 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. |
Ereditato:
addListener ,
bindTo ,
get ,
notify ,
set ,
setValues ,
unbind ,
unbindAll
|
CameraOptions interfaccia
google.maps.CameraOptions
interfaccia
Utilizzato per impostare le opzioni di 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 |
VisibleRegion interfaccia
google.maps.VisibleRegion
interfaccia
Contiene i quattro punti che definiscono il poligono a quattro lati che rappresenta la regione visibile della mappa. In una mappa vettoriale, questo poligono può essere un trapezio anziché un rettangolo, quando una mappa vettoriale ha un'inclinazione.
Proprietà | |
---|---|
farLeft |
Tipo:
LatLng |
farRight |
Tipo:
LatLng |
latLngBounds |
Tipo:
LatLngBounds Il riquadro di delimitazione più piccolo che include la regione visibile. |
nearLeft |
Tipo:
LatLng |
nearRight |
Tipo:
LatLng |
RenderingType costanti
google.maps.RenderingType
costanti
Accedi chiamando il numero const {RenderingType} = await google.maps.importLibrary("maps")
. Consulta Librerie nell'API Maps JavaScript.
Costanti | |
---|---|
RASTER |
Indica che la mappa è raster. |
UNINITIALIZED |
Indica che non è ancora noto se la mappa è vettoriale o raster, perché l'inizializzazione della mappa non è ancora terminata. |
VECTOR |
Indica che la mappa è una mappa vettoriale. |
MapCapabilities interfaccia
google.maps.MapCapabilities
interfaccia
Oggetto contenente un'istantanea delle funzionalità attualmente disponibili per la Mappa. Tieni presente che ciò non significa necessariamente che i moduli pertinenti vengano caricati o inizializzati, ma 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 impostato su "true", la mappa è configurata correttamente per consentire l'utilizzo di indicatori avanzati. Tieni presente che devi comunque importare la libreria marker per poter usare gli indicatori avanzati. Per saperne di più, visita la pagina https://goo.gle/gmp-isAdvancedMarkersAvailable. |
isDataDrivenStylingAvailable optional |
Tipo:
boolean optional Se impostato su true, la mappa è configurata correttamente per consentire l'utilizzo dello stile basato sui dati per almeno un Featurelayer. 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 impostato su true, la mappa è configurata correttamente per consentire l'utilizzo di WebGLOverlayView . |