Coordinates

Classe LatLng

Classe google.maps.LatLng

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 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.
• La longitudine è compresa tra -180 e 180 gradi inclusi. I valori superiori o inferiori a questo intervallo verranno adattati in modo da rientrare 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.

Sebbene la proiezione predefinita della mappa associ la longitudine alla coordinata x della mappa e la latitudine alla coordinata y, la coordinata di latitudine viene sempre scritta per 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 i seguenti sono equivalenti:

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

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

Le possibili chiamate al costruttore sono le seguenti:

 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);
 

Accedi 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 Converte nella rappresentazione JSON. Questa funzione è destinata a 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.

Interfaccia LatLngLiteral

Interfaccia google.maps.LatLngLiteral

In molti casi, gli oggetti letterali sono accettati al posto degli oggetti LatLng, per comodità. Questi vengono convertiti in oggetti LatLng quando l'API di Google Maps li rileva.

Esempi:

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

Gli oggetti letterali 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 aggregati in modo da rientrare 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

Classe google.maps.LatLngBounds

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

Accedi 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 Crea un rettangolo 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 per contenere 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 questi limiti condividono punti con gli altri limiti.
isEmpty	isEmpty() Parametri: nessuno Valore restituito:  boolean Restituisce se i limiti sono vuoti.
toJSON	toJSON() Parametri: nessuno Valore restituito:  LatLngBoundsLiteral Converte nella rappresentazione JSON. Questa funzione è destinata a 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 di quel 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

Interfaccia google.maps.LatLngBoundsLiteral

Gli oggetti letterali sono accettati al posto degli oggetti LatLngBounds nell'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 inseriti nell'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 inseriti nell'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.

Classe LatLngAltitude

Classe google.maps.LatLngAltitude

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 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.
• La longitudine è compresa tra -180 e 180 gradi inclusi. I valori superiori o inferiori a questo intervallo verranno adattati in modo da rientrare 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 le altezze sopra il livello del suolo, mentre i valori negativi indicano le altezze sotto la superficie del suolo.

Questa classe implementa LatLngAltitudeLiteral.

Questa classe implementa LatLngLiteral.

Accedi 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 non sono 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 l'avvolgimento 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

Interfaccia google.maps.LatLngAltitudeLiteral

In molti casi, gli oggetti letterali sono accettati al posto degli oggetti LatLngAltitude, per comodità. Questi vengono convertiti in oggetti LatLngAltitude quando l'API di Google Maps li rileva.

Questa interfaccia estende LatLngLiteral.

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 aggregati in modo da rientrare 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.
altitude optional	Tipo:  number optional Valore predefinito: 0 Distanza (in metri) dalla superficie del suolo. Un valore negativo indica che si trova sotto la superficie del suolo.

Classe Point

Classe google.maps.Point

Accedi 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.

Classe Size

Classe google.maps.Size

Accedi 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 Dimensioni bidimensionali, dove 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 optional Valore restituito:  boolean Confronta due dimensioni.
toString	toString() Parametri: nessuno Valore restituito:  string Restituisce una rappresentazione di stringa di questa dimensione.

Interfaccia di padding

Interfaccia google.maps.Padding

Proprietà
bottom optional	Tipo:  number optional Spaziatura interna per la parte inferiore, in pixel.
left optional	Tipo:  number optional Spaziatura interna a sinistra, in pixel.
right optional	Tipo:  number optional Spaziatura interna per il lato destro, in pixel.
top optional	Tipo:  number optional Spaziatura interna superiore in pixel.

Interfaccia CircleLiteral

Interfaccia google.maps.CircleLiteral

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

Classe google.maps.Orientation3D

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

• heading è un angolo compreso nell'intervallo [0, 360) gradi.
• tilt è un angolo compreso nell'intervallo [0, 360) gradi.
• Il rollio è un angolo compreso nell'intervallo [0, 360) gradi.

Questa classe implementa Orientation3DLiteral.

Accedi 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 Valore predefinito: 0 Rotazione attorno all'asse Z (perpendicolare alla superficie terrestre). Un valore pari a 0 (valore predefinito) equivale a Nord. Una rotazione positiva è in senso orario attorno all'asse Z ed è specificata in gradi da 0 a 360. I valori superiori o inferiori a questo intervallo verranno adattati in modo da rientrare nell'intervallo. Ad esempio, un valore di -190 verrà convertito in 170. Anche un valore di 530 verrà convertito in 170.
roll	Tipo:  number Valore predefinito: 0 Rotazione attorno all'asse Y. Una rotazione positiva è in senso orario attorno all'asse Y ed è specificata in gradi da 0 a 360. I valori superiori o inferiori a questo intervallo verranno adattati in modo da rientrare nell'intervallo. Ad esempio, un valore di -190 verrà convertito in 170. Anche un valore di 530 verrà convertito in 170.
tilt	Tipo:  number Valore predefinito: 0 Rotazione attorno all'asse X. Una rotazione positiva è in senso orario attorno all'asse X ed è specificata in gradi da 0 a 360. I valori superiori o inferiori a questo intervallo verranno adattati in modo da rientrare 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 Converte nella rappresentazione JSON. Questa funzione è destinata a essere utilizzata tramite JSON.stringify.

Interfaccia Orientation3DLiteral

Interfaccia google.maps.Orientation3DLiteral

In molti casi, gli oggetti letterali sono accettati al posto degli oggetti Orientation3D, per comodità. Questi vengono convertiti in oggetti Orientation3D quando l'API di Google Maps li rileva.

Proprietà
heading optional	Tipo:  number optional Rotazione attorno all'asse Z (perpendicolare alla superficie terrestre). Un valore pari a 0 (valore predefinito) equivale a Nord. Una rotazione positiva è in senso orario attorno all'asse Z ed è specificata in gradi da 0 a 360.
roll optional	Tipo:  number optional Rotazione attorno all'asse Y. Una rotazione positiva è 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 è in senso orario attorno all'asse X ed è specificata in gradi da 0 a 360.

Classe Vector3D

Classe google.maps.Vector3D

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.

Accedi 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 Converte nella rappresentazione JSON. Questa funzione è destinata a essere utilizzata tramite JSON.stringify.

Interfaccia Vector3DLiteral

Interfaccia google.maps.Vector3DLiteral

In molti casi, gli oggetti letterali sono accettati al posto degli oggetti Vector3D, per comodità. Questi vengono convertiti in oggetti Vector3D quando l'API di Google 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.