Maps

Classe MapElement

class google.maps.MapElement extends HTMLElement implements MapElementOptions
library "maps"

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>

<gmp-map
  center="lat,lng"
  heading-interaction-disabled
  internal-usage-attribution-ids="id1 id2"
  map-id="string"
  rendering-type="value-name"
  tilt-interaction-disabled
  zoom="number">
</gmp-map>

const {MapElement} = await google.maps.importLibrary("maps");

Interfaccia MapElementOptions

interfaccia google.maps.MapElementOptions
implementata da MapElement

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

Classe ZoomChangeEvent

class google.maps.ZoomChangeEvent extends Event
library "maps"

Questo evento viene creato dal monitoraggio della modifica dello zoom.

const {ZoomChangeEvent} = await google.maps.importLibrary("maps");

Classe Map

class google.maps.Map extends MVCObject
library "maps"

const {Map} = await google.maps.importLibrary("maps");

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 che rimane dopo la rimozione del padding. Un valore numerico produrrà lo stesso padding su tutti e quattro i lati. Specifica 0 qui per rendere un 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, 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 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 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 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: featureType: FeatureType Valore restituito: FeatureLayer Restituisce 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|undefined Restituisce 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|null Indica 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>|null Restituisce 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: MapCapabilities Informa 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|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 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|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 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|null Indica 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|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 di destinazione, senza animazione.
panBy	panBy(x, y) Parametri: x: number Numero di pixel di cui spostare la mappa nella direzione x. y: number Numero di pixel di cui 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 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: latLng: LatLng|LatLngLiteral La nuova latitudine/longitudine centrale della mappa. 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: latLngBounds: LatLngBounds|LatLngBoundsLiteral I limiti della mappa su cui eseguire la panoramica. padding: number|Padding optional Spaziatura interna in pixel. Un valore numerico produrrà lo stesso padding su tutti e quattro i lati. Il valore predefinito è 0. 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: 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 disabilitare la cliccabilità delle 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 rispetto alla 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 è 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: 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 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: 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 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: tiltInteractionEnabled: boolean 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: zoom: number Valori di zoom più elevati corrispondono a una risoluzione più alta. Valore restituito: nessuno Imposta lo zoom della mappa.
Ereditate: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

Interfaccia MapOptions

interfaccia google.maps.MapOptions

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

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.

Interfaccia MapMouseEvent

interface google.maps.MapMouseEvent
extended by Data.MouseEvent, FeatureMouseEvent, IconMouseEvent, PolyMouseEvent

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

Interfaccia IconMouseEvent

interface google.maps.IconMouseEvent extends MapMouseEvent

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.

Costanti ColorScheme

constants google.maps.ColorScheme
library "core"

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.

Queste costanti sono utilizzabili anche come stringhe. In TypeScript, i valori letterali stringa sono definiti dal tipo ColorSchemeString.

const {ColorScheme} = await google.maps.importLibrary("core");

Costanti MapTypeId

constants google.maps.MapTypeId
library "maps"

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.

Queste costanti sono utilizzabili anche come stringhe. In TypeScript, i valori letterali stringa sono definiti dal tipo MapTypeIdString.

const {MapTypeId} = await google.maps.importLibrary("maps");

Classe MapTypeRegistry

class google.maps.MapTypeRegistry extends MVCObject
library "maps"

Un registro per le istanze MapType, con chiave basata sull'ID MapType.

const {MapTypeRegistry} = await google.maps.importLibrary("maps");

Interfaccia MapRestriction

interfaccia google.maps.MapRestriction

Una limitazione che può essere applicata alla mappa. La visualizzazione della mappa non supererà queste limitazioni.

Classe TrafficLayer

class google.maps.TrafficLayer extends MVCObject
library "maps"

Un livello traffico.

const {TrafficLayer} = await google.maps.importLibrary("maps");

Interfaccia TrafficLayerOptions

interfaccia google.maps.TrafficLayerOptions

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

Classe TransitLayer

class google.maps.TransitLayer extends MVCObject
library "maps"

Un livello di trasporto pubblico.

const {TransitLayer} = await google.maps.importLibrary("maps");

Classe BicyclingLayer

class google.maps.BicyclingLayer extends MVCObject
library "maps"

Un livello che mostra corsie e percorsi ciclabili.

const {BicyclingLayer} = await google.maps.importLibrary("maps");

Interfaccia CameraOptions

interface google.maps.CameraOptions
extended by CameraParams

Utilizzato per impostare le opzioni della fotocamera della mappa.

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.

Costanti RenderingType

constants google.maps.RenderingType
library "maps"

Queste costanti sono utilizzabili anche come stringhe. In TypeScript, i valori letterali stringa sono definiti dal tipo RenderingTypeString.

const {RenderingType} = await google.maps.importLibrary("maps");

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.