Coordinates

Classe LatLng

google.maps.LatLng libreria di
classi "core"

Un LatLng è un punto in 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, verrà impostato su 90.
• La longitudine è compresa tra -180 e 180 gradi inclusi. I valori superiori o inferiori a questo intervallo verranno adattati in modo da rientrare nell'intervallo. Ad esempio, un valore di -190 verrà convertito in 170. Un valore di 190 verrà convertito in -170. Ciò 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, 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 accettano 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 LatLng, viene creata una copia.

Le possibili chiamate al costruttore sono le seguenti:

 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);
 

const {LatLng} = await google.maps.importLibrary("core");

Costruttore

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.

Metodi
equals	equals(other) Parametri: other: LatLng|LatLngLiteral optional Valore restituito: boolean Funzione di confronto per due LatLng. Restituisce true se le coordinate sono entro 1e-9 l'una dall'altra, altrimenti false.
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 nella rappresentazione JSON. Questa funzione è destinata a 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 nel formato "lat,lng" per questo LatLng. Per impostazione predefinita, arrotondiamo i valori di latitudine/longitudine a 6 cifre decimali.

Interfaccia LatLngLiteral

Interfaccia google.maps.LatLngLiteral

In molti casi, gli oggetti letterali sono accettati al posto degli oggetti LatLng, per comodità. 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}); 

Gli oggetti letterali 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 aggregati in modo da rientrare nell'intervallo. Ad esempio, un valore di -190 verrà convertito in 170. Un valore di 190 verrà convertito in -170. Ciò riflette il fatto che le longitudini avvolgono il globo.

Classe LatLngBounds

google.maps.LatLngBounds libreria di
classi "core"

Un'istanza LatLngBounds rappresenta un rettangolo in coordinate geografiche, incluso uno che attraversa il meridiano longitudinale di 180 gradi.

const {LatLngBounds} = await google.maps.importLibrary("core");

Costruttore
LatLngBounds	LatLngBounds([swOrLatLngBounds, ne]) Parametri: swOrLatLngBounds: LatLng|LatLngLiteral|LatLngBounds|LatLngBoundsLiteral optional ne: LatLng|LatLngLiteral optional Crea un rettangolo dai punti negli 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: latLng: LatLng|LatLngLiteral Valore restituito: boolean Restituisce true se la latitudine/longitudine specificata rientra in questi limiti.
equals	equals(other) Parametri: other: LatLngBounds|LatLngBoundsLiteral optional Valore restituito: boolean Restituisce true se questi limiti sono approssimativamente uguali ai limiti specificati.
extend	extend(point) Parametri: point: LatLng|LatLngLiteral Valore restituito: LatLngBounds Estende questi limiti 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: other: LatLngBounds|LatLngBoundsLiteral 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 Converte nella 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 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 questi limiti, dove "lo" corrisponde all'angolo sud-ovest del riquadro di delimitazione, mentre "hi" corrisponde all'angolo nord-est di quel riquadro.
union	union(other) Parametri: other: LatLngBounds|LatLngBoundsLiteral Valore restituito: LatLngBounds Estende questi limiti in modo da contenere l'unione di questi e dei limiti specificati.

Interfaccia LatLngBoundsLiteral

Interfaccia google.maps.LatLngBoundsLiteral

Gli oggetti letterali sono accettati al posto degli oggetti LatLngBounds nell'API. Questi vengono convertiti automaticamente in oggetti LatLngBounds. Tutti i valori south, west, north e east devono essere impostati, altrimenti viene generata un'eccezione.

Proprietà
east	Tipo: number Longitudine est in gradi. I valori al di fuori dell'intervallo [-180, 180] verranno inseriti nell'intervallo [-180, 180). Ad esempio, un valore di -190 verrà convertito in 170. Un valore di 190 verrà convertito in -170. Ciò 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 inseriti nell'intervallo [-180, 180). Ad esempio, un valore di -190 verrà convertito in 170. Un valore di 190 verrà convertito in -170. Ciò riflette il fatto che le longitudini avvolgono il globo.

Classe LatLngAltitude

google.maps.LatLngAltitude classe
implementa LatLngAltitudeLiteral, LatLngLiteral
libreria "core"

Un LatLngAltitude è un punto 3D in 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, verrà impostato su 90.
• La longitudine è compresa tra -180 e 180 gradi inclusi. I valori superiori o inferiori a questo intervallo verranno adattati in modo da rientrare nell'intervallo. Ad esempio, un valore di -190 verrà convertito in 170. Un valore di 190 verrà convertito in -170. Ciò riflette il fatto che le longitudini avvolgono 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.

const {LatLngAltitude} = await google.maps.importLibrary("core");

Costruttore

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 blocco della latitudine e l'avvolgimento della longitudine.

Proprietà
altitude readonly	Tipo: number Restituisce l'altitudine.
lat readonly	Tipo: number Restituisce la latitudine.
lng readonly	Tipo: number Restituisce la longitudine.

Metodi
equals	equals(other) Parametri: other: LatLngAltitude|LatLngAltitudeLiteral optional Un altro oggetto LatLngAltitude. Valore restituito: boolean Indica se i due oggetti sono uguali. Funzione di confronto per due LatLngAltitude. Restituisce true se le coordinate sono entro 1e-9 l'una dall'altra, altrimenti false.
toJSON	toJSON([key]) Parametri: key: string optional Valore restituito: LatLngAltitudeLiteral Converte in un oggetto semplice.

Interfaccia LatLngAltitudeLiteral

google.maps.LatLngAltitudeLiteral interface
extends LatLngLiteral

In molti casi, gli oggetti letterali sono accettati al posto degli oggetti LatLngAltitude, per comodità. Questi vengono convertiti in oggetti LatLngAltitude quando l'API di Google Maps li rileva.

Proprietà
altitude	Tipo: number Distanza (in metri) dalla superficie del suolo. Un valore negativo indica che 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 aggregati in modo da rientrare nell'intervallo. Ad esempio, un valore di -190 verrà convertito in 170. Un valore di 190 verrà convertito in -170. Ciò riflette il fatto che le longitudini avvolgono il globo.

Classe Point

google.maps.Point libreria di
classi "core"

const {Point} = await google.maps.importLibrary("core");

Costruttore
Point	Point(x, y) Parametri: x: number y: number Un punto su un piano bidimensionale.

Proprietà
x	Tipo: number La coordinata X
y	Tipo: number La coordinata Y

Metodi
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 Size

google.maps.Size libreria di
classi "core"

const {Size} = await google.maps.importLibrary("core");

Costruttore
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.

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: other: Size optional Valore restituito: boolean Confronta due dimensioni.
toString	toString() Parametri: nessuno Valore restituito: string Restituisce una rappresentazione di stringa di questa dimensione.

Interfaccia di padding

Interfaccia google.maps.Padding

Proprietà
bottom facoltativo	Tipo: number optional Spaziatura interna per la parte inferiore, in pixel.
left facoltativo	Tipo: number optional Spaziatura interna a sinistra, in pixel.
right facoltativo	Tipo: number optional Spaziatura interna per il lato destro, in pixel.
top facoltativo	Tipo: number optional Spaziatura interna superiore in pixel.

Interfaccia CircleLiteral

google.maps.CircleLiteral interface
extends CircleOptions

Oggetto letterale che rappresenta un cerchio.

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 classe
implementa Orientation3DLiteral
libreria "core"

Un Orientation3D è un vettore tridimensionale utilizzato per le trasformazioni di rotazione matematica standard lungo direzione, inclinazione e rollio.

• heading è un angolo compreso nell'intervallo [0, 360) gradi.
• tilt è un angolo compreso nell'intervallo [0, 360) gradi.
• Il rollio è un angolo compreso nell'intervallo [0, 360) gradi.

const {Orientation3D} = await google.maps.importLibrary("core");

Costruttore
Orientation3D	Orientation3D(value) Parametri: value: Orientation3D|Orientation3DLiteral il valore di inizializzazione.

Proprietà
heading readonly	Tipo: number Valore predefinito: 0 Rotazione attorno all'asse Z (perpendicolare alla superficie terrestre). Un valore pari a 0 (valore predefinito) equivale a Nord. Una rotazione positiva è in senso orario attorno all'asse Z ed è specificata in gradi da 0 a 360. I valori superiori o inferiori a questo intervallo verranno adattati in modo da rientrare nell'intervallo. Ad esempio, un valore di -190 verrà convertito in 170. Anche un valore di 530 verrà convertito in 170.
roll readonly	Tipo: number Valore predefinito: 0 Rotazione attorno all'asse Y. Una rotazione positiva è in senso orario attorno all'asse Y ed è specificata in gradi da 0 a 360. I valori superiori o inferiori a questo intervallo verranno adattati in modo da rientrare nell'intervallo. Ad esempio, un valore di -190 verrà convertito in 170. Anche un valore di 530 verrà convertito in 170.
tilt readonly	Tipo: number Valore predefinito: 0 Rotazione attorno all'asse X. Una rotazione positiva è in senso orario attorno all'asse X ed è specificata in gradi da 0 a 360. I valori superiori o inferiori a questo intervallo verranno adattati in modo da rientrare nell'intervallo. Ad esempio, un valore di -190 verrà convertito in 170. Anche un valore di 530 verrà convertito in 170.

Metodi
equals	equals(other) Parametri: other: Orientation3D|Orientation3DLiteral optional un altro oggetto Orientation3D. Valore restituito: boolean Indica se i due oggetti sono uguali. Funzione di confronto.
toJSON	toJSON([key]) Parametri: key: string optional Valore restituito: Orientation3DLiteral Converte in un oggetto semplice.

Interfaccia Orientation3DLiteral

Interfaccia google.maps.Orientation3DLiteral

In molti casi, gli oggetti letterali sono accettati al posto degli oggetti Orientation3D, per comodità. Questi vengono convertiti in oggetti Orientation3D quando l'API di Google Maps li rileva.

Proprietà
heading facoltativo	Tipo: number optional Rotazione attorno all'asse Z (perpendicolare alla superficie terrestre). Un valore pari a 0 (valore predefinito) equivale a Nord. Una rotazione positiva è in senso orario attorno all'asse Z ed è specificata in gradi da 0 a 360.
roll facoltativo	Tipo: number optional Rotazione attorno all'asse Y. Una rotazione positiva è in senso orario attorno all'asse Y ed è specificata in gradi da 0 a 360.
tilt facoltativo	Tipo: number optional Rotazione attorno all'asse X. Una rotazione positiva è in senso orario attorno all'asse X ed è specificata in gradi da 0 a 360.

Classe Vector3D

google.maps.Vector3D classe
implementa Vector3DLiteral
libreria "core"

Un Vector3D è un vettore tridimensionale utilizzato per operazioni matematiche standard, come il ridimensionamento 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.

const {Vector3D} = await google.maps.importLibrary("core");

Costruttore
Vector3D	Vector3D(value) Parametri: value: Vector3D|Vector3DLiteral il valore di inizializzazione.

Proprietà
x readonly	Tipo: number Componente X del vettore tridimensionale.
y readonly	Tipo: number Componente Y del vettore tridimensionale.
z readonly	Tipo: number Componente Z del vettore tridimensionale.

Metodi
equals	equals(other) Parametri: other: Vector3D|Vector3DLiteral optional un altro oggetto Vector3D o Vector3DLiteral. Valore restituito: boolean Funzione di confronto.
toJSON	toJSON([key]) Parametri: key: string optional Valore restituito: Vector3DLiteral Converte in un oggetto semplice.

Interfaccia Vector3DLiteral

Interfaccia google.maps.Vector3DLiteral

In molti casi, gli oggetti letterali sono accettati al posto degli oggetti Vector3D, per comodità. Questi vengono convertiti in oggetti Vector3D quando l'API di Google 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.