Maps

Map class

google.maps.Map corso

Questa classe estende MVCObject.

Accedi chiamando const {Map} = await google.maps.importLibrary("maps"). Consulta la sezione Librerie nell'API Maps JavaScript.

Metodi
fitBounds	fitBounds(bounds[, padding]) Parametri:  bounds:  LatLngBounds|LatLngBoundsLiteral Confini da mostrare. padding:  number|Padding optional spaziatura in pixel. I limiti verranno adattati alla parte della mappa che rimane dopo la rimozione del padding. Un valore numerico genera la stessa spaziatura su tutti e quattro i lati. Specifica 0 qui per rendere fitBounds idempotente sul risultato di getBounds. 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 quindi non fa nulla. Per modificare l'area visibile quando la mappa è nascosta, impostala su visibility: hidden, in modo da garantire 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 di zero. La chiamata di questo metodo può causare un'animazione fluida mentre la mappa esegue la panoramica e lo zoom per adattarsi ai limiti. L'animazione di questo metodo dipende da un'euristica interna.
getBounds	getBounds() Parametri: nessuno Valore restituito:LatLngBounds|undefined i limiti lat/lng dell'area visibile corrente. Restituisce i limiti lat/lng del viewport corrente. Se è visibile più di una copia del mondo, l'intervallo di longitudine dei limiti va da -180 a 180 gradi inclusi. Se la mappa non è ancora stata inizializzata o se non sono stati impostati il centro e lo zoom, il risultato è undefined. Per le mappe vettoriali con inclinazione o rotta non pari a zero, i limiti lat/lng restituiti rappresentano la scatola delimitante più piccola che include la regione visibile dell'area visibile della mappa. Consulta MapCanvasProjection.getVisibleRegion per ottenere la regione visibile esatta dell'area visibile della mappa.
getCenter	getCenter() Parametri: nessuno Valore restituito:LatLng|undefined Restituisce la posizione visualizzata al centro della mappa. Tieni presente che questo oggetto LatLng non è racchiuso tra parentesi graffe. Consulta la pagina LatLng per saperne di più. Se il centro o i limiti non sono stati impostati, il risultato è 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 cliccabili sulla mappa.
getDatasetFeatureLayer	getDatasetFeatureLayer(datasetId) Parametri:  datasetId:  string 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 della mappa o se lo stile basato sui dati non è disponibile (nessun ID mappa, nessun tile vettoriale, nessun livello grafico o set di dati basato sui dati configurato nello stile della mappa), viene registrato un errore e il valore FeatureLayer.isAvailable risultante sarà falso.
getDiv	getDiv() Parametri: nessuno Valore restituito:  HTMLElement Il mapDiv della mappa.
getFeatureLayer	getFeatureLayer(featureType) Parametri:  featureType:  FeatureType Valore restituito:FeatureLayer Restituisce il FeatureLayer del FeatureType specifico. È necessario attivare un FeatureLayer nella console Google Cloud. Se un FeatureLayer del FeatureType specificato non esiste in questa mappa o se lo stile basato sui dati non è disponibile (nessun ID mappa, nessun tile vettoriale e nessun FeatureLayer abilitato nello stile della mappa), viene registrato un errore e il FeatureLayer.isAvailable risultante sarà falso.
getHeading	getHeading() Parametri: nessuno Valore restituito:number|undefined Restituisce la direzione magnetica della mappa. Il valore della direzione viene misurato in gradi (in senso orario) dalla direzione cardinale Nord. Se la mappa non è ancora stata inizializzata, il risultato è undefined.
getHeadingInteractionEnabled	getHeadingInteractionEnabled() Parametri: nessuno Valore restituito:boolean|null Restituisce se le interazioni con le intestazioni sono attivate. Questa opzione è valida solo se la mappa è una mappa vettoriale. Se non impostato nel codice, verrà utilizzata la configurazione cloud per l'ID mappa (se disponibile).
getMapCapabilities	getMapCapabilities() Parametri: nessuno Valore restituito:MapCapabilities Informa l'utente chiamante delle funzionalità correnti disponibili per la mappa in base all'ID mappa fornito.
getMapTypeId	getMapTypeId() Parametri: nessuno Valore restituito:MapTypeId|string|undefined
getProjection	getProjection() Parametri: nessuno Valore restituito:Projection|undefined Restituisce il Projection corrente. Se la mappa non è ancora stata 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 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 a streetViewControl della mappa verranno applicate alla 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 dell'area visibile al piano della mappa. Per le mappe raster, il risultato sarà 0 per le immagini scattate direttamente sopra o 45 per le immagini a 45°. Questo metodo non restituisce il valore impostato da setTilt. Per maggiori dettagli, visita la pagina setTilt.
getTiltInteractionEnabled	getTiltInteractionEnabled() Parametri: nessuno Valore restituito:boolean|null Restituisce se le interazioni con l'inclinazione sono attivate. Questa opzione è valida solo se 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 lo zoom della mappa. Se lo zoom non è stato impostato, il risultato è undefined.
moveCamera	moveCamera(cameraOptions) Parametri:  cameraOptions:  CameraOptions Valore restituito:nessuno Imposta immediatamente la fotocamera della mappa sulle opzioni della fotocamera target, senza animazione.
panBy	panBy(x, y) Parametri:  x:  number Numero di pixel per spostare la mappa nella direzione x. y:  number Numero di pixel per spostare la mappa nella direzione Y. Valore restituito:nessuno Modifica il centro della mappa in base alla distanza specificata in pixel. Se la distanza è inferiore alla larghezza e all'altezza della mappa, la transizione 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:  latLng:  LatLng|LatLngLiteral la nuova latitudine/longitudine del centro della mappa. Valore restituito:nessuno Modifica il centro della mappa in base al LatLng specificato. Se la variazione è inferiore sia alla larghezza sia all'altezza della mappa, la transizione sarà animata in modo fluido.
panToBounds	panToBounds(latLngBounds[, padding]) Parametri:  latLngBounds:  LatLngBounds|LatLngBoundsLiteral i limiti fino ai quali eseguire la panoramica della mappa. padding:  number|Padding optional spaziatura in pixel. Un valore numerico genera la stessa spaziatura su tutti e quattro i lati. Il valore predefinito è 0. Valore restituito:nessuno Esegue la panoramica della mappa per l'importo minimo necessario per contenere il LatLngBounds specificato. Non è garantito dove si troveranno i limiti sulla mappa, tranne per il fatto che la mappa verrà spostata in modo da mostrare il maggior numero possibile di limiti all'interno di {currentMapSizeInPx} - {padding}. Sia per le mappe raster che per quelle vettoriali, lo zoom, l'inclinazione e l'orientamento della mappa non verranno modificati.
setCenter	setCenter(latlng) Parametri:  latlng:  LatLng|LatLngLiteral Valore restituito:nessuno
setClickableIcons	setClickableIcons(value) Parametri:  value:  boolean 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 disattivare la possibilità di fare clic sulle icone della mappa, passa un valore di false a questo metodo.
setHeading	setHeading(heading) Parametri:  heading:  number Valore restituito:nessuno Imposta la direzione della bussola per la mappa misurata in gradi dalla direzione cardinale Nord. Per le mappe raster, questo metodo si applica solo alle immagini aeree.
setHeadingInteractionEnabled	setHeadingInteractionEnabled(headingInteractionEnabled) Parametri:  headingInteractionEnabled:  boolean Valore restituito:nessuno Imposta se le interazioni con le intestazioni sono attivate. Questa opzione è valida solo se 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:  mapTypeId:  MapTypeId|string Valore restituito:nessuno
setOptions	setOptions(options) Parametri:  options:  MapOptions optional Valore restituito:nessuno
setRenderingType	setRenderingType(renderingType) Parametri:  renderingType:  RenderingType Valore restituito:nessuno Imposta il RenderingType corrente della mappa.
setStreetView	setStreetView(panorama) Parametri:  panorama:  StreetViewPanorama optional la panoramica da associare alla mappa. Valore restituito:nessuno Collega un StreetViewPanorama alla mappa. Questo panorama sostituisce StreetViewPanorama predefinito, consentendo alla mappa di associarsi a un panorama esterno esterno alla mappa. Se imposti il panorama su null, il panorama incorporato predefinito viene ricollegato alla mappa.
setTilt	setTilt(tilt) Parametri:  tilt:  number 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 commutazione automatica per l'angolo di incidenza della mappa. Gli unici valori consentiti sono 0 e 45. setTilt(0) fa in modo che la mappa utilizzi sempre una vista dall'alto a 0°, indipendentemente dal livello di zoom e dall'area visibile. setTilt(45) fa in modo 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 quando 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, in quanto ciò potrebbe produrre effetti imprevedibili.
setTiltInteractionEnabled	setTiltInteractionEnabled(tiltInteractionEnabled) Parametri:  tiltInteractionEnabled:  boolean Valore restituito:nessuno Imposta se le interazioni con l'inclinazione sono attivate. Questa opzione è valida solo se 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:  zoom:  number i valori di zoom più elevati corrispondono a una risoluzione più alta. Valore restituito:nessuno Imposta lo zoom della mappa.
Ereditato: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

Interfaccia MapOptions

google.maps.MapOptions interfaccia

Oggetto MapOptions utilizzato per definire le proprietà che possono essere impostate su una mappa.

Classe MapElement

google.maps.MapElement corso

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>

Elemento personalizzato:
<gmp-map center="lat,lng" heading-interaction-disabled map-id="string" rendering-type="vector" tilt-interaction-disabled zoom="number"></gmp-map>

Questa classe estende HTMLElement.

Questa classe implementa MapElementOptions.

Accedi chiamando const {MapElement} = await google.maps.importLibrary("maps"). Consulta la sezione Librerie nell'API Maps JavaScript.

Metodi
addEventListener	addEventListener(type, listener[, options]) Parametri:  type:  string una stringa sensibile alle maiuscole che rappresenta il tipo di evento da ascoltare. listener:  EventListener|EventListenerObject l'oggetto che riceve una notifica. Deve essere una funzione o un oggetto con il metodo handleEvent options:  boolean|AddEventListenerOptions optional consulta le opzioni. Gli eventi personalizzati supportano solo capture e passive. Valore restituito:void Configura una funzione che verrà chiamata ogni volta che l'evento specificato viene inviato al target. Vedi addEventListener
removeEventListener	removeEventListener(type, listener[, options]) Parametri:  type:  string una stringa che specifica il tipo di evento per cui rimuovere un gestore di eventi. listener:  EventListener|EventListenerObject Il listener di eventi dell'handler dell'evento da rimuovere dal target dell'evento. options:  boolean|EventListenerOptions optional consulta le opzioni Valore restituito:void Rimuove dal target un gestore di eventi precedentemente registrato con addEventListener. Vedi removeEventListener

Interfaccia MapElementOptions

google.maps.MapElementOptions interfaccia

Oggetto MapElementOptions utilizzato per definire le proprietà che possono essere impostate su un elemento mappa.

Classe ZoomChangeEvent

google.maps.ZoomChangeEvent corso

Questo evento viene creato dal monitoraggio della modifica dello zoom.

Questa classe estende Event.

Accedi chiamando const {ZoomChangeEvent} = await google.maps.importLibrary("maps"). Consulta la sezione Librerie nell'API Maps JavaScript.

Interfaccia MapTypeStyle

google.maps.MapTypeStyle interfaccia

MapTypeStyle è una raccolta di selettori e stili che definiscono lo stile della mappa. I selettori specificano gli elementi e/o gli elementi della mappa che devono essere interessati e gli stili specificano come devono essere modificati. Per maggiori dettagli, consulta il riferimento allo stile.

Interfaccia MapMouseEvent

google.maps.MapMouseEvent interfaccia

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

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 di informazioni 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.

Costanti MapTypeId

google.maps.MapTypeId costanti

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

Accedi chiamando const {MapTypeId} = await google.maps.importLibrary("maps"). Consulta la sezione Librerie nell'API Maps JavaScript.

Classe MapTypeRegistry

google.maps.MapTypeRegistry corso

Un registry per le istanze di MapType, con chiave ID MapType.

Questa classe estende MVCObject.

Accedi chiamando const {MapTypeRegistry} = await google.maps.importLibrary("maps"). Consulta la sezione Librerie nell'API Maps JavaScript.

Interfaccia MapRestriction

google.maps.MapRestriction interfaccia

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

Classe TrafficLayer

google.maps.TrafficLayer corso

Un livello di traffico.

Questa classe estende MVCObject.

Accedi chiamando const {TrafficLayer} = await google.maps.importLibrary("maps"). Consulta la sezione Librerie nell'API Maps JavaScript.

Interfaccia TrafficLayerOptions

google.maps.TrafficLayerOptions interfaccia

Oggetto TrafficLayerOptions utilizzato per definire le proprietà che possono essere impostate su un TrafficLayer.

Classe TransitLayer

google.maps.TransitLayer corso

Un livello di trasporto pubblico.

Questa classe estende MVCObject.

Accedi chiamando const {TransitLayer} = await google.maps.importLibrary("maps"). Consulta la sezione Librerie nell'API Maps JavaScript.

Classe BicyclingLayer

google.maps.BicyclingLayer corso

Un livello che mostra corsie e percorsi ciclabili.

Questa classe estende MVCObject.

Accedi chiamando const {BicyclingLayer} = await google.maps.importLibrary("maps"). Consulta la sezione Librerie nell'API Maps JavaScript.

Interfaccia CameraOptions

google.maps.CameraOptions interfaccia

Utilizzato per impostare le opzioni della fotocamera della mappa.

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, se la mappa vettoriale è inclinata.

Costanti RenderingType

google.maps.RenderingType costanti

Accedi chiamando const {RenderingType} = await google.maps.importLibrary("maps"). Consulta la sezione Librerie nell'API Maps JavaScript.

Interfaccia MapCapabilities

google.maps.MapCapabilities interfaccia

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 abbia l'autorizzazione a utilizzare queste API. Consulta le proprietà per un elenco delle possibili funzionalità.