Geometry Library

encoding 클래스

google.maps.geometry.encoding 클래스

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

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

decodePath
decodePath(encodedPath)
매개변수: 
  • encodedPathstring
반환 값:  Array<LatLng>
인코딩된 경로 문자열을 일련의 LatLng로 디코딩합니다.
encodePath
encodePath(path)
반환 값:  string
일련의 LatLng를 인코딩된 경로 문자열로 인코딩합니다.

spherical 클래스

google.maps.geometry.spherical 클래스

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

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

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를 반환합니다.

poly 클래스

google.maps.geometry.poly 클래스

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

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

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