Rozpocznij

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

Ta usługa jest też dostępna w ramach 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 uzyskujesz przez interfejs HTTP. Żądania są tworzone jako ciąg znaków URL, a do identyfikowania lokalizacji lub wierzchołków ścieżki używane są współrzędne geograficzne. Żądania muszą zawierać klucz interfejsu API.

Ten przykład żądania pobiera dane o wysokości nad poziomem morza dla Denver w stanie Kolorado („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 przetestować, wpisując adres URL w przeglądarce (pamiętaj, aby zastąpić YOUR_API_KEY rzeczywistym kluczem interfejsu API). Odpowiedź zawiera wysokość nad poziomem morza 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 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>

Rozpoczęcie kodowania za pomocą bibliotek klienta

Biblioteki klienta ułatwiają tworzenie aplikacji korzystających z interfejsów API usług internetowych Map Google, ponieważ zawierają 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ć interfejs API 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 interfejsu Elevation API musi być zgodne z zasadami dotyczącymi interfejsów API.

Więcej informacji

Interfejs Elevation API umożliwia wykonywanie wielu innych czynności, np. wysyłanie żądań o dane o wysokości nad poziomem morza z wielu lokalizacji. Więcej przykładów i innych szczegółów znajdziesz w przewodniku dla programistów korzystających z interfejsu Elevation API Guide.

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