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.

LatLng
LatLng(latOrLatLngOrLatLngLiteral[, lngOrNoClampNoWrap, noClampNoWrap])
Parametri: 
  • latOrLatLngOrLatLngLiteralnumber|LatLngLiteral|LatLng
  • lngOrNoClampNoWrapnumber|boolean optional
  • noClampNoWrapboolean 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.
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
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: 
  • precisionnumber 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.

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.

LatLngBounds
LatLngBounds([swOrLatLngBounds, ne])
Parametri: 
Consente di creare un rettangolo partendo dai punti corrispondenti agli angoli sud-ovest e nord-est.
MAX_BOUNDS LatLngBound per i limiti massimi della Terra. Questi limiti comprenderanno l'intero globo.
contains
contains(latLng)
Parametri: 
Valore restituito:  boolean
Restituisce true se lat/lng specificata rientra in questi limiti.
equals
equals(other)
Parametri: 
Valore restituito:  boolean
Restituisce true se questo limite corrisponde approssimativamente ai limiti specificati.
extend
extend(point)
Parametri: 
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: 
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: 
  • precisionnumber 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: 
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.

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.

LatLngAltitude
LatLngAltitude(value[, noClampNoWrap])
Parametri: 
  • valueLatLngAltitude|LatLngAltitudeLiteral|LatLng|LatLngLiteral il valore di inizializzazione.
  • noClampNoWrapboolean 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.
altitude
Tipo:  number
Restituisce l'altitudine.
lat
Tipo:  number
Restituisce la latitudine.
lng
Tipo:  number
Restituisce la longitudine.
equals
equals(other)
Parametri: 
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.

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.

Point
Point(x, y)
Parametri: 
  • xnumber
  • ynumber
Un punto su un piano bidimensionale.
x
Tipo:  number
La coordinata X
y
Tipo:  number
La coordinata Y
equals
equals(other)
Parametri: 
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.

Size
Size(width, height[, widthUnit, heightUnit])
Parametri: 
  • widthnumber
  • heightnumber
  • widthUnitstring optional
  • heightUnitstring optional
Dimensione bidimensionale, dove la larghezza è la distanza sull'asse x e l'altezza è la distanza sull'asse y.
height
Tipo:  number
L'altezza lungo l'asse Y, in pixel.
width
Tipo:  number
La larghezza in pixel lungo l'asse X.
equals
equals(other)
Parametri: 
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

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.

center
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