Ogłoszenie: wkrótce w Google Maps Platform pojawi się nowy styl mapy podstawowej. Ta aktualizacja stylizacji mapy obejmuje nową domyślną paletę kolorów, ulepszone piny oraz udoskonalenia dotyczące użyteczności i wygody korzystania z map. Wszystkie style map zostaną automatycznie zaktualizowane w marcu 2025 r. Więcej informacji o dostępności i o tym, jak wcześniej włączyć tę funkcję, znajdziesz w artykule Nowy styl map w Google Maps Platform.

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

Geometry Library

kodowanie przestrzeni nazw

google.maps.geometry.encodingprzestrzeń nazw

Narzędzia do kodowania i dekodowania linii złożonych.

Dostęp przez połączenie telefoniczne const {encoding} = await google.maps.importLibrary("geometry"). Zobacz Biblioteki w Maps JavaScript API.

Metody statyczne
`decodePath`	`decodePath(encodedPath)` Parametry: `encodedPath`: `string` Wartość zwracana: `Array<LatLng>` Dekoduje zakodowany ciąg tekstowy ścieżki na sekwencję LatLngs.
`encodePath`	`encodePath(path)` Parametry: `path`: `Array<LatLng\|LatLngLiteral>\|MVCArray<LatLng\|LatLngLiteral>` Wartość zwracana: `string` Koduje sekwencję LatLngs w zakodowany ciąg znaków ścieżki.

spherical:

google.maps.geometry.sphericalprzestrzeń nazw

Funkcje pomocnicze do obliczania kątów geodezyjnych, odległości i powierzchni. Domyślny promień to promień Ziemi wynoszący 6378137 metrów.

Dostęp przez połączenie telefoniczne const {spherical} = await google.maps.importLibrary("geometry"). Zobacz Biblioteki w 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ść zwracana: `number` Zwraca bezwzględną powierzchnię zamkniętej ścieżki w zakresie [0, 2 × π × promień²]. Obliczona powierzchnia używa tych samych jednostek co promień. Wartość domyślna parametru `radiusOfSphere` to promień Ziemi w metrach, a powierzchnia jest podawana w metrach kwadratowych. Przekazywanie wartości `Circle` wymaga, aby wartość `radius` była nieujemna. Ponadto okrąg nie może zajmować więcej niż 100% powierzchni kuli. A podczas przechodzenia przez `LatLngBounds` południowa wartość LatLng nie może być bardziej na północ niż północna wartość LatLng.
`computeDistanceBetween`	`computeDistanceBetween(from, to[, radius])` Parametry: `from`: `LatLng\|LatLngLiteral` `to`: `LatLng\|LatLngLiteral` `radius`: `number optional` Wartość zwracana: `number` Zwraca odległość w metrach między 2 wartościami LatLng. Opcjonalnie możesz określić niestandardowy promień. Domyślny promień to promień Ziemi.
`computeHeading`	`computeHeading(from, to)` Parametry: `from`: `LatLng\|LatLngLiteral` `to`: `LatLng\|LatLngLiteral` Wartość zwracana: `number` Zwraca kierunek od jednego LatLng do drugiego LatLng. Kierunki są wyrażane w stopniach w prawo od północy w zakresie [-180,180].
`computeLength`	`computeLength(path[, radius])` Parametry: `path`: `Array<LatLng\|LatLngLiteral>\|MVCArray<LatLng\|LatLngLiteral>` `radius`: `number optional` Wartość zwracana: `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ść zwracana: `LatLng` Zwraca współrzędne LatLng otrzymane po przesunięciu się od punktu początkowego w określonym kierunku (wyrażonym w stopniach w kierunku zgodnym z ruchem wskazówek zegara od północy).
`computeOffsetOrigin`	`computeOffsetOrigin(to, distance, heading[, radius])` Parametry: `to`: `LatLng\|LatLngLiteral` `distance`: `number` `heading`: `number` `radius`: `number optional` Wartość zwracana: `LatLng\|null` Zwraca lokalizację źródłową, gdy podasz LatLng miejsca docelowego, przebyty dystans w metrach i pierwotny kierunek. Kierunki są wyrażane w stopniach w prawo od północy. Ta funkcja zwraca `null`, gdy nie ma dostępnych rozwiązań.
`computeSignedArea`	`computeSignedArea(loop[, radius])` Parametry: `loop`: `Array<LatLng\|LatLngLiteral>\|MVCArray<LatLng\|LatLngLiteral>` `radius`: `number optional` Wartość zwracana: `number` Zwraca podpisane pole ścieżki zamkniętej, gdzie ruch przeciwny do ruchu wskazówek zegara jest dodatni, w zakresie [-2 × π × promień², 2 × π × promień²]. Obliczone pole używa tych samych jednostek co promień. Domyślny promień to promień Ziemi w metrach, a powierzchnia jest podawana w metrach kwadratowych. Pole jest obliczane za pomocą metody przenoszenia równoległego; przenoszenie równoległe wzdłuż zamkniętej ścieżki na sferze jednostkowej powoduje skręcenie o kąt równy polu otoczonemu przez ścieżkę. Jest to prostsze, dokładniejsze i bardziej niezawodne niż triangulacja z wykorzystaniem metody Girarda, l'Huiliera lub Erikssona w przypadku każdego trójkąta. Ponieważ nie jest ona triangulowana, nie ma problemów ze stabilnością, z wyjątkiem nieuniknionego przypadku, gdy krawędzie (nie przekątna) wielokąta obejmują 180°.
`interpolate`	`interpolate(from, to, fraction)` Parametry: `from`: `LatLng\|LatLngLiteral` `to`: `LatLng\|LatLngLiteral` `fraction`: `number` Wartość zwracana: `LatLng` Zwraca współrzędne LatLng, które znajdują się w danej odległości od punktu początkowego LatLng do punktu docelowego LatLng.

Przestrzeń nazw poly

google.maps.geometry.polyprzestrzeń nazw

Funkcje pomocnicze do obliczeń dotyczących wielokątów i linii łamanych.

Dostęp przez połączenie telefoniczne const {poly} = await google.maps.importLibrary("geometry"). Zobacz Biblioteki w Maps JavaScript API.

Metody statyczne
`containsLocation`	`containsLocation(point, polygon)` Parametry: `point`: `LatLng\|LatLngLiteral` `polygon`: `Polygon` Wartość zwracana: `boolean` Oblicza, czy dany punkt znajduje się wewnątrz podanego wieloboku.
`isLocationOnEdge`	`isLocationOnEdge(point, poly[, tolerance])` Parametry: `point`: `LatLng\|LatLngLiteral` `poly`: `Polygon\|Polyline` `tolerance`: `number optional` Wartość zwracana: `boolean` Oblicza, czy podany punkt znajduje się na linii łamanej lub w pobliżu niej albo na krawędzi wielokąta w określonym zakresie 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 to 10^-9 stopni.

Metody statyczne

containsLocation

containsLocation(point, polygon)

Parametry:

point: LatLng|LatLngLiteral
polygon: Polygon

Wartość zwracana: boolean

Oblicza, czy dany punkt znajduje się wewnątrz podanego wieloboku.

isLocationOnEdge

isLocationOnEdge(point, poly[, tolerance])

Parametry:

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

Wartość zwracana: boolean

Oblicza, czy podany punkt znajduje się na linii łamanej lub w pobliżu niej albo na krawędzi wielokąta w określonym zakresie 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 to 10^-9 stopni.