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.

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

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:  swOrLatLngBounds:  LatLng|LatLngLiteral|LatLngBounds|LatLngBoundsLiteral optional ne:  LatLng|LatLngLiteral optional 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:  latLng:  LatLng|LatLngLiteral Valore restituito:boolean Restituisce true se lat/lng specificati rientrano in questi limiti.
equals	equals(other) Parametri:  other:  LatLngBounds|LatLngBoundsLiteral optional Valore restituito:boolean Restituisce true se questi limiti sono approssimativamente uguali a quelli specificati.
extend	extend(point) Parametri:  point:  LatLng|LatLngLiteral 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:  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 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:  other:  LatLngBounds|LatLngBoundsLiteral 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:  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.

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

Metodi
equals	equals(other) Parametri:  other:  LatLngAltitude optional Un altro oggetto LatLngAltitude. 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:  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 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:  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 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