Maps

Classe Map

google.maps.Map classe

Questa classe estende MVCObject.

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

Metodi
fitBounds	fitBounds(bounds[, padding]) Parametri:  bounds:  LatLngBounds|LatLngBoundsLiteral limiti da mostrare. padding:  number|Padding optional spaziatura interna in pixel. I limiti verranno adattati alla parte della mappa rimanente dopo la rimozione della spaziatura interna. Un valore numerico produrrà la stessa spaziatura interna su tutti e quattro i lati. Fornisci qui 0 per creare un idempotente fitBounds 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 0 x 0 e quindi non fa nulla. Per modificare l'area visibile quando la mappa è nascosta, imposta la mappa su visibility: hidden, assicurandoti così che il div della mappa abbia una dimensione effettiva. Per le mappe vettoriali, questo metodo imposta l'inclinazione e l'orientamento della mappa sui valori zero predefiniti. Se chiami questo metodo, potresti ottenere un'animazione uniforme quando 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 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 di longitudine sono compresi tra -180 e 180 gradi inclusi. Se la mappa non è stata ancora inizializzata o non è al centro e non è stato impostato lo zoom, il risultato è undefined. Per le mappe vettoriali con un'inclinazione o un'intestazione diversa da zero, i limiti latitudine/longitudine restituiti rappresentano il riquadro di delimitazione più piccolo che include l'area visibile dell'area visibile della mappa. Consulta MapCanvasProjection.getVisibleRegion per ottenere l'esatta area visibile 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 è aggregato. 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 cliccabilità delle icone della mappa. Un'icona mappa rappresenta un punto d'interesse, chiamato anche PDI. Se il valore restituito è true, le icone sono cliccabili sulla mappa.
getDatasetFeatureLayer	getDatasetFeatureLayer(datasetId) Parametri:  datasetId:  string Valore restituito:  FeatureLayer Restituisce FeatureLayer per il valore datasetId specificato. Gli ID set di dati devono essere configurati nella console Google Cloud. Se l'ID del set di dati non è associato allo stile di mappa della mappa o se non sono disponibili stili basati sui dati (nessun ID mappa, nessun riquadro vettoriale o livelli degli elementi con stile basato sui dati o set di dati configurati nello stile della 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:  featureType:  FeatureType Valore restituito:  FeatureLayer Restituisce il FeatureLayer di un FeatureType specifico. È necessario abilitare un FeatureLayer nella console Google Cloud. Se un FeatureLayer del FeatureType specificato non esiste su questa mappa o se non sono disponibili stili basati sui dati (nessun ID mappa, nessun riquadro vettoriale e nessun FeatureLayer abilitato nello stile di mappa), viene registrato un errore e il valore FeatureLayer.isAvailable risultante sarà false.
getHeading	getHeading() Parametri: nessuno Valore restituito:  number|undefined Restituisce l'intestazione della bussola della mappa. Il valore dell'orientamento viene misurato in gradi (senso orario) dalla direzione cardinale nord. Se la mappa non è stata ancora inizializzata, il risultato è undefined.
getMapCapabilities	getMapCapabilities() Parametri: nessuno Valore restituito:  MapCapabilities Informa il chiamante delle attuali funzionalità disponibili per la mappa in base all'ID mappa fornito.
getMapTypeId	getMapTypeId() Parametri: nessuno Valore restituito:  MapTypeId|string|undefined
getProjection	getProjection() Parametri: nessuno Valore restituito:  Projection|undefined Restituisce l'attuale Projection. Se la mappa non è stata ancora inizializzata, il risultato è undefined. Ascolta l'evento projection_changed e controlla il relativo valore per assicurarti che non sia undefined.
getRenderingType	getRenderingType() Parametri: nessuno Valore restituito:  RenderingType Restituisce il RenderingType corrente della mappa.
getStreetView	getStreetView() Parametri: nessuno Valore restituito:  StreetViewPanorama il panorama associato alla mappa. Restituisce l'elemento StreetViewPanorama predefinito associato alla mappa, che può essere un panorama predefinito incorporato all'interno della mappa o il set di panorami che utilizza setStreetView(). Le modifiche apportate a streetViewControl della mappa verranno riflesse nella visualizzazione di questo panorama associato.
getTilt	getTilt() Parametri: nessuno Valore restituito:  number|undefined Restituisce l'angolo di incidenza corrente della mappa, in gradi, dal piano dell'area visibile a quello della mappa. Per le mappe raster, il risultato sarà 0 per immagini scattate direttamente sopra la testa o 45 per immagini a 45°. Questo metodo non restituisce il valore impostato da setTilt. Per informazioni dettagliate, visita la pagina setTilt.
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 videocamera 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 della distanza specificata in pixel. Se la distanza è inferiore alla larghezza e all'altezza della mappa, la transizione verrà animata in modo uniforme. Nota che il sistema di coordinate 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 centrale della mappa. Valore restituito: Nessuno Modifica il centro della mappa nel LatLng specificato. Se la modifica è inferiore alla larghezza e all'altezza della mappa, l'animazione della transizione sarà uniforme.
panToBounds	panToBounds(latLngBounds[, padding]) Parametri:  latLngBounds:  LatLngBounds|LatLngBoundsLiteral i limiti verso cui eseguire la panoramica della mappa. padding:  number|Padding optional spaziatura interna in pixel. Un valore numerico produrrà la stessa spaziatura interna su tutti e quattro i lati. Il valore predefinito è 0. Valore restituito: Nessuno Esegue la panoramica della mappa del valore minimo necessario per contenere il valore LatLngBounds specificato. Non possiamo garantire la posizione dei confini sulla mappa, tranne per il fatto che la mappa verrà eseguita con una panoramica per mostrare il maggior numero possibile di limiti all'interno di {currentMapSizeInPx} - {padding}. Per le mappe raster e vettoriali, lo zoom, l'inclinazione e l'orientamento della mappa non subiranno modifiche.
setCenter	setCenter(latlng) Parametri:  latlng:  LatLng|LatLngLiteral Valore restituito: Nessuno
setClickableIcons	setClickableIcons(value) Parametri:  value:  boolean Valore restituito: Nessuno Controlla se le icone mappa sono cliccabili o meno. Un'icona mappa rappresenta un punto d'interesse, chiamato anche PDI. Per disattivare la cliccabilità delle icone mappa, passa un valore false a questo metodo.
setHeading	setHeading(heading) Parametri:  heading:  number Valore restituito: Nessuno Imposta l'orientamento della bussola per la mappa misurata in gradi dalla direzione cardinale nord. Per le mappe raster, questo metodo si applica solo alle immagini aeree.
setMapTypeId	setMapTypeId(mapTypeId) Parametri:  mapTypeId:  MapTypeId|string Valore restituito: Nessuno
setOptions	setOptions(options) Parametri:  options:  MapOptions optional Valore restituito: Nessuno
setStreetView	setStreetView(panorama) Parametri:  panorama:  StreetViewPanorama optional il panorama da associare alla mappa. Valore restituito: Nessuno Associa StreetViewPanorama alla mappa. Questo panorama sostituisce il valore predefinito StreetViewPanorama, consentendo l'associazione della mappa a un panorama esterno esterno alla mappa. Se imposti il panorama su null, il panorama incorporato predefinito viene associato 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 a seconda del livello di zoom della mappa. Per le mappe raster, consente di controllare il comportamento di commutazione automatica per l'angolo di incidenza della mappa. Gli unici valori consentiti sono 0 e 45. setTilt(0) fa sì che la mappa utilizzi sempre una 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 e viene ripristinata a 0 quando le immagini a 45° non sono disponibili (comportamento predefinito). Le immagini a 45° sono disponibili solo per i tipi di mappa satellite e hybrid, all'interno di alcune località e con alcuni livelli di zoom. Nota: getTilt restituisce l'angolo di inclinazione corrente, non il valore impostato da setTilt. Poiché getTilt e setTilt fanno riferimento a cose diverse, non bind() la proprietà tilt; in questo modo potresti avere effetti imprevedibili.
setZoom	setZoom(zoom) Parametri:  zoom:  number valori di zoom più grandi corrispondono a una risoluzione più elevata. Valore restituito: Nessuno Imposta lo zoom della mappa.
Ereditato: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

Interfaccia di MapOptions

Interfaccia google.maps.MapOptions

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

Classe MapElement

google.maps.MapElement classe

MapElement è una sottoclasse HTMLElement per il rendering delle mappe. Dopo aver caricato la libreria maps, è possibile creare una mappa in HTML. Ad esempio:

<gmp-map center="37.4220656,-122.0840897" zoom="10" map-id="DEMO_MAP_ID">
  <button slot="control-block-start-inline-end">Custom Control</button>
</gmp-map>

Elemento personalizzato:
<gmp-map center="lat,lng" map-id="string" 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 rimanere in ascolto. listener:  EventListener|EventListenerObject l'oggetto che riceve una notifica. Deve essere una funzione o un oggetto con il metodo handleEvent options:  boolean|AddEventListenerOptions optional Vedi le opzioni. Gli eventi personalizzati supportano solo capture e passive. Valore restituito:  void Configura una funzione che verrà richiamata ogni volta che l'evento specificato viene pubblicato nella destinazione. Consulta la funzione addEventListener
removeEventListener	removeEventListener(type, listener[, options]) Parametri:  type:  string una stringa che specifica il tipo di evento per il quale rimuovere un listener di eventi. listener:  EventListener|EventListenerObject il listener di eventi del gestore di eventi da rimuovere dalla destinazione dell'evento. options:  boolean|EventListenerOptions optional Vedi le opzioni Valore restituito:  void Rimuove dalla destinazione un listener di eventi precedentemente registrato con hreflang. Vedi removeEventListener

Interfaccia di MapElementOptions

Interfaccia google.maps.MapElementOptions

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

Classe ZoomChangeEvent

google.maps.ZoomChangeEvent classe

Questo evento viene creato dal monitoraggio della variazione dello zoom.

Questa classe estende Event.

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

Interfaccia MapTypeStyle

Interfaccia google.maps.MapTypeStyle

MapTypeStyle è una raccolta di selettori e stili di stile che definiscono lo stile da applicare alla mappa. I selettori specificano le funzionalità della mappa e/o gli elementi che devono essere interessati, mentre gli stili di stili specificano le modalità di modifica degli elementi e degli elementi. Per maggiori dettagli, consulta la documentazione di riferimento sugli stili.

Interfaccia MapMouseEvent

Interfaccia google.maps.MapMouseEvent

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

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 evitare che venga propagato. 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 MapTypes più comuni. Specificali tramite un 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.

MapTypeRegistry

google.maps.MapTypeRegistry classe

Un registro per le istanze MapType, chiavi in base all'ID MapType.

Questa classe estende MVCObject.

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

Interfaccia MapRestriction

Interfaccia google.maps.MapRestriction

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

Classe TrafficLayer

google.maps.TrafficLayer classe

Un livello di traffico.

Questa classe estende MVCObject.

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

Interfaccia di TrafficLayerOptions

Interfaccia google.maps.TrafficLayerOptions

Oggetto TrafficlayerOptions utilizzato per definire le proprietà che possono essere impostate su un Trafficstrato.

Classe TransitLayer

google.maps.TransitLayer classe

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 classe

Un livello che mostra le piste ciclabili e i percorsi.

Questa classe estende MVCObject.

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

Interfaccia di CameraOptions

Interfaccia google.maps.CameraOptions

Utilizzato per impostare le opzioni della fotocamera della mappa.

Interfaccia di VisibleRegion

Interfaccia google.maps.VisibleRegion

Contiene i quattro punti che definiscono il poligono a quattro lati che è l'area visibile della mappa. In una mappa vettoriale, questo poligono può essere un trapezio invece di un rettangolo, se una 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.

MapCapabilities interfaccia

Interfaccia google.maps.MapCapabilities

Oggetto contenente un'istantanea delle funzionalità attualmente disponibili per la mappa. Tieni presente che ciò non significa necessariamente che i moduli pertinenti siano caricati o inizializzati, ma piuttosto che la mappa corrente disponga dell'autorizzazione per utilizzare queste API. Consulta le proprietà per un elenco delle possibili funzionalità.