Geometry Library

Spazio dei nomi encoding

namespace google.maps.geometry.encoding
library "geometry"

Utilità per la codifica e la decodifica delle polilinee.

const {encoding} = await google.maps.importLibrary("geometry");
decodePath
decodePath(encodedPath)
Parametri:
  • encodedPath: string
Valore restituito: Array<LatLng>
Decodifica una stringa di percorso codificata in una sequenza di LatLng.
encodePath
encodePath(path)
Valore restituito: string
Codifica una sequenza di LatLng in una stringa di percorso codificata.

Spazio dei nomi spherical

namespace google.maps.geometry.spherical
library "geometry"

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

const {spherical} = await google.maps.importLibrary("geometry");
computeArea
computeArea(path[, radiusOfSphere])
Valore restituito: number
Restituisce l'area non firmata di un percorso chiuso, nell'intervallo [0, 2×pi×radius²]. L'area calcolata utilizza le stesse unità del raggio. Il valore predefinito di radiusOfSphere è il raggio della Terra in metri, nel qual caso l'area è in metri quadrati. Per passare un Circle, è necessario impostare radius su un valore non negativo. Inoltre, il cerchio non deve coprire più del 100% della sfera. Quando passi un LatLngBounds, la latitudine e la longitudine meridionali non possono essere più a nord della latitudine e della longitudine settentrionali.
computeDistanceBetween
computeDistanceBetween(from, to[, radius])
Parametri:
Valore restituito: number
Restituisce la distanza, in metri, tra due LatLng. Facoltativamente, puoi specificare un raggio personalizzato. Il raggio predefinito è quello della Terra.
computeHeading
computeHeading(from, to)
Valore restituito: number
Restituisce la direzione da un LatLng a un altro LatLng. Le direzioni sono espresse in gradi in senso orario rispetto al nord nell'intervallo [-180,180).
computeLength
computeLength(path[, radius])
Parametri:
Valore restituito: number
Restituisce la lunghezza del percorso specificato.
computeOffset
computeOffset(from, distance, heading[, radius])
Parametri:
Valore restituito: LatLng
Restituisce il valore LatLng risultante dallo spostamento di una distanza da un'origine nella direzione specificata (espressa in gradi in senso orario rispetto al nord).
computeOffsetOrigin
computeOffsetOrigin(to, distance, heading[, radius])
Parametri:
Valore restituito: LatLng|null
Restituisce la posizione di origine quando vengono forniti una destinazione LatLng, i metri percorsi e la direzione originale. Le direzioni sono espresse in gradi in senso orario rispetto al nord. Questa funzione restituisce null quando non è disponibile alcuna soluzione.
computeSignedArea
computeSignedArea(loop[, radius])
Parametri:
Valore restituito: number
Restituisce l'area con segno di un percorso chiuso, dove il senso antiorario è positivo, nell'intervallo [-2×pi×raggio², 2×pi×raggio²]. L'area calcolata utilizza le stesse unità del raggio. Per impostazione predefinita, il raggio corrisponde al raggio della Terra in metri, nel qual caso l'area è espressa in metri quadrati.

L'area viene calcolata utilizzando il metodo del trasporto parallelo; il trasporto parallelo attorno a un percorso chiuso sulla sfera unitaria si attorciglia di un angolo pari all'area racchiusa dal percorso. Questo metodo è più semplice, preciso e affidabile rispetto alla triangolazione che utilizza Girard, l'Huilier o Eriksson su ogni triangolo. In particolare, poiché non triangola, non soffre di instabilità, tranne nel caso inevitabile in cui un bordo (non una diagonale) del poligono si estende per 180 gradi.
interpolate
interpolate(from, to, fraction)
Parametri:
Valore restituito: LatLng
Restituisce l'oggetto LatLng che si trova nella frazione specificata del percorso tra l'oggetto LatLng di origine e l'oggetto LatLng di destinazione.
AlphatraversePath
traversePath(path, fraction)
Parametri:
Valore restituito: LatLngLiteral
Restituisce la posizione che si trova nella frazione specificata del percorso specificato. Se vengono passati oggetti LatLngAltitude, l'altitudine viene attualmente ignorata, ma le versioni future potrebbero tenerne conto.

Spazio dei nomi poly

namespace google.maps.geometry.poly
library "geometry"

Funzioni di utilità per i calcoli che coinvolgono poligoni e polilinee.

const {poly} = await google.maps.importLibrary("geometry");
containsLocation
containsLocation(point, polygon)
Parametri:
Valore restituito: boolean
Calcola se il punto specificato si trova all'interno del poligono o del cerchio specificato. Il passaggio di un Circle richiede l'impostazione di center e l'impostazione di radius su un valore non negativo.
isLocationOnEdge
isLocationOnEdge(point, poly[, tolerance])
Parametri:
Valore restituito: boolean
Calcola se il punto specificato si trova su 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 fornito e il punto più vicino sul bordo è inferiore alla tolleranza. La tolleranza predefinita è 10-9 gradi.