Classe MapElement
Classe google.maps.MapElement
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à MapElement.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>
Questa classe 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 optionalLa latitudine/longitudine centrale della mappa.
Attributo HTML:
|
headingInteractionDisabled |
Tipo:
boolean optionalValore predefinito:
falseIndica se la mappa deve consentire all'utente di controllare la direzione della fotocamera (rotazione). Questa opzione è attiva 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:
MapUn riferimento a Map utilizzato internamente da MapElement. |
internalUsageAttributionIds |
Tipo:
Iterable<string> optionalValore predefinito:
nullAggiunge un ID di attribuzione dell'utilizzo all'inizializzatore, che aiuta Google a capire quali librerie ed esempi sono utili per gli sviluppatori, ad esempio l'utilizzo di una libreria di raggruppamento di indicatori. Per disattivare l'invio dell'ID di attribuzione dell'utilizzo, puoi eliminare questa proprietà o sostituire il valore con una stringa vuota. Verranno inviati solo valori univoci. Le modifiche a questo valore dopo l'inizializzazione potrebbero essere ignorate.
Attributo HTML:
|
mapId |
Tipo:
string optionalL'ID mappa della mappa. Questo parametro non può essere impostato o modificato dopo la creazione di un'istanza di una mappa.
Map.DEMO_MAP_ID può essere utilizzato per provare funzionalità che richiedono un ID mappa, ma non l'abilitazione del cloud.Attributo HTML:
|
renderingType |
Tipo:
RenderingType optionalValore predefinito:
RenderingType.VECTORSe la mappa deve essere una mappa raster o vettoriale. Questo parametro non può essere impostato o modificato dopo la creazione di 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 che, se necessario, verrà utilizzata una mappa raster.
Attributo HTML:
|
tiltInteractionDisabled |
Tipo:
boolean optionalValore predefinito:
falseIndica se la mappa deve consentire il controllo da parte dell'utente dell'inclinazione della fotocamera. Questa opzione è attiva 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 optionalIl livello di zoom della mappa. I valori di zoom validi sono numeri compresi tra zero e il livello di zoom massimo supportato. Valori di zoom più elevati corrispondono a una risoluzione più alta.
Attributo HTML:
|
Slot | |
|---|---|
control-block-end-inline-center |
Posiziona l'elemento con slot nella posizione ControlPosition.BLOCK_END_INLINE_CENTER. |
control-block-end-inline-end |
Posiziona l'elemento con slot nella posizione ControlPosition.BLOCK_END_INLINE_END. |
control-block-end-inline-start |
Posiziona l'elemento con slot nella posizione ControlPosition.BLOCK_END_INLINE_START. |
control-block-start-inline-center |
Posiziona l'elemento con slot nella posizione ControlPosition.BLOCK_START_INLINE_CENTER. |
control-block-start-inline-end |
Posiziona l'elemento con slot nella posizione ControlPosition.BLOCK_START_INLINE_END. |
control-block-start-inline-start |
Posiziona l'elemento con slot nella posizione ControlPosition.BLOCK_START_INLINE_START. |
control-inline-end-block-center |
Posiziona l'elemento con slot nella posizione ControlPosition.INLINE_END_BLOCK_CENTER. |
control-inline-end-block-end |
Posiziona l'elemento con slot nella posizione ControlPosition.INLINE_END_BLOCK_END. |
control-inline-end-block-start |
Posiziona l'elemento con slot nella posizione ControlPosition.INLINE_END_BLOCK_START. |
control-inline-start-block-center |
Posiziona l'elemento con slot nella posizione ControlPosition.INLINE_START_BLOCK_CENTER. |
control-inline-start-block-end |
Posiziona l'elemento con slot nella posizione ControlPosition.INLINE_START_BLOCK_END. |
control-inline-start-block-start |
Posiziona l'elemento con slot nella posizione ControlPosition.INLINE_START_BLOCK_START. |
default |
Puoi creare componenti riutilizzabili attorno ai componenti web di Maps JavaScript, 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 potrebbero essere riassegnati agli slot interni di MapElement. |
Metodi | |
|---|---|
addEventListener |
addEventListener(type, listener[, options])Parametri:
Valore restituito:
voidConfigura una funzione che verrà chiamata ogni volta che l'evento specificato viene inviato alla destinazione. Consulta addEventListener. |
removeEventListener |
removeEventListener(type, listener[, options])Parametri:
Valore restituito:
voidRimuove dal target un listener di eventi precedentemente registrato con addEventListener. Consulta removeEventListener. |
Eventi | |
|---|---|
gmp-zoomchange |
function(event)Argomenti:
Questo evento viene attivato quando la proprietà di zoom della mappa cambia. |
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 optionalLeggi i MapElement.center. |
headingInteractionDisabled optional |
Tipo:
boolean optional |
internalUsageAttributionIds optional |
Tipo:
Iterable<string> optional |
mapId optional |
Tipo:
string optionalLeggi i MapElement.mapId. |
renderingType optional |
Tipo:
RenderingType optionalLeggi i MapElement.renderingType. |
tiltInteractionDisabled optional |
Tipo:
boolean optionalLeggi i MapElement.tiltInteractionDisabled. |
zoom optional |
Tipo:
number optionalLeggi i MapElement.zoom. |
Classe ZoomChangeEvent
Classe google.maps.ZoomChangeEvent
Questo evento viene creato dal monitoraggio della modifica dello zoom.
Questa classe estende
Event.
Accedi chiamando il numero const {ZoomChangeEvent} = await google.maps.importLibrary("maps").
Consulta Librerie nell'API Maps JavaScript.
Classe Map
Classe google.maps.Map
Questa classe 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 (ad esempio lo stile cloud). |
Proprietà | |
|---|---|
controls |
Tipo:
Array<MVCArray<HTMLElement>>Controlli aggiuntivi da collegare alla mappa. Per aggiungere un controllo alla mappa, aggiungi il <div> del controllo al MVCArray corrispondente alla ControlPosition in cui deve essere visualizzato. |
data |
Tipo:
DataUn'istanza di Data, associata alla mappa. Aggiungi elementi a questo oggetto Data per visualizzarli comodamente su questa mappa. |
mapTypes |
Tipo:
MapTypeRegistryUn registry di istanze MapType per ID stringa. |
overlayMapTypes |
Tipi di mappe aggiuntivi da sovrapporre. I tipi di mappa overlay verranno 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: quando la mappa è impostata su display: none, la funzione fitBounds legge le dimensioni della mappa come 0x0 e, di conseguenza, non esegue alcuna operazione. Per modificare l'area visibile mentre la mappa è nascosta, imposta la mappa su visibility: hidden, in modo da assicurarti che il div della mappa abbia una dimensione effettiva. Per le mappe vettoriali, questo metodo imposta l'inclinazione e l'orientamento della mappa sui valori predefiniti pari a zero. La chiamata a questo metodo potrebbe causare un'animazione fluida durante la panoramica e lo zoom della mappa per adattarla 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 dell'area visibile corrente. Se è visibile più di una copia del mondo, i limiti della longitudine vanno da -180 a 180 gradi inclusi. Se la mappa non è ancora inizializzata o se il centro e lo zoom non sono stati impostati, il risultato è undefined. Per le mappe vettoriali con inclinazione o direzione diversa da zero, i limiti di latitudine/longitudine restituiti rappresentano il riquadro di delimitazione più piccolo che include l'area visibile della mappa. Consulta 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|undefinedRestituisce la cliccabilità delle icone della mappa. Un'icona della mappa rappresenta un punto d'interesse, noto anche come PDI. Se il valore restituito è true, le icone sono cliccabili sulla mappa. |
|
getDatasetFeatureLayer(datasetId)Parametri:
Valore restituito:
FeatureLayerRestituisce FeatureLayer per 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, nessun tile vettoriale, nessun livello degli elementi o set di dati per lo stile basato sui dati configurato 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:
FeatureLayerRestituisce il FeatureLayer del FeatureType specifico. 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 tile vettoriale e nessun FeatureLayer attivato nello stile di mappa), viene registrato un errore e il FeatureLayer.isAvailable risultante sarà false. |
getHeading |
getHeading()Parametri: nessuno
Valore restituito:
number|undefinedRestituisce la direzione della bussola della mappa. Il valore della direzione è misurato in gradi (in senso orario) rispetto al nord cardinale. Se la mappa non è ancora inizializzata, il risultato è undefined. |
getHeadingInteractionEnabled |
getHeadingInteractionEnabled()Parametri: nessuno
Valore restituito:
boolean|nullIndica se le interazioni con le intestazioni sono attive. Questa opzione è attiva 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>|nullRestituisce l'elenco degli ID di attribuzione di utilizzo, che aiutano Google a capire quali librerie ed esempi sono utili per gli sviluppatori, ad esempio l'utilizzo di una libreria di raggruppamento di indicatori. |
getMapCapabilities |
getMapCapabilities()Parametri: nessuno
Valore restituito:
MapCapabilitiesInforma il chiamante delle funzionalità attualmente 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|undefinedRestituisce 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:
RenderingTypeRestituisce il RenderingType corrente della mappa. |
getStreetView |
getStreetView()Parametri: nessuno
Valore restituito:
StreetViewPanorama La panoramica associata alla mappa.Restituisce l'oggetto StreetViewPanorama predefinito associato alla mappa, che può essere una panoramica predefinita incorporata nella mappa o la panoramica impostata utilizzando setStreetView(). Le modifiche apportate alla streetViewControl della mappa verranno applicate alla visualizzazione di una panoramica associata. |
getTilt |
getTilt()Parametri: nessuno
Valore restituito:
number|undefinedRestituisce 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 acquisite 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|nullIndica se le interazioni di inclinazione sono attive. Questa opzione è attiva 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|undefinedRestituisce 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 di destinazione, 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 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
Sposta il centro della mappa sul 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 della quantità minima necessaria per contenere l'elemento LatLngBounds specificato. Non garantisce la posizione dei limiti sulla mappa, se non che la mappa verrà spostata 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 verranno modificati. |
setCenter |
setCenter(latlng)Parametri:
Valore restituito: nessuno
|
setClickableIcons |
setClickableIcons(value)Parametri:
Valore restituito: nessuno
Controlla se le icone della mappa sono cliccabili o meno. Un'icona della mappa rappresenta un punto d'interesse, noto anche come PDI. Per disabilitare la cliccabilità delle icone della mappa, passa un valore di false a questo metodo. |
setHeading |
setHeading(heading)Parametri:
Valore restituito: nessuno
Imposta la direzione della bussola per la mappa misurata in gradi rispetto alla direzione cardinale Nord. Per le mappe raster, questo metodo si applica solo alle immagini aeree. |
setHeadingInteractionEnabled |
setHeadingInteractionEnabled(headingInteractionEnabled)Parametri:
Valore restituito: nessuno
Imposta se le interazioni con le intestazioni sono attivate. Questa opzione è attiva 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 il RenderingType corrente della mappa. |
setStreetView |
setStreetView(panorama)Parametri:
Valore restituito: nessuno
Associa un StreetViewPanorama alla mappa. Questa panoramica sostituisce l'elemento StreetViewPanorama predefinito, consentendo alla mappa di associarsi a una panoramica esterna alla mappa. Se imposti la panoramica su null, la panoramica incorporata predefinita viene ricollegata 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, controlla il comportamento di cambio automatico per l'angolo di incidenza della mappa. Gli unici valori consentiti sono 0 e 45. setTilt(0) fa sì che la mappa utilizzi sempre una vista dall'alto di 0°, indipendentemente dal livello di zoom e dall'area visibile. setTilt(45) fa sì che l'angolo di inclinazione passi automaticamente a 45 ogni volta che sono disponibili immagini a 45° per il livello di zoom e l'area visibile correnti e torni a 0 ogni volta che non sono disponibili immagini a 45° (questo è il comportamento predefinito). Le immagini a 45° sono disponibili solo per i tipi di mappa satellite e hybrid, in alcune località e ad 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, altrimenti potresti ottenere effetti imprevedibili. |
setTiltInteractionEnabled |
setTiltInteractionEnabled(tiltInteractionEnabled)Parametri:
Valore restituito: nessuno
Imposta se le interazioni di inclinazione sono attive. Questa opzione è attiva 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. |
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 cambiano. |
center_changed |
function()Argomenti: nessuno
Questo evento viene attivato quando la proprietà del centro della mappa cambia. |
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 stata selezionata un'icona di un 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 contextmenu DOM viene attivato sul container 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 verrà attivato a volte 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 interrompe il trascinamento della mappa. Nota: dragend NON viene attivato quando l'utente interrompe la panoramica della mappa utilizzando la tastiera. Utilizza invece l'evento Map.idle per determinare quando l'utente ha interrotto la panoramica O il trascinamento della 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à heading 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 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 il valore di renderingType cambia. |
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 cambia. |
|
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 optionalColore utilizzato per lo sfondo del div della mappa. Questo colore sarà visibile quando i riquadri non sono stati ancora caricati mentre l'utente esegue la panoramica. Questa opzione può essere impostata solo quando la mappa viene inizializzata. |
cameraControl optional |
Tipo:
boolean optionalLo stato di attivazione/disattivazione del controllo della videocamera. |
cameraControlOptions optional |
Tipo:
CameraControlOptions optionalLe opzioni di visualizzazione per il controllo della videocamera. |
center optional |
Tipo:
LatLng|LatLngLiteral optionalIl centro della mappa iniziale. |
clickableIcons optional |
Tipo:
boolean optionalValore predefinito:
trueQuando 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 optionalValore predefinito:
ColorScheme.LIGHTLa combinazione di colori iniziale della mappa. Questa opzione può essere impostata solo quando la mappa viene inizializzata. |
controlSize optional |
Tipo:
number optionalDimensioni in pixel dei controlli visualizzati sulla mappa. Questo valore deve essere fornito 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 optionalAttiva/disattiva tutti i pulsanti predefiniti della UI. Può essere sostituito singolarmente. Non disattiva i controlli della tastiera, che sono controllati separatamente dall'opzione MapOptions.keyboardShortcuts. Non disattiva i controlli dei gesti, che sono controllati separatamente dall'opzione MapOptions.gestureHandling. |
disableDoubleClickZoom optional |
Tipo:
boolean optionalAttiva/disattiva lo zoom e la centratura con doppio clic. Abilitato per impostazione predefinita. Nota: questa proprietà non è consigliata. Per disattivare lo zoom con doppio clic, puoi utilizzare la proprietà |
|
Tipo:
boolean optionalSe false, impedisce il trascinamento e lo zoom della mappa tramite mouse e gesti tattili. Il trascinamento è attivo per impostazione predefinita. |
draggableCursor optional |
Tipo:
string optionalIl 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 optionalIl 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 optionalLo stato di attivazione/disattivazione del controllo Schermo intero. |
fullscreenControlOptions optional |
Tipo:
FullscreenControlOptions optionalLe opzioni di visualizzazione per il controllo a schermo intero. |
gestureHandling optional |
Tipo:
string optionalQuesta impostazione controlla il modo in cui l'API gestisce i gesti sulla mappa. Valori consentiti:
|
heading optional |
Tipo:
number optionalLa direzione delle immagini aeree in gradi misurata in senso orario dalla direzione cardinale Nord. Le intestazioni vengono agganciate all'angolo disponibile più vicino per il quale sono disponibili immagini. |
headingInteractionEnabled optional |
Tipo:
boolean optionalValore predefinito:
falseIndica se la mappa deve consentire all'utente di controllare la direzione della fotocamera (rotazione). Questa opzione è attiva 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> optionalValore predefinito:
nullAggiunge un ID di attribuzione dell'utilizzo all'inizializzatore, che aiuta Google a capire quali librerie ed esempi sono utili per gli sviluppatori, ad esempio l'utilizzo di una libreria di raggruppamento di indicatori. Per disattivare l'invio dell'ID di attribuzione dell'utilizzo, puoi eliminare questa proprietà o sostituire il valore con una stringa vuota. Verranno inviati solo valori univoci. Le modifiche a questo valore dopo l'inizializzazione potrebbero essere ignorate. |
isFractionalZoomEnabled optional |
Tipo:
boolean optionalPredefinito:
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 optionalSe false, impedisce di controllare la mappa tramite la tastiera. Le scorciatoie da tastiera sono attive per impostazione predefinita. |
mapId optional |
Tipo:
string optionalL'ID mappa della mappa. Questo parametro non può essere impostato o modificato dopo la creazione di un'istanza di una mappa. Map.DEMO_MAP_ID può essere utilizzato per provare funzionalità che richiedono un ID mappa, ma non l'abilitazione del cloud. |
mapTypeControl optional |
Tipo:
boolean optionalLo stato iniziale di attivazione/disattivazione del controllo del tipo di mappa. |
mapTypeControlOptions optional |
Tipo:
MapTypeControlOptions optionalLe opzioni di visualizzazione iniziali per il controllo Tipo di mappa. |
mapTypeId optional |
Tipo:
MapTypeId|string optionalIl mapTypeId iniziale della mappa. Il valore predefinito è ROADMAP. |
maxZoom optional |
Tipo:
number optionalIl 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 compresi tra zero e il livello di zoom massimo supportato. |
minZoom optional |
Tipo:
number optionalIl 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 compresi tra zero e il livello di zoom massimo supportato. |
noClear optional |
Tipo:
boolean optionalSe true, non cancellare i contenuti del div della mappa. |
|
Tipo:
boolean optionalLo stato di attivazione/disattivazione del controllo Panoramica. |
|
Tipo:
PanControlOptions optionalLe opzioni di visualizzazione per il controllo Panoramica. |
renderingType optional |
Tipo:
RenderingType optionalValore predefinito:
RenderingType.RASTERSe la mappa deve essere una mappa raster o vettoriale. Questo parametro non può essere impostato o modificato dopo la creazione di un'istanza di una mappa. Se non è 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 che, se necessario, verrà utilizzata una mappa raster. |
restriction optional |
Tipo:
MapRestriction optionalDefinisce un confine che limita l'area della mappa accessibile agli utenti. Se impostata, un utente può eseguire la panoramica e lo zoom solo mentre la visualizzazione della videocamera rimane entro i limiti del confine. |
rotateControl optional |
Tipo:
boolean optionalLo stato di attivazione/disattivazione del controllo di rotazione. |
rotateControlOptions optional |
Tipo:
RotateControlOptions optionalLe opzioni di visualizzazione per il controllo Ruota. |
scaleControl optional |
Tipo:
boolean optionalLo stato iniziale di attivazione/disattivazione del controllo di scalabilità. |
scaleControlOptions optional |
Tipo:
ScaleControlOptions optionalLe opzioni di visualizzazione iniziali per il controllo della scala. |
scrollwheel optional |
Tipo:
boolean optionalSe 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 utilizzando la rotellina di scorrimento, puoi utilizzare la proprietà |
streetView optional |
Tipo:
StreetViewPanorama optionalUn StreetViewPanorama da visualizzare quando Pegman di Street View viene rilasciato sulla mappa. Se non viene specificata alcuna panoramica, verrà visualizzato un valore StreetViewPanorama predefinito nel valore div della mappa quando viene rilasciato l'omino. |
streetViewControl optional |
Tipo:
boolean optionalLo stato iniziale di attivazione/disattivazione del controllo Pegman di Street View. Questo controllo fa parte della UI 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 esempio un tipo di mappa non Earth). |
streetViewControlOptions optional |
Tipo:
StreetViewControlOptions optionalLe opzioni di visualizzazione iniziali per il controllo Pegman di Street View. |
styles optional |
Tipo:
Array<MapTypeStyle> optionalStili 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 optionalPer 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, controlla il comportamento di cambio automatico dell'angolo di incidenza della mappa. Gli unici valori consentiti sono 0 e 45. Il valore 0 fa sì che la mappa utilizzi sempre una visuale dall'alto di 0°, indipendentemente dal livello di zoom e dall'area visibile. Il valore 45 fa sì che l'angolo di inclinazione passi automaticamente a 45 ogni volta che sono disponibili immagini a 45° per il livello di zoom e l'area visibile correnti e torni a 0 ogni volta che non sono disponibili immagini a 45° (questo è il comportamento predefinito). Le immagini a 45° sono disponibili solo per i tipi di mappa satellite e hybrid, in alcune località e ad alcuni 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 potresti ottenere effetti imprevedibili. |
tiltInteractionEnabled optional |
Tipo:
boolean optionalValore predefinito:
falseIndica se la mappa deve consentire il controllo da parte dell'utente dell'inclinazione della fotocamera. Questa opzione è attiva 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 optionalIl livello di zoom iniziale della mappa. I valori di zoom validi sono numeri compresi tra zero e il livello di zoom massimo supportato. Valori di zoom più elevati corrispondono a una risoluzione più alta. |
zoomControl optional |
Tipo:
boolean optionalLo stato di attivazione/disattivazione del controllo dello zoom. |
zoomControlOptions optional |
Tipo:
ZoomControlOptions optionalLe opzioni di visualizzazione per il controllo dello zoom. |
Interfaccia MapTypeStyle
Interfaccia google.maps.MapTypeStyle
MapTypeStyle è una raccolta di selettori e stili che definiscono lo stile della mappa. I selettori specificano gli elementi e/o le caratteristiche della mappa da modificare, mentre gli styler specificano come devono essere modificati. Per maggiori dettagli, consulta il riferimento allo stile.
Proprietà | |
|---|---|
stylers |
Le regole di stile da applicare agli elementi e alle caratteristiche della mappa selezionati. Le regole vengono applicate nell'ordine specificato in questo array. Per linee guida sull'utilizzo e sui valori consentiti, consulta il riferimento per gli stili. |
elementType optional |
Tipo:
string optionalL'elemento a cui deve essere applicato uno stile. Un elemento è un aspetto visivo di un elemento sulla mappa. Ad 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 per gli stili. |
featureType optional |
Tipo:
string optionalLa caratteristica o il gruppo di caratteristiche a cui applicare uno stile. Facoltativo. Se featureType non è specificato, si presume che il valore sia 'all'. Per informazioni dettagliate sull'utilizzo e sui valori consentiti, consulta il riferimento per gli 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 sulla 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 da MapMouseEvent (ad es. un "clic" MapMouseEvent potrebbe avere un domEvent di tipo KeyboardEvent). |
latLng optional |
Tipo:
LatLng optionalLa latitudine/longitudine che si trovava sotto il cursore quando si è verificato l'evento. |
Metodi | |
|---|---|
stop |
stop()Parametri: nessuno
Valore restituito:
voidImpedisce 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 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 optionalL'ID luogo 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
|
Costanti ColorScheme
Costanti
google.maps.ColorScheme
Identificatori per le combinazioni di colori delle mappe. Specifica questi valori 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, che vengono controllate una volta al momento dell'esecuzione del metodo. |
LIGHT |
La combinazione di colori chiari per una mappa. Valore predefinito per Maps JS legacy. |
Costanti MapTypeId
Costanti
google.maps.MapTypeId
Identificatori per i tipi di mappa comuni. Specifica questi valori 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 mostra un livello trasparente delle strade principali sulle immagini satellitari. |
ROADMAP |
Questo tipo di mappa mostra una normale mappa stradale. |
SATELLITE |
Questo tipo di mappa mostra immagini satellitari. |
TERRAIN |
Questo tipo di mappa mostra mappe con caratteristiche fisiche come il terreno e la vegetazione. |
Classe MapTypeRegistry
Classe google.maps.MapTypeRegistry
Un registro per le istanze MapType, con chiave basata sull'ID MapType.
Questa classe 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 mappa personalizzati disponibili per la mappa. Ad esempio, l'API consulta questo registro quando fornisce l'elenco dei tipi di mappa disponibili nei controlli. |
Metodi | |
|---|---|
set |
set(id, mapType)Parametri:
Valore restituito: nessuno
Imposta il registry per associare l'identificatore di stringa passato al MapType passato. |
Ereditato:
addListener,
bindTo,
get,
notify,
setValues,
unbind,
unbindAll
| |
Interfaccia MapRestriction
Interfaccia google.maps.MapRestriction
Una limitazione che può essere applicata alla mappa. La visualizzazione della mappa non supererà queste limitazioni.
Proprietà | |
|---|---|
latLngBounds |
Se 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 o solo la latitudine. Per i limiti di sola latitudine, utilizza le longitudini ovest ed est rispettivamente di -180 e 180, ad esempio latLngBounds: {north: northLat, south: southLat, west: -180, east: 180}. |
strictBounds optional |
Tipo:
boolean optionalI limiti possono essere resi più restrittivi impostando il flag strictBounds su true. In questo modo, l'utente non può diminuire lo zoom oltre un certo limite, assicurando che tutto ciò che si trova al di fuori dei limiti limitati rimanga nascosto. Il valore predefinito è false, il che significa che un utente può diminuire lo zoom fino a visualizzare l'intera area delimitata, incluse eventualmente le aree esterne all'area delimitata. |
Classe TrafficLayer
Classe google.maps.TrafficLayer
Un livello traffico.
Questa classe 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|nullRestituisce 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
|
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 TrafficLayer.
Proprietà | |
|---|---|
autoRefresh optional |
Tipo:
boolean optionalValore predefinito:
trueSe il livello del traffico si aggiorna automaticamente con informazioni aggiornate. |
map optional |
Tipo:
Map optionalMappa su cui visualizzare il livello del traffico. |
Classe TransitLayer
Classe google.maps.TransitLayer
Un livello di trasporto pubblico.
Questa classe 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|nullRestituisce la mappa su cui viene visualizzato questo livello. |
setMap |
setMap(map)Parametri:
Valore restituito:
voidEsegue il rendering del 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
Classe google.maps.BicyclingLayer
Un livello che mostra corsie e percorsi ciclabili.
Questa classe 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 mostra le corsie e i percorsi ciclabili e retrocede le strade principali. |
Metodi | |
|---|---|
getMap |
getMap()Parametri: nessuno
Valore restituito:
Map|nullRestituisce la mappa su cui viene visualizzato questo livello. |
setMap |
setMap(map)Parametri:
Valore restituito:
voidEsegue il rendering del 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 costituisce la regione visibile della mappa. Su una mappa vettoriale, questo poligono può essere un trapezio anziché un rettangolo, quando una mappa vettoriale è inclinata.
Proprietà | |
|---|---|
farLeft |
Tipo:
LatLng |
farRight |
Tipo:
LatLng |
latLngBounds |
Tipo:
LatLngBoundsIl riquadro di delimitazione più piccolo che include la regione visibile. |
nearLeft |
Tipo:
LatLng |
nearRight |
Tipo:
LatLng |
Costanti RenderingType
Costanti
google.maps.RenderingType
Accedi 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 della mappa non è ancora terminata. |
VECTOR |
Indica che la mappa è una mappa vettoriale. |
Interfaccia MapCapabilities
Interfaccia google.maps.MapCapabilities
Oggetto contenente uno snapshot delle funzionalità attualmente disponibili per la mappa. Tieni presente che questo 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 optionalSe true, questa mappa è configurata correttamente per consentire l'utilizzo di indicatori avanzati. Tieni presente che devi comunque importare la libreria marker per utilizzare gli indicatori avanzati. Per saperne di più, visita la pagina https://goo.gle/gmp-isAdvancedMarkersAvailable. |
isDataDrivenStylingAvailable optional |
Tipo:
boolean optionalSe true, questa 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 optionalSe true, questa mappa è configurata correttamente per consentire l'utilizzo di WebGLOverlayView. |