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.
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.
Costruttore | |
---|---|
LatLng |
LatLng(latOrLatLngOrLatLngLiteral[, lngOrNoClampNoWrap, noClampNoWrap]) Parametri:
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. |
Metodi | |
---|---|
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:
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.
Proprietà | |
---|---|
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.
Costruttore | |
---|---|
LatLngBounds |
LatLngBounds([swOrLatLngBounds, ne]) Parametri:
Costruisce un rettangolo dai punti agli angoli sud-ovest e nord-est. |
Costanti | |
---|---|
MAX_BOUNDS |
LatLngBounds per i limiti massimi della Terra. Questi limiti comprenderanno l'intero globo. |
Metodi | |
---|---|
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:
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.
Proprietà | |
---|---|
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.
Costruttore | |
---|---|
LatLngAltitude |
LatLngAltitude(value[, noClampNoWrap]) Parametri:
|
Proprietà | |
---|---|
altitude |
Tipo:
number Restituisce l'altitudine. |
lat |
Tipo:
number Restituisce la latitudine. |
lng |
Tipo:
number Restituisce la longitudine. |
Metodi | |
---|---|
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
.
Proprietà | |
---|---|
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.
Costruttore | |
---|---|
Point |
Point(x, y) Parametri:
Un punto su un piano bidimensionale. |
Proprietà | |
---|---|
x |
Tipo:
number La coordinata X |
y |
Tipo:
number La coordinata Y |
Metodi | |
---|---|
equals |
equals(other) Parametri:
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.
Costruttore | |
---|---|
Size |
Size(width, height[, widthUnit, heightUnit]) Parametri:
Dimensioni bidimensionali, dove la larghezza è la distanza sull'asse x e l'altezza è la distanza sull'asse y. |
Proprietà | |
---|---|
height |
Tipo:
number L'altezza lungo l'asse y, in pixel. |
width |
Tipo:
number La larghezza lungo l'asse x, in pixel. |
Metodi | |
---|---|
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
Proprietà | |
---|---|
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
.
Proprietà | |
---|---|
center |
Tipo:
LatLng|LatLngLiteral 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.
Costruttore | |
---|---|
Orientation3D |
Orientation3D(value) Parametri:
|
Proprietà | |
---|---|
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. |
Metodi | |
---|---|
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.
Proprietà | |
---|---|
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.
Costruttore | |
---|---|
Vector3D |
Vector3D(value) Parametri:
|
Proprietà | |
---|---|
x |
Tipo:
number Componente X del vettore tridimensionale. |
y |
Tipo:
number Componente Y del vettore tridimensionale. |
z |
Tipo:
number Componente Z del vettore tridimensionale. |
Metodi | |
---|---|
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.
Proprietà | |
---|---|
x |
Tipo:
number Componente X del vettore tridimensionale. |
y |
Tipo:
number Componente Y del vettore tridimensionale. |
z |
Tipo:
number Componente Z del vettore tridimensionale. |