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

서비스는 제공된 좌표의 고도를 가져옵니다. 또한 고도가 없는 위치의 고도를 보간하여 고도 데이터를 제공하는 가장 가까운 네 개의 위치에서 반환된 평균을 제공합니다. 마지막으로 위치의 전체 해상도를 결정합니다.

자료

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

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

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

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

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

Elevation API 사용 방법

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

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

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

Google 지도 서비스용 자바 클라이언트, Python 클라이언트, Go 클라이언트, Node.js 클라이언트는 Apache 2.0 라이선스에 따라 오픈소스로 제공되는 클라이언트 지원 클라이언트 라이브러리입니다. GitHub에서 다운로드합니다. 여기에는 설치 안내 및 샘플 코드도 포함되어 있습니다.

다음 단계