Powiadomienie dotyczące bezpieczeństwa: dowiedzieliśmy się o problemie z bezpieczeństwem, który może wpływać na witryny korzystające z określonych bibliotek innych firm (w tym polyfill.io). Ten problem może czasem powodować przekierowanie użytkowników z innej witryny bez wiedzy i zgody właściciela witryny. Wiele przykładów JavaScriptu zawierało wcześniej deklarację skryptu polyfill.io. Usunęliśmy go z naszych próbek. Jeśli korzystasz z przykładowych skryptów JavaScript, które zawierają tę deklarację, zalecamy jej usunięcie.

Ta strona została przetłumaczona przez Cloud Translation API.

Geometry Library

kodowanie przestrzeni nazw

google.maps.geometry.encoding przestrzeń nazw

Narzędzia do kodowania i dekodowania linii łamanych.

Aby uzyskać dostęp, zadzwoń pod numer const {encoding} = await google.maps.importLibrary("geometry"). Zobacz Biblioteki w interfejsie Maps JavaScript API.

Metody statyczne
`decodePath`	`decodePath(encodedPath)` Parametry: `encodedPath`: `string` Wartość zwrotu: `Array<LatLng>` Dekoduje zakodowany ciąg ścieżki do postaci sekwencji współrzędnych geograficznych.
`encodePath`	`encodePath(path)` Parametry: `path`: `Array<LatLng\|LatLngLiteral>\|MVCArray<LatLng\|LatLngLiteral>` Wartość zwrotu: `string` Koduje sekwencję latLng w zakodowanym ciągu ścieżki.

sferyczna przestrzeń nazw

google.maps.geometry.spherical przestrzeń nazw

Funkcje użytkowe do obliczania kątów, odległości i powierzchni geodezyjnych. Domyślny promień to 6378137 metrów.

Aby uzyskać dostęp, zadzwoń pod numer const {spherical} = await google.maps.importLibrary("geometry"). Zobacz Biblioteki w interfejsie Maps JavaScript API.

Metody statyczne
`computeArea`	`computeArea(path[, radiusOfSphere])` Parametry: `path`: `Array<LatLng\|LatLngLiteral>\|MVCArray<LatLng\|LatLngLiteral>\|Circle\|CircleLiteral\|LatLngBounds\|LatLngBoundsLiteral` `radiusOfSphere`: `number optional` Wartość zwrotu: `number` Zwraca niepodpisany obszar zamkniętej ścieżki z zakresu [0, 2 × pi × promień2]. W obliczonym obszarze używane są te same jednostki co promień. W polu `radiusOfSphere` domyślnie podany jest promień Ziemi w metrach, czyli w metrach kwadratowych. Zaliczenie parametru `Circle` wymaga ustawienia w elemencie `radius` wartości nieujemnej. Poza tym okrąg nie może pokrywać więcej niż 100% kuli. Szerokość geograficzna (`LatLngBounds`) nie może być bardziej położona na północ niż północna północ.
`computeDistanceBetween`	`computeDistanceBetween(from, to[, radius])` Parametry: `from`: `LatLng\|LatLngLiteral` `to`: `LatLng\|LatLngLiteral` `radius`: `number optional` Wartość zwrotu: `number` Zwraca odległość (w metrach) między dwoma wymiarami położenia geograficznego. Opcjonalnie możesz podać promień niestandardowy. Domyślnie ustawiony jest promień Ziemi.
`computeHeading`	`computeHeading(from, to)` Parametry: `from`: `LatLng\|LatLngLiteral` `to`: `LatLng\|LatLngLiteral` Wartość zwrotu: `number` Zwraca nagłówek z jednej szerokości geograficznej na inną. Nagłówki są wyrażone w stopniach w prawo od północy i w zakresie [-180 180).
`computeLength`	`computeLength(path[, radius])` Parametry: `path`: `Array<LatLng\|LatLngLiteral>\|MVCArray<LatLng\|LatLngLiteral>` `radius`: `number optional` Wartość zwrotu: `number` Zwraca długość podanej ścieżki.
`computeOffset`	`computeOffset(from, distance, heading[, radius])` Parametry: `from`: `LatLng\|LatLngLiteral` `distance`: `number` `heading`: `number` `radius`: `number optional` Wartość zwrotu: `LatLng` Zwraca współrzędne geograficzne wynikające z odległości od punktu początkowego w określonym kierunku (wyrażona w stopniach w prawo, z kierunku północnego).
`computeOffsetOrigin`	`computeOffsetOrigin(to, distance, heading[, radius])` Parametry: `to`: `LatLng\|LatLngLiteral` `distance`: `number` `heading`: `number` `radius`: `number optional` Wartość zwrotu: `LatLng\|null` Zwraca lokalizację miejsca wylotu w przypadku podania miejsca docelowego położenia geograficznego, przebytych metrów i pierwotnego nagłówka. Nagłówki są wyrażone w stopniach w kierunku zgodnym z ruchem wskazówek zegara, od kierunku północnego. Gdy nie jest dostępne rozwiązanie, ta funkcja zwraca wartość `null`.
`computeSignedArea`	`computeSignedArea(loop[, radius])` Parametry: `loop`: `Array<LatLng\|LatLngLiteral>\|MVCArray<LatLng\|LatLngLiteral>` `radius`: `number optional` Wartość zwrotu: `number` Zwraca podpisany obszar zamkniętej ścieżki, gdzie w kierunku przeciwnym do ruchu wskazówek zegara jest dodatnia wartość z zakresu [-2×pi×promień2, 2×pi×promień2]. W obliczonym obszarze używane są te same jednostki co promień. Promień jest domyślnie podawany jako promień Ziemi w metrach, czyli w metrach kwadratowych. Powierzchnia jest obliczana za pomocą transportu równoległego. Ruch równoległy wokół zamkniętej ścieżki na sferze jednostkowej skręca kąt równy powierzchni znajdującej się na ścieżce. Jest to prostsze i bardziej dokładne oraz wytrzymałe niż triangulacja z użyciem Girarda, l'Huiliera lub Erikssona na każdym trójkącie. Ponieważ wielokąt nie jest triangulowany, nie ulega on niestabilności poza nieuniknionym przypadkiem, gdy krawędź (nie ukośna) wielokąta ma długość 180 stopni.
`interpolate`	`interpolate(from, to, fraction)` Parametry: `from`: `LatLng\|LatLngLiteral` `to`: `LatLng\|LatLngLiteral` `fraction`: `number` Wartość zwrotu: `LatLng` Zwraca współrzędne geograficzne, w których znajduje się podana długość trasy między położeniami geograficznymi (latLng) a miejscem docelowym (LatLng).

poly przestrzeń nazw

google.maps.geometry.poly przestrzeń nazw

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

Aby uzyskać dostęp, zadzwoń pod numer const {poly} = await google.maps.importLibrary("geometry"). Zobacz Biblioteki w interfejsie Maps JavaScript API.

Metody statyczne
`containsLocation`	`containsLocation(point, polygon)` Parametry: `point`: `LatLng\|LatLngLiteral` `polygon`: `Polygon` Wartość zwrotu: `boolean` Oblicza, czy dany punkt leży wewnątrz określonego wielokąta.
`isLocationOnEdge`	`isLocationOnEdge(point, poly[, tolerance])` Parametry: `point`: `LatLng\|LatLngLiteral` `poly`: `Polygon\|Polyline` `tolerance`: `number optional` Wartość zwrotu: `boolean` Oblicza, czy dany punkt leży na linii łamanej lub krawędzi wielokąta, przy zachowaniu określonej tolerancji. Zwraca `true`, gdy różnica między długością i szerokością geograficzną podanego punktu a najbliższym punktem na krawędzi jest mniejsza niż tolerancja. Domyślna tolerancja wynosi 10^–9 stopni.

Metody statyczne

containsLocation

containsLocation(point, polygon)

Parametry:

point: LatLng|LatLngLiteral
polygon: Polygon

Wartość zwrotu: boolean

Oblicza, czy dany punkt leży wewnątrz określonego wielokąta.

isLocationOnEdge

isLocationOnEdge(point, poly[, tolerance])

Parametry:

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

Wartość zwrotu: boolean

Oblicza, czy dany punkt leży na linii łamanej lub krawędzi wielokąta, przy zachowaniu określonej tolerancji. Zwraca true, gdy różnica między długością i szerokością geograficzną podanego punktu a najbliższym punktem na krawędzi jest mniejsza niż tolerancja. Domyślna tolerancja wynosi 10^–9 stopni.