Annuncio: i nuovi stili delle mappe base saranno presto disponibili su Google Maps Platform. Questo aggiornamento dello stile della mappa include una nuova tavolozza dei colori predefinita, segnaposto moderni e miglioramenti alle esperienze sulla mappa e all'usabilità. Tutti gli stili di mappa verranno aggiornati automaticamente a marzo 2025. Per ulteriori informazioni sulla disponibilità e su come attivare in anteprima la funzionalità, consulta Nuovo stile di mappa per Google Maps Platform.

Questa pagina è stata tradotta dall'API Cloud Translation.

Geometry Library

encoding spazio dei nomi

google.maps.geometry.encoding spazio dei nomi

Utilità per la codifica e la decodifica delle polilinee.

Accedi chiamando const {encoding} = await google.maps.importLibrary("geometry"). Consulta la sezione Librerie nell'API Maps JavaScript.

Metodi statici
`decodePath`	`decodePath(encodedPath)` Parametri: `encodedPath`: `string` Valore restituito: `Array<LatLng>` Decodifica una stringa di percorso codificata in una sequenza di LatLng.
`encodePath`	`encodePath(path)` Parametri: `path`: `Array<LatLng\|LatLngLiteral>\|MVCArray<LatLng\|LatLngLiteral>` Valore restituito: `string` Codifica una sequenza di LatLng in una stringa di percorso codificata.

spazio dei nomi sferico

google.maps.geometry.spherical spazio dei nomi

Funzioni di utilità per il calcolo di angoli, distanze e aree geodetiche. Il raggio predefinito è quello della Terra di 6378137 metri.

Accedi chiamando const {spherical} = await google.maps.importLibrary("geometry"). Consulta la sezione Librerie nell'API Maps JavaScript.

Metodi statici
`computeArea`	`computeArea(path[, radiusOfSphere])` Parametri: `path`: `Array<LatLng\|LatLngLiteral>\|MVCArray<LatLng\|LatLngLiteral>\|Circle\|CircleLiteral\|LatLngBounds\|LatLngBoundsLiteral` `radiusOfSphere`: `number optional` Valore restituito: `number` Restituisce l'area non firmata di un percorso chiuso, nell'intervallo [0, 2xpixraggio2]. L'area calcolata utilizza le stesse unità del raggio. `radiusOfSphere` per impostazione predefinita mostra il raggio della Terra in metri, nel qual caso l'area è in metri quadrati. Per trasmettere un valore `Circle`, è necessario impostare un valore non negativo per `radius`. Inoltre, il cerchio non deve coprire più del 100% della sfera. Inoltre, passando una `LatLngBounds`, il LatLng meridionale non può trovarsi più a nord del LatLng settentrionale.
`computeDistanceBetween`	`computeDistanceBetween(from, to[, radius])` Parametri: `from`: `LatLng\|LatLngLiteral` `to`: `LatLng\|LatLngLiteral` `radius`: `number optional` Valore restituito: `number` Restituisce la distanza, in metri, tra due LatLng. Se vuoi, puoi specificare un raggio personalizzato. Per impostazione predefinita, il raggio corrisponde al raggio della Terra.
`computeHeading`	`computeHeading(from, to)` Parametri: `from`: `LatLng\|LatLngLiteral` `to`: `LatLng\|LatLngLiteral` Valore restituito: `number` Restituisce l'intestazione da un LatLng a un altro LatLng. Le intestazioni sono espresse in gradi in senso orario a partire da Nord entro l'intervallo [-180,180).
`computeLength`	`computeLength(path[, radius])` Parametri: `path`: `Array<LatLng\|LatLngLiteral>\|MVCArray<LatLng\|LatLngLiteral>` `radius`: `number optional` Valore restituito: `number` Restituisce la lunghezza del percorso specificato.
`computeOffset`	`computeOffset(from, distance, heading[, radius])` Parametri: `from`: `LatLng\|LatLngLiteral` `distance`: `number` `heading`: `number` `radius`: `number optional` Valore restituito: `LatLng` Restituisce il LatLng risultante dallo spostamento di una distanza da un'origine nell'intestazione specificata (espressa in gradi in senso orario da nord).
`computeOffsetOrigin`	`computeOffsetOrigin(to, distance, heading[, radius])` Parametri: `to`: `LatLng\|LatLngLiteral` `distance`: `number` `heading`: `number` `radius`: `number optional` Valore restituito: `LatLng\|null` Restituisce la posizione di origine se viene fornita una destinazione LatLng, i metri percorsi e l'intestazione originale. Le intestazioni sono espresse in gradi in senso orario a partire da nord. Questa funzione restituisce `null` quando non è disponibile alcuna soluzione.
`computeSignedArea`	`computeSignedArea(loop[, radius])` Parametri: `loop`: `Array<LatLng\|LatLngLiteral>\|MVCArray<LatLng\|LatLngLiteral>` `radius`: `number optional` Valore restituito: `number` Restituisce l'area firmata di un percorso chiuso, dove in senso antiorario è positivo, nell'intervallo [-2 × pi × raggio2, 2 × pi × raggio2]. L'area calcolata utilizza le stesse unità del raggio. Per impostazione predefinita, il raggio è il raggio della Terra in metri, nel qual caso l'area è in metri quadrati. L'area viene calcolata utilizzando il metodo del trasporto parallelo; il trasporto parallelo intorno a un percorso chiuso nella sfera unitaria ruota di un angolo pari all'area racchiusa dal percorso. Questa operazione è più semplice, precisa e robusta della triangolazione utilizzando Girard, l'Huilier o Eriksson su ciascun triangolo. In particolare, poiché non triangola, non subisce instabilità, eccetto nel caso inevitabile quando un bordo (non una diagonale) del poligono si estende per 180 gradi.
`interpolate`	`interpolate(from, to, fraction)` Parametri: `from`: `LatLng\|LatLngLiteral` `to`: `LatLng\|LatLngLiteral` `fraction`: `number` Valore restituito: `LatLng` Restituisce il LatLng che corrisponde alla frazione specificata della strada tra il LatLng di origine e il LatLng di destinazione.

poly spazio dei nomi

google.maps.geometry.poly spazio dei nomi

Funzioni di utilità per calcoli relativi a poligoni e polilinee.

Accedi chiamando const {poly} = await google.maps.importLibrary("geometry"). Consulta la sezione Librerie nell'API Maps JavaScript.

Metodi statici
`containsLocation`	`containsLocation(point, polygon)` Parametri: `point`: `LatLng\|LatLngLiteral` `polygon`: `Polygon` Valore restituito: `boolean` Calcola se il punto specificato si trova all'interno del poligono specificato.
`isLocationOnEdge`	`isLocationOnEdge(point, poly[, tolerance])` Parametri: `point`: `LatLng\|LatLngLiteral` `poly`: `Polygon\|Polyline` `tolerance`: `number optional` Valore restituito: `boolean` Calcola se il punto specificato si trova sopra o vicino a una polilinea o al bordo di un poligono, entro una tolleranza specificata. Restituisce `true` quando la differenza tra la latitudine e la longitudine del punto specificato e il punto più vicino sul bordo è inferiore alla tolleranza. Il valore predefinito di tolleranza è 10^-9 gradi.

Metodi statici

containsLocation

containsLocation(point, polygon)

Parametri:

point: LatLng|LatLngLiteral
polygon: Polygon

Valore restituito: boolean

Calcola se il punto specificato si trova all'interno del poligono specificato.

isLocationOnEdge

isLocationOnEdge(point, poly[, tolerance])

Parametri:

point: LatLng|LatLngLiteral
poly: Polygon|Polyline
tolerance: number optional

Valore restituito: boolean

Calcola se il punto specificato si trova sopra o vicino a una polilinea o al bordo di un poligono, entro una tolleranza specificata. Restituisce true quando la differenza tra la latitudine e la longitudine del punto specificato e il punto più vicino sul bordo è inferiore alla tolleranza. Il valore predefinito di tolleranza è 10^-9 gradi.