Coordinates

Classe LatLng

google.maps.LatLng classe

Un LatLng è un punto in coordinate geografiche: latitudine e longitudine.

• La latitudine è compresa tra -90 e 90 gradi inclusi. I valori superiori o inferiori a questo intervallo verranno bloccati nell'intervallo [-90, 90]. Ciò significa che se il valore specificato è inferiore a -90, verrà impostato su -90. Se il valore è maggiore di 90, verrà impostato su 90.
• La longitudine è compresa tra -180 e 180 gradi inclusi. I valori superiori o inferiori a questo intervallo verranno inclusi in modo che rientrino nell'intervallo. Ad esempio, un valore di -190 verrà convertito in 170. Un valore di 190 verrà convertito in -170. Ciò riflette il fatto che le longitudini avvolgono il globo.

Anche se la proiezione cartografica predefinita associa la longitudine alla coordinata X della mappa e la latitudine alla coordinata Y, la coordinata di latitudine viene sempre scritta prima, seguita dalla longitudine.
Tieni presente che non puoi modificare le coordinate di un LatLng. Se vuoi calcolare un altro punto, devi crearne uno nuovo.

La maggior parte dei metodi che accettano oggetti LatLng accettano anche un oggetto LatLngLiteral, pertanto le seguenti istruzioni sono equivalenti:

 map.setCenter(new google.maps.LatLng(-34, 151));
 map.setCenter({lat: -34, lng: 151}); 

Il costruttore accetta anche gli oggetti LatLngLiteral e LatLng. Se viene passata un'istanza di LatLng al costruttore, viene creata una copia.

Di seguito sono riportate le possibili chiamate al costruttore:

 new google.maps.LatLng(-34, 151);
 new google.maps.LatLng(-34, 151, true);
 new google.maps.LatLng({lat: -34, lng: 151});
 new google.maps.LatLng({lat: -34, lng: 151}, true);
 new google.maps.LatLng(new google.maps.LatLng(-34, 151));
 new google.maps.LatLng(new google.maps.LatLng(-34, 151), true);
 

Accesso chiamando il numero const {LatLng} = await google.maps.importLibrary("core").
Consulta Librerie nell'API Maps JavaScript.

Costruttore

LatLng

LatLng(latOrLatLngOrLatLngLiteral[, lngOrNoClampNoWrap, noClampNoWrap]) Parametri:  latOrLatLngOrLatLngLiteral:  number|LatLngLiteral|LatLng lngOrNoClampNoWrap:  number|boolean optional noClampNoWrap:  boolean optional Crea un oggetto LatLng che rappresenta un punto geografico. La latitudine è specificata in gradi nell'intervallo [-90, 90]. La longitudine è specificata in gradi nell'intervallo [-180, 180). Imposta noClampNoWrap su true per attivare i valori al di fuori di questo intervallo. Prendi nota dell'ordine di latitudine e longitudine.

Metodi
equals	equals(other) Parametri:  other:  LatLng Valore restituito:  boolean Funzione di confronto.
lat	lat() Parametri: nessuno Valore restituito:  number Restituisce la latitudine in gradi.
lng	lng() Parametri: nessuno Valore restituito:  number Restituisce la longitudine in gradi.
toJSON	toJSON() Parametri: nessuno Valore restituito:  LatLngLiteral Esegue la conversione nella rappresentazione JSON. Questa funzione è pensata per essere utilizzata tramite JSON.stringify.
toString	toString() Parametri: nessuno Valore restituito:  string Converte in rappresentazione di stringa.
toUrlValue	toUrlValue([precision]) Parametri:  precision:  number optional Valore restituito:  string Restituisce una stringa nel formato "lat,lng" per questo LatLng. Per impostazione predefinita, arrotondiamo i valori di latitudine/longitudine a 6 cifre decimali.

LatLngLiteral interfaccia

google.maps.LatLngLiteral interfaccia

I valori letterali degli oggetti vengono accettati al posto degli oggetti LatLng, per comodità, in molti punti. Questi vengono convertiti in oggetti LatLng quando l'API Maps li rileva.

Esempi:

 map.setCenter({lat: -34, lng: 151});
 new google.maps.Marker({position: {lat: -34, lng: 151}, map: map}); 

I valori letterali dell'oggetto LatLng non sono supportati nella libreria Geometry.

Proprietà
lat	Tipo:  number Latitudine in gradi. I valori verranno limitati all'intervallo [-90, 90]. Ciò significa che se il valore specificato è inferiore a -90, verrà impostato su -90. Se il valore è maggiore di 90, verrà impostato su 90.
lng	Tipo:  number Longitudine in gradi. I valori al di fuori dell'intervallo [-180, 180] verranno adattati in modo che rientrino nell'intervallo. Ad esempio, un valore di -190 verrà convertito in 170. Un valore di 190 verrà convertito in -170. Ciò riflette il fatto che le longitudini avvolgono il globo.

Classe LatLngBounds

google.maps.LatLngBounds classe

Un'istanza LatLngBounds rappresenta un rettangolo in coordinate geografiche, incluso uno che attraversa il meridiano longitudinale di 180 gradi.

Accesso chiamando il numero const {LatLngBounds} = await google.maps.importLibrary("core").
Consulta Librerie nell'API Maps JavaScript.

Costruttore
LatLngBounds	LatLngBounds([swOrLatLngBounds, ne]) Parametri:  swOrLatLngBounds:  LatLng|LatLngLiteral|LatLngBounds|LatLngBoundsLiteral optional ne:  LatLng|LatLngLiteral optional Costruisce un rettangolo a partire dai punti negli angoli sud-ovest e nord-est.

Costanti
MAX_BOUNDS	LatLngBounds per i limiti massimi della Terra. Questi limiti comprenderanno l'intero globo.

Metodi
contains	contains(latLng) Parametri:  latLng:  LatLng|LatLngLiteral Valore restituito:  boolean Restituisce true se la latitudine/longitudine specificata rientra in questi limiti.
equals	equals(other) Parametri:  other:  LatLngBounds|LatLngBoundsLiteral optional Valore restituito:  boolean Restituisce true se questi limiti sono approssimativamente uguali ai limiti specificati.
extend	extend(point) Parametri:  point:  LatLng|LatLngLiteral Valore restituito:  LatLngBounds Estende questi limiti in modo che contengano il punto specificato.
getCenter	getCenter() Parametri: nessuno Valore restituito:  LatLng Calcola il centro di questo LatLngBounds
getNorthEast	getNorthEast() Parametri: nessuno Valore restituito:  LatLng Restituisce l'angolo nord-est di questi limiti.
getSouthWest	getSouthWest() Parametri: nessuno Valore restituito:  LatLng Restituisce l'angolo sud-ovest di questi limiti.
intersects	intersects(other) Parametri:  other:  LatLngBounds|LatLngBoundsLiteral Valore restituito:  boolean Restituisce true se questo limite condivide punti con l'altro limite.
isEmpty	isEmpty() Parametri: nessuno Valore restituito:  boolean Restituisce se i limiti sono vuoti.
toJSON	toJSON() Parametri: nessuno Valore restituito:  LatLngBoundsLiteral Esegue la conversione nella rappresentazione JSON. Questa funzione è pensata per essere utilizzata tramite JSON.stringify.
toSpan	toSpan() Parametri: nessuno Valore restituito:  LatLng Converte i limiti della mappa specificati in un intervallo di latitudine/longitudine.
toString	toString() Parametri: nessuno Valore restituito:  string Converte in stringa.
toUrlValue	toUrlValue([precision]) Parametri:  precision:  number optional Valore restituito:  string Restituisce una stringa nel formato "lat_lo,lng_lo,lat_hi,lng_hi" per questi limiti, dove "lo" corrisponde all'angolo sud-ovest del riquadro di delimitazione, mentre "hi" corrisponde all'angolo nord-est del riquadro.
union	union(other) Parametri:  other:  LatLngBounds|LatLngBoundsLiteral Valore restituito:  LatLngBounds Estende questi limiti in modo da contenere l'unione di questi e dei limiti specificati.

Interfaccia LatLngBoundsLiteral

google.maps.LatLngBoundsLiteral interfaccia

I valori letterali degli oggetti vengono accettati al posto degli oggetti LatLngBounds in tutta l'API. Questi vengono convertiti automaticamente in oggetti LatLngBounds. Tutti i valori south, west, north e east devono essere impostati, altrimenti viene generata un'eccezione.

Proprietà
east	Tipo:  number Longitudine est in gradi. I valori al di fuori dell'intervallo [-180, 180] verranno riportati all'intervallo [-180, 180). Ad esempio, un valore di -190 verrà convertito in 170. Un valore di 190 verrà convertito in -170. Ciò riflette il fatto che le longitudini avvolgono il globo.
north	Tipo:  number Latitudine nord in gradi. I valori verranno limitati all'intervallo [-90, 90]. Ciò significa che se il valore specificato è inferiore a -90, verrà impostato su -90. Se il valore è maggiore di 90, verrà impostato su 90.
south	Tipo:  number Latitudine sud in gradi. I valori verranno limitati all'intervallo [-90, 90]. Ciò significa che se il valore specificato è inferiore a -90, verrà impostato su -90. Se il valore è maggiore di 90, verrà impostato su 90.
west	Tipo:  number Longitudine ovest in gradi. I valori al di fuori dell'intervallo [-180, 180] verranno riportati all'intervallo [-180, 180). Ad esempio, un valore di -190 verrà convertito in 170. Un valore di 190 verrà convertito in -170. Ciò riflette il fatto che le longitudini avvolgono il globo.

LatLngAltitude class

google.maps.LatLngAltitude classe

Un LatLngAltitude è un punto 3D in coordinate geografiche: latitudine, longitudine e altitudine.

• La latitudine è compresa tra -90 e 90 gradi inclusi. I valori superiori o inferiori a questo intervallo verranno bloccati nell'intervallo [-90, 90]. Ciò significa che se il valore specificato è inferiore a -90, verrà impostato su -90. Se il valore è maggiore di 90, verrà impostato su 90.
• La longitudine è compresa tra -180 e 180 gradi inclusi. I valori superiori o inferiori a questo intervallo verranno inclusi in modo che rientrino nell'intervallo. Ad esempio, un valore di -190 verrà convertito in 170. Un valore di 190 verrà convertito in -170. Ciò riflette il fatto che le longitudini avvolgono il globo.
• L'altitudine è misurata in metri. I valori positivi indicano altezze sopra il livello del suolo, mentre i valori negativi indicano altezze sotto la superficie del terreno.

Questa classe implementa LatLngAltitudeLiteral.

Questa classe implementa LatLngLiteral.

Accesso chiamando il numero const {LatLngAltitude} = await google.maps.importLibrary("core").
Consulta Librerie nell'API Maps JavaScript.

Costruttore

LatLngAltitude

LatLngAltitude(value[, noClampNoWrap]) Parametri:  value:  LatLngAltitude|LatLngAltitudeLiteral|LatLng|LatLngLiteral il valore di inizializzazione. noClampNoWrap:  boolean optional indica se conservare i valori di inizializzazione, anche se potrebbero non essere necessariamente valori di latitudine validi nell'intervallo [-90, 90] o valori di longitudine validi nell'intervallo [-180, 180]. Il valore predefinito è false, che attiva il blocco della latitudine e il wrapping della longitudine.

Proprietà
altitude	Tipo:  number Restituisce l'altitudine.
lat	Tipo:  number Restituisce la latitudine.
lng	Tipo:  number Restituisce la longitudine.

Metodi
equals	equals(other) Parametri:  other:  LatLngAltitude optional un altro oggetto LatLngAltitude. Valore restituito:  boolean Indica se i due oggetti sono uguali. Funzione di confronto.
toJSON	toJSON() Parametri: nessuno Valore restituito:  LatLngAltitudeLiteral una rappresentazione JSON di questo oggetto.

Interfaccia LatLngAltitudeLiteral

google.maps.LatLngAltitudeLiteral interfaccia

I valori letterali degli oggetti vengono accettati al posto degli oggetti LatLngAltitude, per comodità, in molti punti. Questi vengono convertiti in oggetti LatLngAltitude quando l'API Maps li rileva.

Questa interfaccia estende LatLngLiteral.

Proprietà
altitude	Tipo:  number Predefinito: 0 Distanza (in metri) sopra la superficie del terreno. Un valore negativo indica che si trova sotto la superficie del terreno.
lat	Tipo:  number Latitudine in gradi. I valori verranno limitati all'intervallo [-90, 90]. Ciò significa che se il valore specificato è inferiore a -90, verrà impostato su -90. Se il valore è maggiore di 90, verrà impostato su 90.
lng	Tipo:  number Longitudine in gradi. I valori al di fuori dell'intervallo [-180, 180] verranno adattati in modo che rientrino nell'intervallo. Ad esempio, un valore di -190 verrà convertito in 170. Un valore di 190 verrà convertito in -170. Ciò riflette il fatto che le longitudini avvolgono il globo.

Classe Point

google.maps.Point classe

Accesso chiamando il numero const {Point} = await google.maps.importLibrary("core").
Consulta Librerie nell'API Maps JavaScript.

Costruttore
Point	Point(x, y) Parametri:  x:  number y:  number Un punto su un piano bidimensionale.

Proprietà
x	Tipo:  number La coordinata X
y	Tipo:  number La coordinata Y

Metodi
equals	equals(other) Parametri:  other:  Point optional Valore restituito:  boolean Confronta due punti
toString	toString() Parametri: nessuno Valore restituito:  string Restituisce una rappresentazione di stringa di questo punto.

Size class

google.maps.Size classe

Accesso chiamando il numero const {Size} = await google.maps.importLibrary("core").
Consulta Librerie nell'API Maps JavaScript.

Costruttore
Size	Size(width, height[, widthUnit, heightUnit]) Parametri:  width:  number height:  number widthUnit:  string optional heightUnit:  string optional Dimensione bidimensionale, in cui la larghezza è la distanza sull'asse x e l'altezza è la distanza sull'asse y.

Proprietà
height	Tipo:  number L'altezza lungo l'asse y, in pixel.
width	Tipo:  number La larghezza lungo l'asse x, in pixel.

Metodi
equals	equals(other) Parametri:  other:  Size Valore restituito:  boolean Confronta due taglie.
toString	toString() Parametri: nessuno Valore restituito:  string Restituisce una rappresentazione di stringa di questa dimensione.

Interfaccia Padding

google.maps.Padding interfaccia

Proprietà
bottom optional	Tipo:  number optional Spaziatura interna per il basso, in pixel.
left optional	Tipo:  number optional Spaziatura interna a sinistra, in pixel.
right optional	Tipo:  number optional Spaziatura interna a destra, in pixel.
top optional	Tipo:  number optional Spaziatura interna superiore, in pixel.

Interfaccia CircleLiteral

google.maps.CircleLiteral interfaccia

Oggetto letterale che rappresenta un cerchio.

Questa interfaccia estende CircleOptions.

Proprietà
center	Tipo:  LatLng|LatLngLiteral Il centro del cerchio.
radius	Tipo:  number Il raggio in metri sulla superficie terrestre.
Ereditato: clickable, draggable, editable, fillColor, fillOpacity, map, strokeColor, strokeOpacity, strokePosition, strokeWeight, visible, zIndex

Classe Orientation3D

google.maps.Orientation3D classe

Avviso: disponibile solo nel canale v=beta.

Un Orientation3D è un vettore tridimensionale utilizzato per le trasformazioni di rotazione matematica standard lungo direzione, inclinazione e rollio.

• heading è un angolo compreso tra 0 e 360 gradi (escluso).
• L'inclinazione è un angolo compreso tra 0 e 360 gradi.
• roll è un angolo compreso nell'intervallo [0, 360) gradi.

Questa classe implementa Orientation3DLiteral.

Accesso chiamando il numero const {Orientation3D} = await google.maps.importLibrary("core").
Consulta Librerie nell'API Maps JavaScript.

Costruttore
Orientation3D	Orientation3D(value) Parametri:  value:  Orientation3D|Orientation3DLiteral il valore di inizializzazione.

Proprietà
heading	Tipo:  number Predefinito: 0 Rotazione attorno all'asse z (normale alla superficie terrestre). Un valore pari a 0 (il valore predefinito) equivale a Nord. Una rotazione positiva avviene in senso orario attorno all'asse z ed è specificata in gradi da 0 a 360. I valori superiori o inferiori a questo intervallo verranno inclusi in modo che rientrino nell'intervallo. Ad esempio, un valore di -190 verrà convertito in 170. Anche un valore di 530 verrà convertito in 170.
roll	Tipo:  number Predefinito: 0 Rotazione intorno all'asse Y. Una rotazione positiva avviene in senso orario attorno all'asse Y ed è specificata in gradi da 0 a 360. I valori superiori o inferiori a questo intervallo verranno inclusi in modo che rientrino nell'intervallo. Ad esempio, un valore di -190 verrà convertito in 170. Anche un valore di 530 verrà convertito in 170.
tilt	Tipo:  number Predefinito: 0 Rotazione attorno all'asse X. Una rotazione positiva avviene in senso orario attorno all'asse x ed è specificata in gradi da 0 a 360. I valori superiori o inferiori a questo intervallo verranno inclusi in modo che rientrino nell'intervallo. Ad esempio, un valore di -190 verrà convertito in 170. Anche un valore di 530 verrà convertito in 170.

Metodi
equals	equals(other) Parametri:  other:  Orientation3D|Orientation3DLiteral optional un altro oggetto Orientation3D. Valore restituito:  boolean Indica se i due oggetti sono uguali. Funzione di confronto.
toJSON	toJSON() Parametri: nessuno Valore restituito:  Orientation3DLiteral Esegue la conversione nella rappresentazione JSON. Questa funzione è pensata per essere utilizzata tramite JSON.stringify.

Interfaccia Orientation3DLiteral

google.maps.Orientation3DLiteral interfaccia

Avviso: disponibile solo nel canale v=beta.

I valori letterali degli oggetti vengono accettati al posto degli oggetti Orientation3D, per comodità, in molti punti. Questi vengono convertiti in oggetti Orientation3D quando l'API Maps li rileva.

Proprietà
heading optional	Tipo:  number optional Rotazione attorno all'asse z (normale alla superficie terrestre). Un valore pari a 0 (il valore predefinito) equivale a Nord. Una rotazione positiva avviene in senso orario attorno all'asse z ed è specificata in gradi da 0 a 360.
roll optional	Tipo:  number optional Rotazione intorno all'asse Y. Una rotazione positiva avviene in senso orario attorno all'asse Y ed è specificata in gradi da 0 a 360.
tilt optional	Tipo:  number optional Rotazione attorno all'asse X. Una rotazione positiva avviene in senso orario attorno all'asse x ed è specificata in gradi da 0 a 360.

Classe Vector3D

google.maps.Vector3D classe

Avviso: disponibile solo nel canale v=beta.

Un Vector3D è un vettore tridimensionale utilizzato per operazioni matematiche standard come il ridimensionamento dei limiti di un oggetto tridimensionale lungo gli assi x, y e z locali.

• x è un numero reale.
• y è un numero reale.
• z è un numero reale.

Questa classe implementa Vector3DLiteral.

Accesso chiamando il numero const {Vector3D} = await google.maps.importLibrary("core").
Consulta Librerie nell'API Maps JavaScript.

Costruttore
Vector3D	Vector3D(value) Parametri:  value:  Vector3D|Vector3DLiteral il valore di inizializzazione.

Proprietà
x	Tipo:  number Componente X del vettore tridimensionale.
y	Tipo:  number Componente Y del vettore tridimensionale.
z	Tipo:  number Componente Z del vettore tridimensionale.

Metodi
equals	equals(other) Parametri:  other:  Vector3D|Vector3DLiteral optional un altro oggetto Vector3D o Vector3DLiteral. Valore restituito:  boolean Funzione di confronto.
toJSON	toJSON() Parametri: nessuno Valore restituito:  Vector3DLiteral Esegue la conversione nella rappresentazione JSON. Questa funzione è pensata per essere utilizzata tramite JSON.stringify.

Interfaccia Vector3DLiteral

google.maps.Vector3DLiteral interfaccia

Avviso: disponibile solo nel canale v=beta.

I valori letterali degli oggetti vengono accettati al posto degli oggetti Vector3D, per comodità, in molti punti. Questi vengono convertiti in oggetti Vector3D quando l'API Maps li rileva.

Proprietà
x	Tipo:  number Componente X del vettore tridimensionale.
y	Tipo:  number Componente Y del vettore tridimensionale.
z	Tipo:  number Componente Z del vettore tridimensionale.