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.
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.
equals
equals(other)
Parametri: 
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.
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.
LatLngBounds
LatLngBounds([swOrLatLngBounds, ne])
Parametri: 
Costruisce un rettangolo a partire dai punti negli angoli sud-ovest e nord-est.
MAX_BOUNDS LatLngBounds per i limiti massimi della Terra. Questi limiti comprenderanno l'intero globo.
contains
contains(latLng)
Parametri: 
Valore restituito:  boolean
Restituisce true se la latitudine/longitudine specificata rientra in questi limiti.
equals
equals(other)
Parametri: 
Valore restituito:  boolean
Restituisce true se questi limiti sono approssimativamente uguali ai limiti specificati.
extend
extend(point)
Parametri: 
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: 
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: 
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.
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