Geometry Library

encoding 네임스페이스

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

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

const {encoding} = await google.maps.importLibrary("geometry");
decodePath
decodePath(encodedPath)
매개변수:
  • encodedPath: string
반환 값: Array<LatLng>
인코딩된 경로 문자열을 일련의 LatLng로 디코딩합니다.
encodePath
encodePath(path)
매개변수:
반환 값: string
일련의 LatLng를 인코딩된 경로 문자열로 인코딩합니다.

spherical 네임스페이스

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

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

const {spherical} = await google.maps.importLibrary("geometry");
computeArea
computeArea(path[, radiusOfSphere])
매개변수:
반환 값: number
닫힌 경로의 부호 없는 면적을 [0, 2×pi×radius²] 범위에서 반환합니다. 계산된 면적은 반지름과 동일한 단위를 사용합니다. radiusOfSphere는 기본적으로 지구의 반지름(미터)으로 설정되며, 이 경우 면적은 제곱미터 단위입니다. Circle를 전달하려면 radius를 음수가 아닌 값으로 설정해야 합니다. 또한 원은 구의 100% 를 초과하여 덮어서는 안 됩니다. LatLngBounds를 전달할 때 남쪽 LatLng은 북쪽 LatLng보다 북쪽에 있을 수 없습니다.
computeDistanceBetween
computeDistanceBetween(from, to[, radius])
매개변수:
반환 값: number
두 LatLng 사이의 거리(단위: 미터)를 반환합니다. 원하는 경우 맞춤 반경을 지정할 수 있습니다. 반경은 기본적으로 지구의 반경으로 설정됩니다.
computeHeading
computeHeading(from, to)
매개변수:
반환 값: number
한 LatLng에서 다른 LatLng까지의 방향을 반환합니다. 방향은 북쪽에서 시계 방향으로 [-180,180) 범위 내에서 도 단위로 표현됩니다.
computeLength
computeLength(path[, radius])
매개변수:
반환 값: number
지정된 경로의 길이를 반환합니다.
computeOffset
computeOffset(from, distance, heading[, radius])
매개변수:
반환 값: LatLng
지정된 방향 (북쪽에서 시계 방향으로 도 단위로 표시)으로 출발지에서 이동한 거리의 결과로 LatLng를 반환합니다.
computeOffsetOrigin
computeOffsetOrigin(to, distance, heading[, radius])
매개변수:
반환 값: LatLng|null
LatLng 목적지, 이동한 거리(미터), 원래 방향이 제공되면 출발지 위치를 반환합니다. 방향은 북쪽에서 시계 방향으로 각도로 표시됩니다. 이 함수는 사용 가능한 솔루션이 없으면 null를 반환합니다.
computeSignedArea
computeSignedArea(loop[, radius])
매개변수:
반환 값: number
닫힌 경로의 부호 있는 면적을 반환합니다. 시계 반대 방향은 양수이며 범위는 [-2×pi×radius², 2×pi×radius²]입니다. 계산된 면적은 반지름과 동일한 단위를 사용합니다. 반지름은 기본적으로 지구의 반지름(미터)으로 설정되며, 이 경우 면적은 제곱미터 단위입니다.

면적은 평행 이동 메서드를 사용하여 계산됩니다. 단위 구의 닫힌 경로를 따라 평행 이동하면 경로로 둘러싸인 면적과 동일한 각도로 비틀립니다. 이 방법은 각 삼각형에서 Girard, l'Huilier 또는 Eriksson을 사용하는 삼각 측량보다 더 간단하고 정확하며 강력합니다. 특히 삼각 측량을 하지 않으므로 다각형의 변 (대각선이 아님)이 180도에 걸쳐 있는 불가피한 경우를 제외하고는 불안정성이 없습니다.
interpolate
interpolate(from, to, fraction)
매개변수:
반환 값: LatLng
출발지 LatLng와 목적지 LatLng 사이의 지정된 부분에 있는 LatLng를 반환합니다.
AlphatraversePath
traversePath(path, fraction)
매개변수:
반환 값: LatLngLiteral
지정된 경로를 따라 지정된 비율의 위치를 반환합니다. LatLngAltitude 객체를 전달하는 경우 현재 고도는 무시되지만 향후 버전에서는 고도가 고려될 수 있습니다.

poly 네임스페이스

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

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

const {poly} = await google.maps.importLibrary("geometry");
containsLocation
containsLocation(point, polygon)
매개변수:
반환 값: boolean
지정된 점이 지정된 다각형 또는 원 내부에 있는지 계산합니다. Circle를 전달하려면 center를 설정하고 radius를 음이 아닌 값으로 설정해야 합니다.
isLocationOnEdge
isLocationOnEdge(point, poly[, tolerance])
매개변수:
반환 값: boolean
지정된 점이 다중선 위나 근처 또는 다각형 가장자리 위나 근처에 있는지 지정된 허용 오차 내에서 계산합니다. 제공된 점의 위도 및 경도와 가장자리의 가장 가까운 점 간의 차이가 허용 오차보다 작으면 true를 반환합니다. 허용 오차는 기본적으로 10-9도입니다.