Coordinates

LatLng

google.maps.LatLng classe

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

• La latitudine va da -90 a 90 gradi inclusi. I valori al di sopra o al di sotto di questo intervallo verranno fissati 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 varia da -180 a 180 gradi inclusi. I valori al di sopra o al di sotto di questo intervallo verranno aggregati in modo che rientrino nell'intervallo. Ad esempio, un valore pari a -190 verrà convertito in 170. Un valore pari a 190 verrà convertito in -170. Ciò riflette il fatto che le longitudini si sviluppano intorno al globo.

Sebbene la proiezione predefinita sulla mappa associ la longitudine alla coordinata x della mappa e la latitudine alla coordinata y, la coordinata della latitudine è 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 accetta anche un oggetto LatLngLiteral, pertanto le seguenti condizioni 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 viene passata un'istanza 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);
 

Accedi chiamando const {LatLng} = await google.maps.importLibrary("core"). Consulta la sezione 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 entro l'intervallo [-90, 90]. La longitudine è specificata in gradi entro l'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 nella rappresentazione stringa.
toUrlValue	toUrlValue([precision]) Parametri:  precision:  number optional Valore restituito:  string Restituisce una stringa nella forma "lat,lng" per il valore LatLng. Per impostazione predefinita, arrotondiamo i valori di lat/lng a 6 cifre decimali.

Interfaccia LatLngLiteral

Interfaccia google.maps.LatLngLiteral

Per comodità, in molte posizioni vengono accettati i valori letterali degli oggetti al posto degli oggetti LatLng. Questi vengono convertiti in oggetti LatLng quando vengono rilevati dall'API di Google Maps.

Esempi:

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

I valori letterali degli oggetti LatLng non sono supportati nella libreria Geometry.

Proprietà
lat	Tipo:  number Latitudine in gradi. I valori verranno fissati 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 che non rientrano nell'intervallo [-180, 180] verranno sottoposti a wrapping in modo che rientrino nell'intervallo. Ad esempio, un valore pari a -190 verrà convertito in 170. Un valore pari a 190 verrà convertito in -170. Ciò riflette il fatto che le longitudini si sviluppano intorno al globo.

LatLngBounds

google.maps.LatLngBounds classe

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

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

Costruttore
LatLngBounds	LatLngBounds([swOrLatLngBounds, ne]) Parametri:  swOrLatLngBounds:  LatLng|LatLngLiteral|LatLngBounds|LatLngBoundsLiteral optional ne:  LatLng|LatLngLiteral optional Consente di creare un rettangolo partendo dai punti corrispondenti agli angoli sud-ovest e nord-est.

Costanti
MAX_BOUNDS	LatLngBound 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 lat/lng specificata rientra in questi limiti.
equals	equals(other) Parametri:  other:  LatLngBounds|LatLngBoundsLiteral optional Valore restituito:  boolean Restituisce true se questo limite corrisponde approssimativamente ai limiti specificati.
extend	extend(point) Parametri:  point:  LatLng|LatLngLiteral Valore restituito:  LatLngBounds Estende questo limite in modo da 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 questo limite.
getSouthWest	getSouthWest() Parametri: nessuno Valore restituito:  LatLng Restituisce l'angolo sud-ovest di questo limite.
intersects	intersects(other) Parametri:  other:  LatLngBounds|LatLngBoundsLiteral Valore restituito:  boolean Restituisce true se questo limite condivide dei punti con gli altri limiti.
isEmpty	isEmpty() Parametri: nessuno Valore restituito:  boolean Restituisce un valore che indica 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 latitudine/lng.
toString	toString() Parametri: nessuno Valore restituito:  string Converte in stringa.
toUrlValue	toUrlValue([precision]) Parametri:  precision:  number optional Valore restituito:  string Restituisce una stringa nella forma "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 questo limite per contenere l'unione di questo e dei limiti specificati.

Interfaccia LatLngBoundsLiteral

Interfaccia google.maps.LatLngBoundsLiteral

I valori letterali degli oggetti vengono accettati al posto degli oggetti LatLngBounds in tutta l'API. Questi vengono convertiti automaticamente in oggetti LatLngBounds. È necessario impostare tutti i valori south, west, north e east, altrimenti viene generata un'eccezione.

Proprietà
east	Tipo:  number Longitudine est in gradi. I valori che non rientrano nell'intervallo [-180, 180] verranno aggregati nell'intervallo [-180, 180). Ad esempio, un valore pari a -190 verrà convertito in 170. Un valore pari a 190 verrà convertito in -170. Ciò riflette il fatto che le longitudini si sviluppano intorno al globo.
north	Tipo:  number Latitudine nord in gradi. I valori verranno fissati 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 fissati 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 che non rientrano nell'intervallo [-180, 180] verranno aggregati nell'intervallo [-180, 180). Ad esempio, un valore pari a -190 verrà convertito in 170. Un valore pari a 190 verrà convertito in -170. Ciò riflette il fatto che le longitudini si sviluppano intorno al globo.

LatLngAltitude classe

google.maps.LatLngAltitude classe

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

• La latitudine va da -90 a 90 gradi inclusi. I valori al di sopra o al di sotto di questo intervallo verranno fissati 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 varia da -180 a 180 gradi inclusi. I valori al di sopra o al di sotto di questo intervallo verranno aggregati in modo che rientrino nell'intervallo. Ad esempio, un valore pari a -190 verrà convertito in 170. Un valore pari a 190 verrà convertito in -170. Ciò riflette il fatto che le longitudini si sviluppano intorno al globo.
• L'altitudine viene 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 const {LatLngAltitude} = await google.maps.importLibrary("core"). Consulta la sezione 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 mantenere i valori di inizializzazione, anche se potrebbero non essere necessariamente valori di latitudine validi compresi 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 dell'oggetto.

Interfaccia LatLngAltitudeLiteral

Interfaccia google.maps.LatLngAltitudeLiteral

Per comodità, in molte posizioni vengono accettati i valori letterali degli oggetti al posto degli oggetti LatLngAltitude. Questi vengono convertiti in oggetti LatLngAltitude quando vengono rilevati dall'API di Google Maps.

Questa interfaccia estende LatLngLiteral.

Proprietà
altitude	Tipo:  number Valore predefinito: 0 Distanza (in metri) dalla superficie del suolo. Un valore negativo indica che è sotto la superficie del suolo.
lat	Tipo:  number Latitudine in gradi. I valori verranno fissati 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 che non rientrano nell'intervallo [-180, 180] verranno sottoposti a wrapping in modo che rientrino nell'intervallo. Ad esempio, un valore pari a -190 verrà convertito in 170. Un valore pari a 190 verrà convertito in -170. Ciò riflette il fatto che le longitudini si sviluppano intorno al globo.

Classe Point

google.maps.Point classe

Accedi chiamando const {Point} = await google.maps.importLibrary("core"). Consulta la sezione 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 Valore restituito:  boolean Confronta due punti
toString	toString() Parametri: nessuno Valore restituito:  string Restituisce una rappresentazione stringa di questo punto.

Size classe

google.maps.Size classe

Accedi chiamando const {Size} = await google.maps.importLibrary("core"). Consulta la sezione 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, 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 in pixel lungo l'asse X.

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

Interfaccia Spaziatura interna

Interfaccia google.maps.Padding

Proprietà
bottom optional	Tipo:  number optional Spaziatura interna nella parte inferiore, 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 nella parte superiore, in pixel.

Interfaccia CircleLiteral

Interfaccia google.maps.CircleLiteral

Valore letterale oggetto 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