Coordinates

lezione LatLng

google.maps.LatLng corso

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

  • Latitudine compresa tra -90 e 90 gradi, compresi. I valori superiori o inferiori a questo intervallo verranno limitati all'intervallo [-90, 90]. Ciò significa che se il valore specificato è minore di -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 aggregati, in modo che rientrino nell'intervallo. Ad esempio, il valore -190 verrà convertito in 170. Il valore 190 verrà convertito in -170. Ciò riflette il fatto che le longitudini si avvolgono in tutto il mondo.
Sebbene la proiezione predefinita della mappa associ la longitudine alla coordinata x della mappa e la latitudine alla coordinata y, quest'ultima viene sempre scritta prima e 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 gli oggetti LatLng accetta anche un oggetto LatLngLiteral, in modo che i seguenti siano 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 trasmessa 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 compresi nell'intervallo [-90, 90]. La longitudine è specificata in gradi compresi tra -180 e 180. Imposta noClampNoWrap su true per attivare i valori al di fuori di questo intervallo. Prendi nota dell'ordine dei valori di latitudine e longitudine.
equals
equals(other)
Parametri: 
Valore restituito:  boolean
Funzione di confronto.
lat
lat()
Parametri: nessuna
Valore restituito:  number
Restituisce la latitudine in gradi.
lng
lng()
Parametri: nessuna
Valore restituito:  number
Restituisce la longitudine in gradi.
toJSON
toJSON()
Parametri: nessuna
Valore restituito:  LatLngLiteral
Converte in rappresentazione JSON. Questa funzione deve essere utilizzata tramite JSON.stringify.
toString
toString()
Parametri: nessuna
Valore restituito:  string
Converte in rappresentazione stringa.
toUrlValue
toUrlValue([precision])
Parametri: 
  • precisionnumber optional
Valore restituito:  string
Restituisce una stringa nel formato "lat,lng" per questo LatLng. Per impostazione predefinita, arrotondiamo i valori lat/lng a sei cifre decimali.

Interfaccia LatLngLiteral

Interfaccia google.maps.LatLngLiteral

I valori letterali degli oggetti sono accettati al posto di LatLng oggetti, per praticità, in molti punti. Questi vengono convertiti in oggetti LatLng quando vengono incontrati dall'API di 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 saranno limitati all'intervallo [-90, 90]. Ciò significa che se il valore specificato è minore di -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 che rientrino nell'intervallo. Ad esempio, il valore -190 verrà convertito in 170. Il valore 190 verrà convertito in -170. Ciò riflette il fatto che le longitudini si avvolgono in tutto il mondo.

Classe LatLngBounds

google.maps.LatLngBounds corso

Un'istanza LatLngBounds rappresenta un rettangolo con coordinate geografiche, inclusa una 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: 
Crea un rettangolo a partire dai punti negli angoli sud-ovest e nord-est.
contains
contains(latLng)
Parametri: 
Valore restituito:  boolean
Restituisce true se il valore latitudine/longitudine specificato rientra in questo limite.
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 per contenere il punto specificato.
getCenter
getCenter()
Parametri: nessuna
Valore restituito:  LatLng
Calcola il centro di questo LatLngBounds
getNorthEast
getNorthEast()
Parametri: nessuna
Valore restituito:  LatLng
Restituisce l'angolo nord-est di questo confine.
getSouthWest
getSouthWest()
Parametri: nessuna
Valore restituito:  LatLng
Restituisce l'angolo sud-ovest di questo confine.
intersects
intersects(other)
Parametri: 
Valore restituito:  boolean
Restituisce true se questo limite condivide qualsiasi punto con gli altri limiti.
isEmpty
isEmpty()
Parametri: nessuna
Valore restituito:  boolean
Restituisce se i limiti sono vuoti.
toJSON
toJSON()
Parametri: nessuna
Valore restituito:  LatLngBoundsLiteral
Converte in rappresentazione JSON. Questa funzione deve essere utilizzata tramite JSON.stringify.
toSpan
toSpan()
Parametri: nessuna
Valore restituito:  LatLng
Converte i limiti della mappa specificati in un intervallo lat/lng.
toString
toString()
Parametri: nessuna
Valore restituito:  string
Si 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 questi limiti, dove "lo" corrisponde all'angolo sud-ovest del riquadro di delimitazione, mentre "hi" corrisponde all'angolo nord-est di tale casella.
union
union(other)
Parametri: 
Valore restituito:  LatLngBounds
Estende questo limite per contenere l'unione di questo e dei limiti specificati.
MAX_BOUNDS LatLngBounds per il limite massimo della Terra. Questi confini comprendono l'intero globo.

Interfaccia LatLngBoundsLiteral

Interfaccia google.maps.LatLngBoundsLiteral

I valori letterali degli oggetti vengono accettati al posto di LatLngBounds oggetti nell'API. che vengono convertiti automaticamente in LatLngBounds oggetti. È necessario impostare tutti i valori south, west, north e east, altrimenti verrà fatta un'eccezione.

east
Tipo:  number
Longitudine est in gradi. I valori che non rientrano nell'intervallo [-180, 180] verranno inseriti nell'intervallo [-180, 180]. Ad esempio, il valore -190 verrà convertito in 170. Il valore 190 verrà convertito in -170. Ciò riflette il fatto che le longitudini si avvolgono in tutto il mondo.
north
Tipo:  number
Latitudine nord in gradi. I valori saranno limitati all'intervallo [-90, 90]. Ciò significa che se il valore specificato è minore di -90, verrà impostato su -90. Se il valore è maggiore di 90, verrà impostato su 90.
south
Tipo:  number
Latitudine sud in gradi. I valori saranno limitati all'intervallo [-90, 90]. Ciò significa che se il valore specificato è minore di -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 inseriti nell'intervallo [-180, 180]. Ad esempio, il valore -190 verrà convertito in 170. Il valore 190 verrà convertito in -170. Ciò riflette il fatto che le longitudini si avvolgono in tutto il mondo.

Classe LatLngAltitude

google.maps.LatLngAltitude corso

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

  • Latitudine compresa tra -90 e 90 gradi, compresi. I valori superiori o inferiori a questo intervallo verranno limitati all'intervallo [-90, 90]. Ciò significa che se il valore specificato è minore di -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 aggregati, in modo che rientrino nell'intervallo. Ad esempio, il valore -190 verrà convertito in 170. Il valore 190 verrà convertito in -170. Ciò riflette il fatto che le longitudini si avvolgono in tutto il mondo.
  • L'altitudine è misurata in metri. I valori positivi indicano le altezze dal livello del suolo, mentre i valori negativi indicano le altezze sotto la superficie del suolo.

Questo corso implementa LatLngAltitudeLiteral.

Questo corso 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 non possono essere necessariamente valori di latitudine validi nell'intervallo [-90, 90] o valori di longitudine validi nell'intervallo [-180, 180]. L'impostazione predefinita è false, che consente il bloccaggio della latitudine e la 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: nessuna
Valore restituito:  LatLngAltitudeLiteral una rappresentazione JSON di questo oggetto.

Interfaccia LatLngAltitudeLiteral

Interfaccia google.maps.LatLngAltitudeLiteral

I valori letterali degli oggetti sono accettati al posto di LatLngAltitude oggetti, per praticità, in molti punti. Questi vengono convertiti in oggetti LatLngAltitude quando vengono incontrati dall'API di Maps.

Questa interfaccia estende LatLngLiteral.

altitude
Tipo:  number
Predefinito: 0
Distanza (in metri) dalla superficie del suolo. Per valore negativo si intende sotto la superficie del terreno.
lat
Tipo:  number
Latitudine in gradi. I valori saranno limitati all'intervallo [-90, 90]. Ciò significa che se il valore specificato è minore di -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 che rientrino nell'intervallo. Ad esempio, il valore -190 verrà convertito in 170. Il valore 190 verrà convertito in -170. Ciò riflette il fatto che le longitudini si avvolgono in tutto il mondo.

lezione Point

google.maps.Point corso

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: nessuna
Valore restituito:  string
Restituisce una rappresentazione stringa di questo punto.

Classe Dimensioni

google.maps.Size corso

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, mentre l'altezza è la distanza sull'asse y.
height
Tipo:  number
L'altezza lungo l'asse y, in pixel.
width
Tipo:  number
La larghezza in asse x, in pixel.
equals
equals(other)
Parametri: 
Valore restituito:  boolean
Confronta due dimensioni.
toString
toString()
Parametri: nessuna
Valore restituito:  string
Restituisce una rappresentazione stringa di queste dimensioni.

Interfaccia Spaziatura interna

Interfaccia google.maps.Padding

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 a destra, in pixel.
top optional
Tipo:  number optional
Spaziatura interna per la parte superiore, in pixel.

Interfaccia CircleLiteral

Interfaccia google.maps.CircleLiteral

Valore letterale dell'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