Rozpocznij

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

Ta usługa jest również dostępna po stronie klienta Maps JavaScript API, lub po stronie serwera, Klient Java, Klient Pythona, Klient Go i Klient Node.js dla usług Map Google.

Przykładowe żądanie i odpowiedź

Dostęp do interfejsu Elevation API można uzyskać przez interfejs HTTP, gdzie żądań utworzonych jako ciąg adresu URL, przy użyciu współrzędnych długości i szerokości geograficznej, identyfikować lokalizacje lub wierzchołki ścieżek. Żądania muszą zawierać klucz interfejsu API.

W poniższym przykładzie zażądano wysokości dla Denver, 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'

Aby to sprawdzić, wpisz w przeglądarce adres URL (pamiętaj, aby zastąpić YOUR_API_KEY rzeczywistym kluczem interfejsu API). Odpowiedź zawiera wysokość w danym punkcie w metrach, a także wartość rozdzielczości (maksymalna odległość między punktami danych, z których wysokość została interpolowana w metrach).

Zapoznaj się z przewodnikiem dla programistów . tworzenie adresów URL żądań i dostępnych parametrów i zrozumienie odpowiedzi.

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>

Zacznij kodować, korzystając z naszych bibliotek klienta

Biblioteki klienta za pomocą interfejsów API usług sieciowych Map Google, oferując proste, natywne implementacje typowych zadań, takich jak uwierzytelnianie, i automatyczne ponawianie próby. Interfejs Elevation API jest dostępny w Klient Java, Klient Pythona, Klient Go i Klient Node.js dla usług Map Google.

Uwierzytelnianie, limity, ceny i zasady

Uwierzytelnianie

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

Limity i ceny

Zapoznaj się z informacjami o użytkowaniu i płatnościach ze szczegółowymi informacjami o limitach i cenach ustawionych za pomocą interfejsu Elevation API.

Zasady

Korzystanie z interfejsu Elevation API musi być zgodne z Zasady dotyczące interfejsu API

Więcej informacji

Za pomocą interfejsu Elevation API można robić więcej, na przykład: żądanie danych o wysokości n.p.m. z wielu lokalizacji. Zobacz Przewodnik dla programistów interfejsu Elevation API. przykłady i inne szczegóły.

Przewodnik dla programistów interfejsu Elevation API jest przeznaczony dla witryn programistów aplikacji mobilnych, którzy chcą korzystać z danych o wysokości na mapach dostarczanych przez jedną z interfejsów API Google Maps Platform. Przedstawiamy w nim wprowadzenie do korzystania z interfejsu API i materiałów referencyjnych o dostępnych parametrach.