Wypróbuj

Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Interfejs Elevation API udostępnia dane o wysokości wszystkich lokalizacji na powierzchni Ziemi, w tym głębokość lokalizacji na dnie oceanu (które zwracają wartości ujemne).

Ta usługa jest również dostępna w ramach interfejsu API JavaScript Map Google lub po stronie serwera z użyciem klientów Java, Python, Go i Node.js dla Map Google.

Przykładowe żądanie i odpowiedź

Dostęp do interfejsu Elevation API możesz uzyskać za pomocą interfejsu HTTP z żądaniami utworzonymi w postaci ciągu URL z wykorzystaniem współrzędnych geograficznych do określania lokalizacji lub wierzchołków ścieżek. Żądania muszą zawierać klucz interfejsu API.

W tym przykładzie podano wysokość w formacie JSON w Denver, Kolorado i "Mile High City" w formacie 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'

JavaScript

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)

Java

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))
}

Postmana

Specyfikacja OpenAPI jest też dostępna jako kolekcja Postman.

Uruchom w Postman

Aby to sprawdzić, wpisz adres URL w przeglądarce (zastąp ciąg YOUR_API_KEY rzeczywistym kluczem interfejsu API). Odpowiedź obejmuje wysokość wyrażoną w metrach i wartość rozdzielczości (maks. odległość między punktami danych, w której wysokość jest interpolowana, w metrach).

Więcej informacji o tworzeniu adresów URL żądań i dostępnych parametrach oraz interpretowaniu odpowiedzi znajdziesz w przewodniku dla programistów.

Oto przykładowa odpowiedź:

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>

Specyfikacja OpenAPI

Specyfikacja OpenAPI została opublikowana dla tego interfejsu API i dostępna w GitHub.

Pobranie specyfikacji OpenAPI

Kolekcja Postman

Specyfikacja OpenAPI jest też dostępna jako kolekcja Postman.

Uruchom w Postman

Zacznij kodować z naszymi bibliotekami klienta

Biblioteki klienta ułatwiają programowanie za pomocą interfejsów API usługi internetowej Map Google, zapewniając proste, natywne implementacje typowych zadań, takich jak uwierzytelnianie, ograniczanie żądań czy automatyczna ponowna próba. Interfejs Elevation API jest dostępny w klientach Java, Python, Go Client i Node.js dla Map Google.

Uwierzytelnianie, limity, ceny i zasady

Uwierzytelnianie

Aby korzystać z interfejsu Elevation API, musisz najpierw go włączyć i uzyskać prawidłowe dane uwierzytelniające. Więcej informacji znajdziesz w artykule Pierwsze kroki z Google Maps Platform.

Limity i ceny

Szczegóły na temat limitów i cen ustawionych w interfejsie Elevation API znajdziesz na stronie użytkowania i rozliczeń.

Zasady

Korzystanie z interfejsu API Elevation musi być zgodne z zasadami interfejsu API.

Więcej informacji

Interfejs API Elevation API oferuje więcej możliwości, na przykład żądanie danych o wysokości z wielu lokalizacji. Więcej przykładów i inne szczegóły znajdziesz w przewodniku dla programistów interfejsu API Elevation.

Przewodnik dla programistów korzystających z interfejsu Elevation API jest przeznaczony dla deweloperów witryn i urządzeń mobilnych, którzy chcą korzystać z danych o wysokości w mapach udostępnianych przez jeden z interfejsów API Google Maps Platform. Wprowadzenie do korzystania z interfejsu API i materiałów referencyjnych na temat dostępnych parametrów.