Geometry Library

encoding namespace

google.maps.geometry.encoding przestrzeń nazw
biblioteka "geometry"

Narzędzia do kodowania i dekodowania linii łamanych.

const {encoding} = await google.maps.importLibrary("geometry");
decodePath
decodePath(encodedPath)
Parametry:
  • encodedPath: string
Wartość zwracana: Array<LatLng>
Dekoduje zakodowany ciąg znaków ścieżki na sekwencję współrzędnych LatLng.
encodePath
encodePath(path)
Parametry:
Wartość zwracana: string
Koduje sekwencję LatLngs w zakodowany ciąg znaków ścieżki.

Przestrzeń nazw spherical

google.maps.geometry.spherical przestrzeń nazw
biblioteka "geometry"

Funkcje użytkowe do obliczania kątów, odległości i obszarów geodezyjnych. Domyślny promień to promień Ziemi, czyli 6 378 137 metrów.

const {spherical} = await google.maps.importLibrary("geometry");
computeArea
computeArea(path[, radiusOfSphere])
Parametry:
Wartość zwracana: number
Zwraca niepodpisany obszar zamkniętej ścieżki w zakresie [0, 2×pi×promień²]. Obliczony obszar używa tych samych jednostek co promień. Domyślna wartość radiusOfSphere to promień Ziemi w metrach, w którym to przypadku obszar jest podawany w metrach kwadratowych. Przekazanie parametru Circle wymaga ustawienia parametru radius na wartość nieujemną. Dodatkowo okrąg nie może pokrywać więcej niż 100% sfery. Podczas przekazywania obiektu LatLngBounds południowa szerokość i długość geograficzna nie może być bardziej na północ niż północna szerokość i długość geograficzna.
computeDistanceBetween
computeDistanceBetween(from, to[, radius])
Parametry:
Wartość zwracana: number
Zwraca odległość w metrach między 2 współrzędnymi LatLng. Opcjonalnie możesz określić niestandardowy promień. Domyślnie promień jest równy promieniowi Ziemi.
computeHeading
computeHeading(from, to)
Parametry:
Wartość zwracana: number
Zwraca kierunek od jednej współrzędnej LatLng do drugiej. Kierunki są wyrażone w stopniach w prawo od północy w zakresie [-180,180).
computeLength
computeLength(path[, radius])
Parametry:
Wartość zwracana: number
Zwraca długość podanej ścieżki.
computeOffset
computeOffset(from, distance, heading[, radius])
Parametry:
Wartość zwracana: LatLng
Zwraca współrzędne LatLng wynikające z przemieszczenia się o określoną odległość od punktu początkowego w określonym kierunku (wyrażonym w stopniach zgodnie z ruchem wskazówek zegara od północy).
computeOffsetOrigin
computeOffsetOrigin(to, distance, heading[, radius])
Parametry:
Wartość zwracana: LatLng|null
Zwraca lokalizację początkową, gdy podano współrzędne szerokości i długości geograficznej miejsca docelowego, przebytą odległość w metrach i pierwotny kierunek. Kierunki są wyrażone w stopniach zgodnie z ruchem wskazówek zegara, zaczynając od północy. Jeśli nie ma rozwiązania, ta funkcja zwraca wartość null.
computeSignedArea
computeSignedArea(loop[, radius])
Parametry:
Wartość zwracana: number
Zwraca pole powierzchni zamkniętej ścieżki, gdzie kierunek przeciwny do ruchu wskazówek zegara jest dodatni, w zakresie [-2×pi×promień², 2×pi×promień²]. Obliczone pole powierzchni używa tych samych jednostek co promień. Domyślnie promień jest promieniem Ziemi w metrach, a obszar jest podawany w metrach kwadratowych.

Obszar jest obliczany przy użyciu metody przesunięcia równoległego. Przesunięcie równoległe wokół zamkniętej ścieżki na sferze jednostkowej skręca o kąt równy obszarowi zamkniętemu przez ścieżkę. Jest to prostsze, dokładniejsze i bardziej niezawodne niż triangulacja z wykorzystaniem twierdzenia Girarda, l'Huiliera lub Erikssona w przypadku każdego trójkąta. W szczególności, ponieważ nie trianguluje, nie występuje w nim niestabilność, z wyjątkiem nieuniknionego przypadku, gdy krawędź (nie przekątna) wielokąta obejmuje 180 stopni.
interpolate
interpolate(from, to, fraction)
Parametry:
Wartość zwracana: LatLng
Zwraca współrzędne LatLng, które znajdują się w podanej części odległości między współrzędnymi LatLng punktu początkowego i docelowego.
AlphatraversePath
traversePath(path, fraction)
Parametry:
Wartość zwracana: LatLngLiteral
Zwraca pozycję, która znajduje się w określonej części drogi wzdłuż danej ścieżki. Jeśli przekazujesz obiekty LatLngAltitude, wysokość jest obecnie ignorowana, ale w przyszłych wersjach może być uwzględniana.

Przestrzeń nazw poly

google.maps.geometry.poly przestrzeń nazw
biblioteka "geometry"

Funkcje użytkowe do obliczeń obejmujących wielokąty i linie łamane.

const {poly} = await google.maps.importLibrary("geometry");
containsLocation
containsLocation(point, polygon)
Parametry:
Wartość zwracana: boolean
Oblicza, czy dany punkt znajduje się wewnątrz określonego wielokąta.
isLocationOnEdge
isLocationOnEdge(point, poly[, tolerance])
Parametry:
Wartość zwracana: boolean
Sprawdza, czy dany punkt leży na linii łamanej lub krawędzi wielokąta (albo w ich pobliżu) w ramach określonej tolerancji. Zwraca true, gdy różnica między szerokością i długością geograficzną podanego punktu a najbliższym punktem na krawędzi jest mniejsza niż tolerancja. Domyślna tolerancja wynosi 10-9 stopnia.