Rozpocznij

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

Usługa ta jest też dostępna w ramach interfejsu Maps JavaScript API po stronie klienta lub do użytku po stronie serwera w ramach klienta Java, klienta Python, klienta Go i klienta Node.js dla usług Map Google.

Przykładowe żądanie i odpowiedź

Dostęp do interfejsu Elevation API odbywa się za pomocą interfejsu HTTP, a żądania są tworzone jako ciąg znaków URL z użyciem współrzędnych geograficznych (szerokości i długości) do identyfikowania lokalizacji lub wierzchołków ścieżki. Żądania muszą zawierać klucz interfejsu API.

Ten przykład wysyła żądanie wysokości nad poziomem morza dla Denver w Kolorado, czyli „Miasta na wysokości mili”, 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'

Możesz to sprawdzić, wpisując adres URL w przeglądarce (pamiętaj, aby zastąpić YOUR_API_KEY rzeczywistym kluczem interfejsu API). Odpowiedź zawiera wysokość w danym punkcie (w metrach) oraz wartość rozdzielczości (maksymalną odległość między punktami danych, z których interpolowano wysokość, w metrach).

Więcej informacji o tworzeniu adresów URL żądań i dostępnych parametrach oraz interpretowaniu odpowiedzi znajdziesz w przewodniku dla deweloperó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>
</pre>

Zacznij kodować za pomocą naszych bibliotek klienta

Biblioteki klienta ułatwiają tworzenie aplikacji korzystających z interfejsów API usług internetowych Map Google, ponieważ zapewniają wbudowane implementacje typowych zadań, takich jak uwierzytelnianie, ograniczanie liczby żądań i automatyczne ponawianie. Interfejs Elevation API jest dostępny w klientach Java, Python, Go i Node.js dla usług Map Google.

Uwierzytelnianie, limity, ceny i zasady

Uwierzytelnianie

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

Limity i ceny

Szczegółowe informacje o limitach i cenach interfejsu Elevation API znajdziesz na stronie korzystanie i rozliczenia.

Zasady

Korzystanie z interfejsu Elevation API musi być zgodne z zasadami dotyczącymi interfejsów API.

Więcej informacji

Interfejs API Elevation ma więcej funkcji, np. możliwość wysyłania żądań danych o wysokości z wielu lokalizacji. Więcej przykładów i szczegółów znajdziesz w  przewodniku dla deweloperów dotyczącym interfejsu Elevation API.

Przewodnik dla programistów dotyczący interfejsu Elevation API jest przeznaczony dla programistów stron internetowych i aplikacji mobilnych, którzy chcą korzystać z danych o wysokości w mapach udostępnianych przez jeden z interfejsów Google Maps Platform API. Zawiera wprowadzenie do korzystania z interfejsu API i materiały referencyjne dotyczące dostępnych parametrów.