Elevation API는 해저면 (음수 값 반환)의 깊이 위치를 비롯하여 지표면의 모든 위치에 대한 고도 데이터를 제공합니다.
이 서비스는 클라이언트 측 Maps JavaScript API의 일부로 제공되거나 Google 지도 서비스용 Java 클라이언트, Python 클라이언트, Go 클라이언트, Node.js 클라이언트와 함께 서버 측에서 사용할 수 있습니다.
샘플 요청 및 응답
HTTP 인터페이스를 통해 Elevation API에 액세스하고 URL 문자열로 구성된 요청에서 위도/경도 좌표를 사용하여 위치나 경로 꼭짓점을 식별합니다. 요청에는 API 키가 포함되어야 합니다.
다음 예에서는 콜로라도 덴버 '마일 하이 시티'의 고도를 JSON 형식으로 요청합니다.
URL
https://maps.googleapis.com/maps/api/elevation/json ?locations=39.7391536%2C-104.9847034 &key=YOUR_API_KEY
cURL
curl -L -X GET 'https://maps.googleapis.com/maps/api/elevation/json?locations=39.7391536%2C-104.9847034&key=YOUR_API_KEY'
웹브라우저에 URL을 입력하여 이를 테스트할 수 있습니다. YOUR_API_KEY
는 실제 API 키로 바꿔야 합니다.
응답에는 해상도 값(고도가 보간된 데이터 지점 사이의 최대 거리(미터))과 함께 해당 지점의 고도(미터)가 포함됩니다.
요청 URL 및 사용 가능한 매개변수 빌드와 응답 이해에 관한 자세한 내용은 개발자 가이드를 참고하세요.
다음은 샘플 응답입니다.
JSON
{ "results": [ { "elevation": 1608.637939453125, "location": { "lat": 39.7391536, "lng": -104.9847034 }, "resolution": 4.771975994110107, }, ], "status": "OK", }
XML
<ElevationResponse> <status>OK</status> <result> <location> <lat>39.7391536</lat> <lng>-104.9847034</lng> </location> <elevation>1608.6379395</elevation> <resolution>4.7719760</resolution> </result> </ElevationResponse>
클라이언트 라이브러리로 코딩 시작하기
클라이언트 라이브러리를 사용하면 인증, 요청 제한, 자동 재시도와 같은 일반적인 작업을 간단하게 기본 구현하여 Google 지도 웹 서비스 API로 더욱 쉽게 개발할 수 있습니다. Elevation API는 Google 지도 서비스용 Java 클라이언트, Python 클라이언트, Go 클라이언트, Node.js 클라이언트에서 사용할 수 있습니다.
인증, 할당량, 가격 책정, 정책
인증
Elevation API를 사용하려면 먼저 API를 사용 설정하고 적절한 사용자 인증 정보를 획득해야 합니다. 자세한 내용은 Google Maps Platform 시작하기를 참고하세요.
할당량 및 가격 책정
Elevation API의 할당량 및 가격 책정에 관한 자세한 내용은 사용량 및 결제 페이지를 참고하세요.
정책
Elevation API는 API 정책에 따라 사용해야 합니다.
자세히 알아보기
그 외에도 여러 위치의 고도 데이터 요청과 같이 Elevation API를 사용할 수 있습니다. 더 많은 예와 기타 세부정보는 Elevation API 개발자 가이드를 참고하세요.
Elevation API 개발자 가이드는 Google Maps Platform API 중 하나에서 제공하는 지도 내에서 고도 데이터를 사용하려는 웹사이트 및 모바일 개발자를 대상으로 합니다. 또한 API 사용 소개 및 사용 가능한 매개변수에 대한 참조 자료도 제공합니다.