Coordinates

lezione LatLng

lezione google.maps.LatLng

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

  • La latitudine è compresa tra -90 e 90 gradi (inclusi). I valori superiori o inferiori a questo intervallo 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, sarà impostato su 90.
  • La longitudine è compresa tra -180 e 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. Il valore 190 verrà convertito in -170. Questo riflette il fatto che le longitudini avvolgono il globo.
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, 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 accetta oggetti LatLng accetta anche oggetti LatLngLiteral, pertanto i seguenti 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 un'istanza LatLng viene passata 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({lat: -34, lng: 151}, null, true);
 new google.maps.LatLng(new google.maps.LatLng(-34, 151));
 new google.maps.LatLng(new google.maps.LatLng(-34, 151), true);
 new google.maps.LatLng(new google.maps.LatLng(-34, 151), null, true);

Quando usi v=beta, puoi accedervi chiamando const {LatLng} = await google.map.importLibrary("core"). Consulta la sezione 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 compresi nell'intervallo [-180, 180]. Imposta noClampNoWrap su true per abilitare i valori al di fuori di questo intervallo. Prendi nota dell'ordine della latitudine e della 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 deve essere utilizzata tramite JSON.stringify.
toString
toString()
Parametri: nessuno
Valore restituito: string
Converte in rappresentazione 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 lat/lng a sei cifre decimali.

Interfaccia LatLngLiteral

google.maps.LatLngLiteral interfaccia

In molti punti sono ammessi valori letterali di oggetti al posto degli oggetti LatLng. Queste vengono convertite in oggetti LatLng quando vengono riscontrati 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 limitati nell'intervallo [-90, 90]. Ciò significa che se il valore specificato è inferiore a -90, verrà impostato su -90. Se il valore è maggiore di 90, sarà impostato su 90.
lng
Tipo: number
Longitudine in gradi. I valori che non rientrano nell'intervallo [-180, 180] vengono 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. Questo riflette il fatto che le longitudini avvolgono il globo.

lezione LatLngBounds

lezione google.maps.LatLngBounds

Un'istanza LatLngBounds rappresenta un rettangolo con coordinate geografiche, tra cui una che attraversa il meridiano longitudinale di 180 gradi.

Quando usi v=beta, puoi accedervi chiamando const {LatLngBounds} = await google.map.importLibrary("core"). Consulta la sezione Librerie nell'API Maps JavaScript.
LatLngBounds
LatLngBounds([swOrLatLngBounds, ne])
Parametri:
Crea un rettangolo a partire dai punti agli angoli sud-ovest e nord-est.
contains
contains(latLng)
Parametri:
Valore restituito: boolean
Restituisce true se il valore lat/lng specificato è compreso 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: 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 qualsiasi punto con gli altri limiti.
isEmpty
isEmpty()
Parametri: nessuno
Valore restituito: boolean
Restituisce se i limiti sono vuoti.
toJSON
toJSON()
Parametri: nessuno
Valore restituito: LatLngBoundsLiteral
Converte in rappresentazione JSON. Questa funzione deve essere utilizzata tramite JSON.stringify.
toSpan
toSpan()
Parametri: nessuno
Valore restituito: LatLng
Converte i limiti di 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 questo limite, dove "lo" corrisponde all'angolo sud-ovest del riquadro di delimitazione, mentre "hi" corrisponde all'angolo nord-est di quella casella.
union
union(other)
Parametri:
Valore restituito: LatLngBounds
Estende questi limiti per contenere l'unione di questo e dei limiti specificati.
MAX_BOUNDS LatLngBounds per raggiungere i confini massimi della Terra. Questi confini comprendono l'intero globo.

Interfaccia LatLngBoundsLiteral

google.maps.LatLngBoundsLiteral interfaccia

Nell'API sono accettati valori letterali degli oggetti al posto di LatLngBounds oggetti. 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] vengono aggregati nell'intervallo [-180, 180]. Ad esempio, un valore pari a -190 verrà convertito in 170. Il valore 190 verrà convertito in -170. Questo riflette il fatto che le longitudini avvolgono il globo.
north
Tipo: number
Latitudine nord in gradi. I valori verranno limitati nell'intervallo [-90, 90]. Ciò significa che se il valore specificato è inferiore a -90, verrà impostato su -90. Se il valore è maggiore di 90, sarà impostato su 90.
south
Tipo: number
Latitudine sud in gradi. I valori verranno limitati nell'intervallo [-90, 90]. Ciò significa che se il valore specificato è inferiore a -90, verrà impostato su -90. Se il valore è maggiore di 90, sarà impostato su 90.
west
Tipo: number
Longitudine ovest in gradi. I valori che non rientrano nell'intervallo [-180, 180] vengono aggregati nell'intervallo [-180, 180]. Ad esempio, un valore pari a -190 verrà convertito in 170. Il valore 190 verrà convertito in -170. Questo riflette il fatto che le longitudini avvolgono il globo.

lezione LatLngAltitude

lezione google.maps.LatLngAltitude

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

  • La latitudine è compresa tra -90 e 90 gradi (inclusi). I valori superiori o inferiori a questo intervallo 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, sarà impostato su 90.
  • La longitudine è compresa tra -180 e 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. Il valore 190 verrà convertito in -170. Questo riflette il fatto che le longitudini avvolgono il globo.
  • L'altitudine viene misurata in metri. I valori positivi indicano le altezze dal livello del suolo, mentre i valori negativi indicano le altezze al di sotto della superficie del terreno.

Questo corso implementa LatLngAltitudeLiteral.

Questo corso implementa LatLngLiteral.

Quando usi v=beta, puoi accedervi chiamando const {LatLngAltitude} = await google.map.importLibrary("core"). Consulta la sezione Librerie nell'API Maps JavaScript.
LatLngAltitude
LatLngAltitude(value[, noClampNoWrap])
Parametri:
  • value: LatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral|LatLng il valore di inizializzazione.
  • noClampNoWrap:  boolean optional specificare se mantenere i valori di inizializzazione, anche se potrebbero non essere 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 di 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 di ritorno: LatLngAltitudeLiteral una rappresentazione JSON di questo oggetto.

Interfaccia LatLngAltitudeLiteral

google.maps.LatLngAltitudeLiteral interfaccia

In molti punti sono ammessi valori letterali di oggetti al posto degli oggetti LatLngAltitude. Queste vengono convertite in oggetti LatLngAltitude quando vengono riscontrati dall'API di Google Maps.

Questa interfaccia estende LatLngLiteral.

altitude
Tipo: number
Predefinito: 0
Distanza (in metri) dalla superficie del terreno. Un valore negativo indica che si trova sotto la superficie del terreno.
lat
Tipo: number
Latitudine in gradi. I valori verranno limitati nell'intervallo [-90, 90]. Ciò significa che se il valore specificato è inferiore a -90, verrà impostato su -90. Se il valore è maggiore di 90, sarà impostato su 90.
lng
Tipo: number
Longitudine in gradi. I valori che non rientrano nell'intervallo [-180, 180] vengono 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. Questo riflette il fatto che le longitudini avvolgono il globo.

Classe Point

lezione google.maps.Point

Quando usi v=beta, puoi accedervi chiamando const {Point} = await google.map.importLibrary("core"). Consulta la sezione Librerie nell'API Maps JavaScript.
Point
Point(x, y)
Parametri:
  • x:  number
  • y:  number
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 di questo punto.

Dimensioni

lezione google.maps.Size

Quando usi v=beta, puoi accedervi chiamando const {Size} = await google.map.importLibrary("core"). Consulta la sezione Librerie nell'API Maps JavaScript.
Size
Size(width, height[, widthUnit, heightUnit])
Parametri:
  • width:  number
  • height: number
  • widthUnit:  string optional
  • heightUnit: string optional
Dimensioni bidimensionali, dove la larghezza è la distanza sull'asse x, mentre l'altezza è la distanza sull'asse y.
height
Tipo: number
L'altezza in pixel dell'asse y.
width
Tipo: number
La larghezza in pixel dell'asse X.
equals
equals(other)
Parametri:
Valore restituito: boolean
Confronta due dimensioni.
toString
toString()
Parametri: nessuno
Valore restituito: string
Restituisce una rappresentazione stringa di queste dimensioni.

Interfaccia Spaziatura interna

google.maps.Padding interfaccia

bottom optional
Tipo: number optional
Spaziatura interna per la parte inferiore, in pixel.
left optional
Tipo: number optional
Spaziatura interna per la parte 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

google.maps.CircleLiteral interfaccia

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