시작하기

고도 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>
</pre>

클라이언트 라이브러리로 코딩 시작하기

클라이언트 라이브러리는 인증, 요청 제한, 자동 재시도와 같은 일반적인 작업의 기본 제공 구현을 제공하여 Google Maps 웹 서비스 API를 사용한 개발을 더 쉽게 만듭니다. Elevation API는 Google 지도 서비스용 Java 클라이언트, Python 클라이언트, Go 클라이언트, Node.js 클라이언트에서 사용할 수 있습니다.

인증, 할당량, 가격 책정, 정책

인증

Elevation API를 사용하려면 먼저 API를 사용 설정하고 적절한 인증 사용자 인증 정보를 획득해야 합니다. 자세한 내용은 Google Maps Platform 시작하기를 참고하세요.

할당량 및 가격 책정

Elevation API에 설정된 할당량 및 가격에 대한 자세한 내용은 사용량 및 결제 페이지를 참고하세요.

정책

Elevation API는 API 정책에 따라 사용해야 합니다.

자세히 알아보기

고도 API를 사용하면 여러 위치에서 고도 데이터를 요청하는 등 더 많은 작업을 할 수 있습니다. 자세한 예와 기타 세부정보는 고도 API 개발자 가이드를 참고하세요.

고도 API 개발자 가이드는 Google Maps Platform API 중 하나에서 제공하는 지도 내에서 고도 데이터를 사용하려는 웹사이트 및 모바일 개발자를 대상으로 합니다. API 사용에 관한 소개와 사용 가능한 참조 자료에 관한 참고 자료를 제공합니다.