Coordinates

Classe LatLng

google.maps.LatLng corso

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

  • La latitudine va da -90 a 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 va da -180 a 180 gradi, inclusi. I valori superiori o inferiori a questo intervallo verranno a capo in modo da rientrarvi. Ad esempio, un valore di -190 verrà convertito in 170. Un valore di 190 verrà convertito in -170. Questo riflette il fatto che le longitudini avvolgono il globo.
Sebbene la proiezione della mappa predefinita associ la longitudine alla coordinata x della mappa e la latitudine alla coordinata y, la coordinata di latitudine viene 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 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 al costruttore viene passata un'istanza di LatLng, 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: 
  • 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
Consente di convertire in rappresentazione JSON. Questa funzione è progettata 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 del tipo "lat,lng" per questo LatLng. Per impostazione predefinita, arrotondiamo i valori lat/lng a sei cifre decimali.

Interfaccia LatLngLiteral

google.maps.LatLngLiteral interfaccia

Per comodità, in molti casi vengono accettati i valori letterali degli oggetti al posto degli oggetti LatLng. 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 literali di oggetti 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 arrotondati in modo da rientrare nell'intervallo. Ad esempio, un valore di -190 verrà convertito in 170. Un valore di 190 verrà convertito in -170. Questo riflette il fatto che le longitudini avvolgono il globo.

Classe LatLngBounds

google.maps.LatLngBounds corso

Un'istanza LatLngBounds rappresenta un rettangolo in coordinate geografiche, incluso uno che attraversa il meridiano di longitudine 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: 
Costruisce un rettangolo dai punti agli 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 lat/lng specificati rientrano in questi limiti.
equals
equals(other)
Parametri: 
Valore restituito:boolean
Restituisce true se questi limiti sono approssimativamente uguali a quelli specificati.
extend
extend(point)
Parametri: 
Valore restituito:LatLngBounds
Estende questi limiti 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 il 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 questi limiti condividono punti con gli altri limiti.
isEmpty
isEmpty()
Parametri: nessuno
Valore restituito:boolean
Restituisce se i limiti sono vuoti.
toJSON
toJSON()
Parametri: nessuno
Valore restituito:LatLngBoundsLiteral
Consente di convertire in rappresentazione JSON. Questa funzione è progettata per essere utilizzata tramite JSON.stringify.
toSpan
toSpan()
Parametri: nessuno
Valore restituito:LatLng
Converte i limiti della mappa specificati in un intervallo di lat/long.
toString
toString()
Parametri: nessuno
Valore restituito:string
Viene convertito in stringa.
toUrlValue
toUrlValue([precision])
Parametri: 
  • precision:  number optional
Valore restituito:string
Restituisce una stringa del tipo "lat_lo,lng_lo,lat_hi,lng_hi" per questi limiti, dove "lo" corrisponde al angolo sud-ovest del riquadro di delimitazione, mentre "hi" corrisponde all'angolo nord-est della stessa casella.
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 sono accettati al posto degli oggetti LatLngBounds nell'intera API. Questi vengono convertiti automaticamente in oggetti LatLngBounds. Tutti i valori south, west, north e east devono essere impostati, altrimenti viene lanciata un'eccezione.
east
Tipo:  number
Longitudine est in gradi. I valori al di fuori dell'intervallo [-180, 180] verranno arrotondati all'intervallo [-180, 180). Ad esempio, un valore di -190 verrà convertito in 170. Un valore di 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 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 arrotondati all'intervallo [-180, 180). Ad esempio, un valore di -190 verrà convertito in 170. Un valore di 190 verrà convertito in -170. Questo riflette il fatto che le longitudini avvolgono il globo.

Classe LatLngAltitude

google.maps.LatLngAltitude corso

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

  • La latitudine va da -90 a 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 va da -180 a 180 gradi, inclusi. I valori superiori o inferiori a questo intervallo verranno a capo in modo da rientrarvi. Ad esempio, un valore di -190 verrà convertito in 170. Un valore di 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 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: 
  • value:  LatLngAltitude|LatLngAltitudeLiteral|LatLng|LatLngLiteral il valore di inizializzazione.
  • noClampNoWrap:  boolean optional Indica se conservare i valori di inizializzazione, anche se potrebbero non essere necessariamente valori di latitudine validi nell'intervallo [-90, 90] o valori di longitudine validi nell'intervallo [-180, 180]. Il valore predefinito è false, che attiva il vincolo 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 di questo oggetto.

Interfaccia LatLngAltitudeLiteral

google.maps.LatLngAltitudeLiteral interfaccia

Per comodità, in molti casi vengono accettati i valori letterali degli oggetti al posto degli oggetti LatLngAltitude. Questi vengono convertiti in oggetti LatLngAltitude quando l'API Maps li rileva.

Questa interfaccia estende LatLngLiteral.

altitude
Tipo:  number
Valore predefinito: 0
Distanza (in metri) sopra la superficie del suolo. Un valore negativo indica che l'elemento si trova sotto la superficie del suolo.
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 arrotondati in modo da rientrare nell'intervallo. Ad esempio, un valore di -190 verrà convertito in 170. Un valore di 190 verrà convertito in -170. Questo riflette il fatto che le longitudini avvolgono il globo.

Classe Punto

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: 
  • x:  number
  • y:  number
Un punto su un piano bidimensionale.
x
Tipo:  number
La coordinata X
y
Tipo:  number
La coordinata Y
equals
equals(other)
Parametri: 
  • other:  Point optional
Valore restituito:boolean
Confronta due punti
toString
toString()
Parametri: nessuno
Valore restituito:string
Restituisce una rappresentazione di 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: 
  • width:  number
  • height:  number
  • widthUnit:  string optional
  • heightUnit:  string optional
Dimensioni bidimensionali, 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 lungo l'asse x, in pixel.
equals
equals(other)
Parametri: 
Valore restituito:boolean
Confronta due dimensioni.
toString
toString()
Parametri: nessuno
Valore restituito:string
Restituisce una rappresentazione di stringa di questa dimensione.

Interfaccia Spaziatura interna

google.maps.Padding interfaccia

bottom optional
Tipo:  number optional
Spaziatura interna in basso, 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

google.maps.CircleLiteral interfaccia

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

Classe Orientation3D

google.maps.Orientation3D corso

Un Orientation3D è un vettore tridimensionale utilizzato per le trasformazioni di rotazione matematica standard in base a rotta, inclinazione e roll.

  • heading è un angolo compreso nell'intervallo [0, 360] gradi.
  • tilt è un angolo compreso nell'intervallo [0, 360] gradi.
  • roll è un angolo compreso nell'intervallo [0, 360] gradi.

Questa classe implementa Orientation3DLiteral.

Accedi chiamando const {Orientation3D} = await google.maps.importLibrary("core"). Consulta la sezione Librerie nell'API Maps JavaScript.
Orientation3D
Orientation3D(value)
Parametri: 
heading
Tipo:  number
Valore predefinito: 0
Rotazione attorno all'asse z (perpendicolare alla superficie terrestre). Un valore pari a 0 (il valore predefinito) corrisponde a Nord. Una rotazione positiva avviene in senso orario attorno all'asse z e viene specificata in gradi da 0 a 360. I valori superiori o inferiori a questo intervallo verranno a capo in modo da rientrarvi. Ad esempio, un valore di -190 verrà convertito in 170. Anche un valore di 530 verrà convertito in 170.
roll
Tipo:  number
Valore predefinito: 0
Rotazione attorno all'asse Y. Una rotazione positiva avviene in senso orario attorno all'asse Y e viene specificata in gradi da 0 a 360. I valori superiori o inferiori a questo intervallo verranno a capo in modo da rientrarvi. Ad esempio, un valore di -190 verrà convertito in 170. Anche un valore di 530 verrà convertito in 170.
tilt
Tipo:  number
Valore predefinito: 0
Rotazione attorno all'asse X. Una rotazione positiva avviene in senso orario attorno all'asse x e viene specificata in gradi da 0 a 360. I valori superiori o inferiori a questo intervallo verranno a capo in modo da rientrarvi. Ad esempio, un valore di -190 verrà convertito in 170. Anche un valore di 530 verrà convertito in 170.
equals
equals(other)
Parametri: 
Valore restituito:  boolean indica se i due oggetti sono uguali.
Funzione di confronto.
toJSON
toJSON()
Parametri: nessuno
Valore restituito:Orientation3DLiteral
Consente di convertire in rappresentazione JSON. Questa funzione è progettata per essere utilizzata tramite JSON.stringify.

Interfaccia Orientation3DLiteral

google.maps.Orientation3DLiteral interfaccia

Per comodità, in molti casi vengono accettati i valori letterali degli oggetti al posto degli oggetti Orientation3D. Questi vengono convertiti in oggetti Orientation3D quando l'API Maps li rileva.
heading optional
Tipo:  number optional
Rotazione attorno all'asse z (perpendicolare alla superficie terrestre). Un valore pari a 0 (il valore predefinito) corrisponde a Nord. Una rotazione positiva avviene in senso orario attorno all'asse z e viene specificata in gradi da 0 a 360.
roll optional
Tipo:  number optional
Rotazione attorno all'asse Y. Una rotazione positiva avviene in senso orario attorno all'asse Y e viene specificata in gradi da 0 a 360.
tilt optional
Tipo:  number optional
Rotazione attorno all'asse X. Una rotazione positiva avviene in senso orario attorno all'asse x e viene specificata in gradi da 0 a 360.

Classe Vector3D

google.maps.Vector3D corso

Un Vector3D è un vettore tridimensionale utilizzato per operazioni matematiche standard come la scalatura dei limiti di un oggetto tridimensionale lungo gli assi x, y e z locali.

  • x è un numero reale.
  • y è un numero reale.
  • z è un numero reale.

Questa classe implementa Vector3DLiteral.

Accedi chiamando const {Vector3D} = await google.maps.importLibrary("core"). Consulta la sezione Librerie nell'API Maps JavaScript.
Vector3D
Vector3D(value)
Parametri: 
x
Tipo:  number
Componente X del vettore tridimensionale.
y
Tipo:  number
Componente Y del vettore tridimensionale.
z
Tipo:  number
Componente Z del vettore tridimensionale.
equals
equals(other)
Parametri: 
Valore restituito:boolean
Funzione di confronto.
toJSON
toJSON()
Parametri: nessuno
Valore restituito:Vector3DLiteral
Consente di convertire in rappresentazione JSON. Questa funzione è progettata per essere utilizzata tramite JSON.stringify.

Interfaccia Vector3DLiteral

google.maps.Vector3DLiteral interfaccia

Per comodità, in molti casi vengono accettati i valori letterali degli oggetti al posto degli oggetti Vector3D. Questi vengono convertiti in oggetti Vector3D quando l'API Maps li rileva.
x
Tipo:  number
Componente X del vettore tridimensionale.
y
Tipo:  number
Componente Y del vettore tridimensionale.
z
Tipo:  number
Componente Z del vettore tridimensionale.