Coordinates

LatLng

google.maps.LatLng classe

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

  • La latitudine va da -90 a 90 gradi inclusi. I valori superiori o inferiori a 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 va da -180 a 180 gradi, inclusi. I valori superiori o inferiori a questo intervallo verranno aggregati in modo che rientrino nell'intervallo. Ad esempio, un valore pari a -190 verrà convertito in 170. Il valore 190 verrà convertito in -170. Ciò indica il fatto che le longitudini sono disposte su tutto il globo.
Anche se la proiezione predefinita della mappa associa 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 i seguenti valori 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 all'interno dell'intervallo [-90, 90]. La longitudine è specificata in gradi all'interno dell'intervallo [-180, 180). Imposta noClampNoWrap su true per attivare i valori che non rientrano in 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 in rappresentazione JSON. Questa funzione è destinata a essere utilizzata tramite JSON.stringify.
toString
toString()
Parametri: nessuno
Valore restituito:  string
Converte in rappresentazione stringa.
toUrlValue
toUrlValue([precision])
Parametri: 
  • precisionnumber optional
Valore restituito:  string
Restituisce una stringa nella forma "lat,lng" per questo LatLng. Per impostazione predefinita, arrotondiamo i valori lat/lng a sei cifre decimali.

Interfaccia LatLngLiteral

Interfaccia google.maps.LatLngLiteral

Per praticità, i valori letterali oggetto vengono accettati al posto degli oggetti LatLng in molte posizioni. 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});

I valori letterali oggetto 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 aggregati in modo che rientrino nell'intervallo. Ad esempio, un valore pari a -190 verrà convertito in 170. Il valore 190 verrà convertito in -170. Ciò indica il fatto che le longitudini sono disposte su tutto il globo.

LatLngBounds classe

google.maps.LatLngBounds classe

Un'istanza LatLngBounds rappresenta un rettangolo con coordinate geografiche, tra cui uno 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 a partire dai punti degli angoli sud-ovest e nord-est.
MAX_BOUNDS LatLngBounds per i limiti massimi della Terra. Questi limiti abbracciano 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 punti con gli altri limiti.
isEmpty
isEmpty()
Parametri: nessuno
Valore restituito:  boolean
Restituisce un valore se i limiti sono vuoti.
toJSON
toJSON()
Parametri: nessuno
Valore restituito:  LatLngBoundsLiteral
Converte in 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 nel formato "lat_lo,lng_lo,lat_hi,lng_hi" per questo limite, 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 oggetto sono accettati al posto degli oggetti LatLngBounds in tutta l'API. Questi oggetti vengono convertiti automaticamente in LatLngBounds oggetti. È necessario impostare tutti i valori south, west, north e east, altrimenti viene generata un'eccezione.

east
Tipo:  number
Longitudine est in gradi. I valori al di fuori dell'intervallo [-180, 180] verranno aggregati nell'intervallo [-180, 180]. Ad esempio, un valore pari a -190 verrà convertito in 170. Il valore 190 verrà convertito in -170. Ciò indica il fatto che le longitudini sono disposte su tutto il 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 al di fuori dell'intervallo [-180, 180] verranno aggregati nell'intervallo [-180, 180]. Ad esempio, un valore pari a -190 verrà convertito in 170. Il valore 190 verrà convertito in -170. Ciò indica il fatto che le longitudini sono disposte su tutto il globo.

lezione LatLngAltitude

google.maps.LatLngAltitude classe

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

  • La latitudine va da -90 a 90 gradi inclusi. I valori superiori o inferiori a 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 va da -180 a 180 gradi, inclusi. I valori superiori o inferiori a questo intervallo verranno aggregati in modo che rientrino nell'intervallo. Ad esempio, un valore pari a -190 verrà convertito in 170. Il valore 190 verrà convertito in -170. Ciò indica il fatto che le longitudini sono disposte su tutto 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 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 consente il blocco della latitudine e il wrapping 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 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 praticità, i valori letterali oggetto vengono accettati al posto degli oggetti LatLngAltitude in molte posizioni. Questi vengono convertiti in oggetti LatLngAltitude quando l'API di Google Maps li rileva.

Questa interfaccia estende LatLngLiteral.

altitude
Tipo:  number
Predefinita: 0
Distanza (in metri) dalla superficie del suolo. Un valore negativo indica 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 aggregati in modo che rientrino nell'intervallo. Ad esempio, un valore pari a -190 verrà convertito in 170. Il valore 190 verrà convertito in -170. Ciò indica il fatto che le longitudini sono disposte su tutto il globo.

Classe

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
Coordinata X
y
Tipo:  number
Coordinata Y
equals
equals(other)
Parametri: 
Valore restituito:  boolean
Confronta due punti
toString
toString()
Parametri: nessuno
Valore restituito:  string
Restituisce una rappresentazione stringa del punto.

Classe Dimensioni

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 in pixel lungo l'asse y.
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 in pixel per la parte inferiore.
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 in pixel per la parte superiore.

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.
Ereditate: clickable, draggable, editable, fillColor, fillOpacity, map, strokeColor, strokeOpacity, strokePosition, strokeWeight, visible, zIndex