시작하기

Elevation API는 음수 값을 반환하는 해저의 깊이 위치를 비롯하여 지표면의 모든 위치에 대한 고도 데이터를 제공합니다.

이 서비스는 클라이언트 측 Maps JavaScript API의 일부로 사용하거나 자바 클라이언트, Python 클라이언트, Go 클라이언트, Google 지도 서비스용 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'

자바스크립트

var axios = require('axios');

var config = {
  method: 'get',
  url: 'https://maps.googleapis.com/maps/api/elevation/json?locations=39.7391536%2C-104.9847034&key=YOUR_API_KEY',
  headers: { }
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});

Python

import requests

url = "https://maps.googleapis.com/maps/api/elevation/json?locations=39.7391536%2C-104.9847034&key=YOUR_API_KEY"

payload={}
headers = {}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)

자바

OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("text/plain");
RequestBody body = RequestBody.create(mediaType, "");
Request request = new Request.Builder()
  .url("https://maps.googleapis.com/maps/api/elevation/json?locations=39.7391536%2C-104.9847034&key=YOUR_API_KEY")
  .method("GET", body)
  .build();
Response response = client.newCall(request).execute();

Ruby

require "uri"
require "net/http"

url = URI("https://maps.googleapis.com/maps/api/elevation/json?locations=39.7391536%2C-104.9847034&key=YOUR_API_KEY")

https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true

request = Net::HTTP::Get.new(url)

response = https.request(request)
puts response.read_body

Go

package main

import (
  "fmt"
  "net/http"
  "io/ioutil"
)

func main() {

  url := "https://maps.googleapis.com/maps/api/elevation/json?locations=39.7391536,-104.9847034&key=YOUR_API_KEY"
  method := "GET"

  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, nil)

  if err != nil {
    fmt.Println(err)
    return
  }
  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    return
  }
  defer res.Body.Close()

  body, err := ioutil.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    return
  }
  fmt.Println(string(body))
}

우체국

OpenAPI 사양은 Postman 컬렉션으로도 제공됩니다.

Postman에서 실행

웹브라우저에 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>

OpenAPI 사양

이 API에 대한 OpenAPI 사양은 GitHub에서 확인할 수 있습니다.

OpenAPI 사양 가져오기

우체국 컬렉션

OpenAPI 사양은 Postman 컬렉션으로도 제공됩니다.

Postman에서 실행

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

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

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

인증

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

할당량 및 가격 책정

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

정책

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

자세히 알아보기

여러 위치에서 고도 데이터 요청과 같이 Elevation API로 할 수 있는 작업이 더 많습니다. 더 많은 예시와 자세한 내용은 Elevation API 개발자 가이드를 참고하세요.

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