Elevation

ElevationService 클래스

google.maps.ElevationService 클래스

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

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

생성자
ElevationService	ElevationService() 매개변수: 없음 Google 서버에 고도 쿼리를 보내는 ElevationService의 새 인스턴스를 만듭니다.

방법
getElevationAlongPath	getElevationAlongPath(request[, callback]) 매개변수:  request:  PathElevationRequest callback:  function(Array<ElevationResult> optional, ElevationStatus): void optional 반환 값:  Promise<PathElevationResponse> 경로에 있는 고도를 요청합니다. 고도 데이터는 해당 경로에 있는 거리 기준의 샘플로 반환됩니다.
getElevationForLocations	getElevationForLocations(request[, callback]) 매개변수:  request:  LocationElevationRequest callback:  function(Array<ElevationResult> optional, ElevationStatus): void optional 반환 값:  Promise<LocationElevationResponse> 분산된 위치의 목록에 대해 고도를 요청합니다.

LocationElevationRequest 인터페이스

google.maps.LocationElevationRequest 인터페이스

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

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

LocationElevationResponse 인터페이스

google.maps.LocationElevationResponse 인터페이스

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

속성
results	유형:  Array<ElevationResult> 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	유형:  Array<ElevationResult> 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	고도 요청을 처리하지 못했으며 실패의 정확한 원인도 알 수 없습니다.