Rozpocznij

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

Ta usługa jest też dostępna jako część interfejsu Maps JavaScript API po stronie klienta lub do użytku po stronie serwera z klientem Java, klientem Python, klientem Go i klientem Node.js dla usług Map Google.

Przykładowe żądanie i odpowiedź

Dostęp do interfejsu Elevation API można uzyskać przez interfejs HTTP, w którym żądania są tworzone jako ciąg adresu URL, a do identyfikacji lokalizacji lub wierzchołków ścieżki używane są współrzędne szerokości i długości geograficznej. Żądania muszą zawierać klucz interfejsu API.

Ten przykład żąda wysokości Denver w Kolorado, „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'

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 o 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>
</pre>

Zacznij kodować, korzystając z naszych bibliotek klienta

Biblioteki klienta ułatwiają programowanie z użyciem interfejsów API usług internetowych Map Google, ponieważ zawierają wbudowane implementacje typowych zadań, takich jak uwierzytelnianie, ograniczanie żądań i automatyczne ponawianie prób. 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 go włączyć i uzyskać odpowiednie dane uwierzytelniające. 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 Elevation API musi być zgodne z zasadami dotyczącymi interfejsów API.

Więcej informacji

Interfejs Elevation API oferuje więcej możliwości, takich jak wysyłanie żądań o dane o wysokości z wielu lokalizacji. Więcej przykładów i szczegółowych informacji znajdziesz w  przewodniku dla deweloperów korzystających z Elevation API.

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