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×radius2] 범위의 닫힌 경로의 부호 없는 영역을 반환합니다. 계산된 영역은 반경과 동일한 단위를 사용합니다. 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×radius2, 2×pi×radius2]입니다. 계산된 영역은 반경과 동일한 단위를 사용합니다. 반경은 미터 단위의 지구 반지름으로 기본 설정됩니다. 이 경우 면적은 제곱미터입니다.

면적은 동시 운송 방법을 사용하여 계산됩니다. 단위 구체의 닫힌 경로를 병렬로 이동하면 경로에서 둘러싼 영역과 동일한 각도로 트위스트됩니다. 이는 각 삼각형에서 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도입니다.