Elevation

ElevationService 클래스

google.maps.ElevationService 클래스

고도 데이터를 요청하기 위해 Google 서버와 직접 통신하는 서비스 클래스를 정의합니다.

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

ElevationService
ElevationService()
매개변수: 없음
Google 서버에 고도 쿼리를 보내는 ElevationService의 새 인스턴스를 만듭니다.
getElevationAlongPath
getElevationAlongPath(request[, callback])
매개변수: 
경로에 있는 고도를 요청합니다. 고도 데이터는 해당 경로에 있는 거리 기준의 샘플로 반환됩니다.
getElevationForLocations
getElevationForLocations(request[, callback])
매개변수: 
분산된 위치의 목록에 대해 고도를 요청합니다.

LocationElevationRequest 인터페이스

google.maps.LocationElevationRequest 인터페이스

고도 데이터를 반환할 불연속 좌표 (LatLng) 목록을 포함하는 ElevationService에서 전송한 고도 요청입니다.

locations optional
유형:  Array<LatLng|LatLngLiteral> optional
고도를 가져올 분산된 위치입니다.

LocationElevationResponse 인터페이스

google.maps.LocationElevationResponse 인터페이스

ElevationService에서 반환된 고도 응답에는 LocationElevationRequest의 위치와 일치하는 ElevationResult 목록이 포함됩니다.

results
LocationElevationRequest의 위치와 일치하는 ElevationResult 목록입니다.

PathElevationRequest 인터페이스

google.maps.PathElevationRequest 인터페이스

샘플링된 데이터를 반환할 경로를 포함하는 ElevationService에서 전송한 고도 쿼리입니다. 이 요청은 균등한 간격으로 고도를 샘플링해야 하는 지구 상의 연속 경로를 정의합니다. 꼭짓점에서 꼭짓점까지의 모든 경로는 두 점 사이에서 대권의 선분을 사용합니다.

samples
유형:  number
필수 항목입니다. 끝점을 포함하여 고도 데이터를 가져올 지정된 경로에 있는 등거리 지점의 수입니다. 샘플 수는 2 이상 512 이하의 값이어야 합니다.
path optional
유형:  Array<LatLng|LatLngLiteral> optional
고도 값을 수집할 경로입니다.

PathElevationResponse 인터페이스

google.maps.PathElevationResponse 인터페이스

PathElevationRequest의 경로를 따라 균등한 간격으로 배치된 ElevationResult 목록을 포함하는 ElevationService에서 반환하는 고도 응답입니다.

results
PathElevationRequest의 샘플과 일치하는 ElevationResult 목록입니다.

ElevationResult 인터페이스

google.maps.ElevationResult 인터페이스

ElevationService 요청의 결과로, 고도 좌표 집합과 고도 값으로 구성됩니다. 단일 요청이 여러 ElevationResult를 생성할 수 있습니다.

elevation
유형:  number
지구 상, 해수면 위의 이 점에 대한 고도입니다(미터 단위).
resolution
유형:  number
고도가 보간된 샘플 지점 사이의 거리(미터)입니다. 해상도를 알 수 없는 경우에는 이 속성이 누락됩니다. 지점을 여러 개 전달하면 고도 데이터의 정밀도가 떨어집니다 (resolution 값이 커짐). 특정 지점에 대해 가장 정확한 고도 값을 구하려면, 독립적으로 퀴리를 수행해야 합니다.
location optional
유형:  LatLng optional
이 고도 결과의 위치입니다.

ElevationStatus 상수

google.maps.ElevationStatus 상수

고도 요청 완료 시 ElevationService에서 반환한 상태입니다. 값 또는 상수 이름을 사용하여 지정합니다. 예를 들어 'OK' 또는 google.maps.ElevationStatus.OK입니다.

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

INVALID_REQUEST 요청이 잘못되었습니다.
OK 요청에 오류가 발생하지 않았습니다.
OVER_QUERY_LIMIT 웹페이지가 너무 짧은 시간 내에 요청 한도를 초과했습니다.
REQUEST_DENIED 웹페이지에서 고도 서비스를 사용할 수 없습니다.
UNKNOWN_ERROR 고도 요청을 처리하지 못했으며 실패의 정확한 원인도 알 수 없습니다.