시작하기

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 사용 소개 및 사용 가능한 매개변수에 대한 참조 자료도 제공합니다.