새로운 지도 스타일이 곧 Google Maps Platform에 제공될 예정입니다. 이 지도 스타일 지정 업데이트에는 새로운 기본 색상 팔레트와 지도 환경 및 사용성 개선사항이 포함됩니다. 모든 지도 스타일이 2025년 3월에 자동으로 업데이트됩니다. 사용 가능 여부 및 더 일찍 선택하는 방법에 대한 자세한 내용은 Google Maps Platform용 새로운 지도 스타일을 참고하세요.

이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Geometry Library

encoding 네임스페이스입니다.

google.maps.geometry.encoding 네임스페이스

폴리라인 인코딩 및 디코딩을 위한 유틸리티입니다.

const {encoding} = await google.maps.importLibrary("geometry")를 호출하여 액세스합니다. Maps JavaScript API의 라이브러리를 참고하세요.

정적 메서드
`decodePath`	`decodePath(encodedPath)` 매개변수: `encodedPath`: `string` 반환 값: `Array<LatLng>` 인코딩된 경로 문자열을 일련의 LatLng로 디코딩합니다.
`encodePath`	`encodePath(path)` 매개변수: `path`: `Array<LatLng\|LatLngLiteral>\|MVCArray<LatLng\|LatLngLiteral>` 반환 값: `string` 일련의 LatLng를 인코딩된 경로 문자열로 인코딩합니다.

spherical 네임스페이스

google.maps.geometry.spherical 네임스페이스

측지선 각도, 거리 및 영역을 계산하기 위한 유틸리티 함수입니다. 기본 반경은 6378137 미터의 지구 반지름입니다.

const {spherical} = await google.maps.importLibrary("geometry")를 호출하여 액세스합니다. Maps JavaScript API의 라이브러리를 참고하세요.

정적 메서드
`computeArea`	`computeArea(path[, radiusOfSphere])` 매개변수: `path`: `Array<LatLng\|LatLngLiteral>\|MVCArray<LatLng\|LatLngLiteral>\|Circle\|CircleLiteral\|LatLngBounds\|LatLngBoundsLiteral` `radiusOfSphere`: `number optional` 반환 값: `number` 닫힌 경로의 부호 없는 영역을 [0, 2×pi×반경2] 범위에서 반환합니다. 계산된 영역은 반경과 동일한 단위를 사용합니다. `radiusOfSphere`는 기본적으로 지구의 반경을 미터 단위로 설정합니다. 이 경우 면적은 제곱미터입니다. `Circle`를 전달하려면 `radius`를 음수가 아닌 값으로 설정해야 합니다. 또한 원은 구체의 100% 이상을 덮어서는 안 됩니다. `LatLngBounds`를 전달할 때 남쪽 LatLng는 북쪽 LatLng보다 더 북쪽에 있을 수 없습니다.
`computeDistanceBetween`	`computeDistanceBetween(from, to[, radius])` 매개변수: `from`: `LatLng\|LatLngLiteral` `to`: `LatLng\|LatLngLiteral` `radius`: `number optional` 반환 값: `number` 두 LatLng 사이의 거리를 미터 단위로 반환합니다. 선택사항으로 맞춤 반경을 지정할 수도 있습니다. 반경은 기본적으로 지구의 반경으로 설정됩니다.
`computeHeading`	`computeHeading(from, to)` 매개변수: `from`: `LatLng\|LatLngLiteral` `to`: `LatLng\|LatLngLiteral` 반환 값: `number` 한 LatLng에서 다른 LatLng로의 방향을 반환합니다. 방향은 [-180,180) 범위 내에서 북쪽에서 시계 방향의 도 단위로 표현됩니다.
`computeLength`	`computeLength(path[, radius])` 매개변수: `path`: `Array<LatLng\|LatLngLiteral>\|MVCArray<LatLng\|LatLngLiteral>` `radius`: `number optional` 반환 값: `number` 지정된 경로의 길이를 반환합니다.
`computeOffset`	`computeOffset(from, distance, heading[, radius])` 매개변수: `from`: `LatLng\|LatLngLiteral` `distance`: `number` `heading`: `number` `radius`: `number optional` 반환 값: `LatLng` 지정된 방향의 한 원점에서 거리를 이동하여 얻은 LatLng를 반환합니다 (북쪽에서 시계 방향으로 도 단위로 표현됨).
`computeOffsetOrigin`	`computeOffsetOrigin(to, distance, heading[, radius])` 매개변수: `to`: `LatLng\|LatLngLiteral` `distance`: `number` `heading`: `number` `radius`: `number optional` 반환 값: `LatLng\|null` LatLng 목적지, 이동 미터 및 원래 방위와 함께 제공되면 출발지의 위치를 반환합니다. 방향은 북쪽에서 시계 방향의 도 단위로 표현됩니다. 이 함수는 사용 가능한 해가 없으면 `null`를 반환합니다.
`computeSignedArea`	`computeSignedArea(loop[, radius])` 매개변수: `loop`: `Array<LatLng\|LatLngLiteral>\|MVCArray<LatLng\|LatLngLiteral>` `radius`: `number optional` 반환 값: `number` 닫힌 경로의 부호 있는 영역(반시계 방향이 양수)을 [-2×pi×반경2, 2×pi×반경2] 범위에서 반환합니다. 계산된 영역은 반경과 동일한 단위를 사용합니다. 반경은 미터 단위의 지구 반경으로 기본 설정됩니다. 이 경우 면적은 제곱미터입니다. 면적은 병렬 전송 방법을 사용하여 계산됩니다. 단위 구체의 닫힌 경로 주변 병렬 운송은 경로로 둘러싸인 영역과 같은 각도로 비틀립니다. 이 방법은 각 삼각형에서 Girard, l'Huilier 또는 Eriksson을 사용한 삼각측량보다 더 간단하고 정확하며 강력한 방법입니다. 특히, 삼각형은 삼각을 이루지 않으므로 다각형의 가장자리 (대각선이 아닌)가 180도에 걸쳐 있는 경우를 제외하고는 불안정성이 없습니다.
`interpolate`	`interpolate(from, to, fraction)` 매개변수: `from`: `LatLng\|LatLngLiteral` `to`: `LatLng\|LatLngLiteral` `fraction`: `number` 반환 값: `LatLng` 출발지 LatLng와 목적지 LatLng 사이의 지정된 부분에 있는 LatLng를 반환합니다.

poly 네임스페이스

google.maps.geometry.poly 네임스페이스

다각형 및 다중선과 관련된 계산을 위한 유틸리티 함수입니다.

const {poly} = await google.maps.importLibrary("geometry")를 호출하여 액세스합니다. Maps JavaScript API의 라이브러리를 참고하세요.

정적 메서드
`containsLocation`	`containsLocation(point, polygon)` 매개변수: `point`: `LatLng\|LatLngLiteral` `polygon`: `Polygon` 반환 값: `boolean` 지정된 점이 지정된 다각형 내에 있는지 여부를 계산합니다.
`isLocationOnEdge`	`isLocationOnEdge(point, poly[, tolerance])` 매개변수: `point`: `LatLng\|LatLngLiteral` `poly`: `Polygon\|Polyline` `tolerance`: `number optional` 반환 값: `boolean` 지정된 점이 지정된 허용 오차 내에서 다중선 또는 다각형 가장자리 위나 근처에 있는지 계산합니다. 제공된 지점의 위도와 경도와 가장자리에서 가장 가까운 지점의 차이가 허용 오차보다 작으면 `true`를 반환합니다. 공차의 기본값은 10^-9도입니다.

정적 메서드

containsLocation

containsLocation(point, polygon)

매개변수:

point: LatLng|LatLngLiteral
polygon: Polygon

반환 값: boolean

지정된 점이 지정된 다각형 내에 있는지 여부를 계산합니다.

isLocationOnEdge

isLocationOnEdge(point, poly[, tolerance])

매개변수:

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

반환 값: boolean

지정된 점이 지정된 허용 오차 내에서 다중선 또는 다각형 가장자리 위나 근처에 있는지 계산합니다. 제공된 지점의 위도와 경도와 가장자리에서 가장 가까운 지점의 차이가 허용 오차보다 작으면 true를 반환합니다. 공차의 기본값은 10^-9도입니다.