Elevation API 개요

Elevation API는 지구상의 위치에 대한 고도 데이터 또는 경로를 따라 샘플링된 고도 데이터를 반환하는 서비스입니다.

Elevation API를 사용하는 이유

Elevation API를 사용하면 고도에 민감한 활동, 위치 지정 애플리케이션 또는 경로에 따른 고도 및 고도 변화를 포함하는 저측량 애플리케이션을 통해 고객을 지원하는 애플리케이션을 개발할 수 있습니다. 예를 들어 등산, 자전거 타기, 스쿠버 다이빙과 같은 스포츠 활동을 위한 스포츠 애플리케이션의 향상을 위해 고도 상승 및 손실 데이터를 제공할 수 있습니다.

Elevation API로 할 수 있는 작업

Elevation API를 사용하면 애플리케이션 또는 지도에 고도 데이터를 포함할 수 있습니다. 예를 들면 다음과 같습니다.

  • 특정 장소의 고도를 확인합니다.
  • 경로를 따라 또는 두 지점 간 고도의 차이를 계산합니다.

Elevation API 작동 방식

Elevation API는 위도/경도 좌표를 개별 위치 또는 경로를 따라 일련의 위치로 제공되는 인코딩된 URL로 받습니다. 예를 들어 이 요청은 콜로라도 덴버 중심의 고도를 쿼리하고 JSON 형식의 반환을 지정합니다. 
  https://maps.googleapis.com/maps/api/elevation/json
  ?locations=39.7391536%2C-104.9847034
  &key=YOUR_API_KEY

이 서비스는 제공된 좌표의 고도를 가져옵니다. 또한 고도가 지정되지 않은 위치의 고도를 보간하여 고도 데이터를 제공하는 가장 가까운 위치 4곳의 평균을 제공합니다. 마지막으로 위치의 전반적인 해상도를 결정합니다.

자료

다음 표에는 Elevation API를 통해 사용할 수 있는 리소스와 이 리소스가 반환하는 데이터가 요약되어 있습니다.

데이터 리소스 반환된 데이터 반환 형식
위도/경도 좌표

데이터를 하나 이상의 위치 집합으로 제공하거나 경로를 따라 계열로 제공할 수 있습니다. 인코딩된 좌표를 제공할 수도 있습니다. 최대 512개의 좌표를 전달합니다.

Elevation API는 지역 평균 해수면(LMSL)을 기준으로 고도(미터)를 제공합니다. 고도는 아래와 같이 양수 또는 음수 값으로 반환될 수 있습니다.

  • 양수 값은 표면 위치 또는 고지대의 호수 하단을 포함하여 LMSL 위의 위치를 나타냅니다.
  • 음수 값은 표면 또는 해저 위치를 포함하여 LMSL 아래의 위치를 나타냅니다.
  • 해상도는 데이터 포인트와 고도 사이의 거리를 미터 단위로 나타냅니다.
  • JSON
  • XML

Elevation API 사용 방법

1 설정하기 Google Cloud 프로젝트 설정을 시작하고 이후의 설정 안내를 완료합니다.
2 고도 요청 시도 API 키가 있으면 브라우저에서 직접 Elevation API를 테스트할 수 있습니다. 자세한 내용은 시작하기 가이드의 샘플 요청을 참조하세요.
3 더 복잡한 요청 작성 프로젝트를 설정했으면 경로를 따라 위치 데이터를 제공하는 요청을 시도해 보세요. 자세한 내용은 경로 지정 을 참고하세요.
4 응답 기본사항 이해하기 앱에 고도 데이터를 사용할 준비를 하려면 고도 데이터 응답을 살펴보세요. 자세한 내용은 고도 응답을 참고하세요.
5 고도 데이터를 앱에 통합하세요. 고도 데이터를 사용하여 스포츠 활동이나 설문조사 데이터 앱과 같은 위치 기반 앱을 개선할 수 있습니다.

사용 가능한 클라이언트 라이브러리

다음 클라이언트 라이브러리 중 하나를 통해 원하는 언어로 이 API를 호출하세요.

Google 지도 서비스용 Java Client, Python Client, Go Client, Node.js Client는 커뮤니티에서 지원하는 클라이언트 라이브러리로, Apache 2.0 라이선스에 따라 오픈소스로 제공됩니다. GitHub에서 다운로드하세요. GitHub에서 설치 안내와 샘플 코드도 확인할 수 있습니다.

다음 단계