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 인터페이스

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

속성
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	고도 요청을 처리할 수 없지만 정확한 실패 원인은 알 수 없습니다.