Prośby o zmianę wysokości i odpowiedzi

Prośby o podniesienie

Żądania do interfejsu Elevation API są tworzone jako ciąg znaków adresu URL. Interfejs API zwraca dane o wysokości względnej lokalizacji na Ziemi. Dane o lokalizacji możesz określić na 2 sposoby:

• Jako zbiór co najmniej 1 elementu locations.
• Jako seria połączonych punktów na cieśninie path.

Oba te podejścia używają współrzędnych szerokości i długości geograficznej do identyfikowania lokalizacji lub wierzchołków ścieżki. W tym dokumencie opisano wymagany format Adresy URL interfejsu Elevation API i dostępne parametry.

Interfejs Elevation API zwraca dane dla zapytań jednopunktowych. z największą możliwą dokładnością. Zapytania zbiorcze dotyczące wielu lokalizacji mogą zwrócić dane z mniejszą dokładnością, zwłaszcza jeśli lokalizacje są rozproszone między poszczególnymi elementami, a także wygładzać dane.

Żądanie do interfejsu Elevation API ma następującą formę:

https://maps.googleapis.com/maps/api/elevation/outputFormat?parameters

gdzie outputFormat może mieć jedną z tych wartości:

• json (zalecany), wskazuje dane wyjściowe w JavaScript Object Notation (JSON); lub
• xml, wskazuje dane wyjściowe w formacie XML, opakowane w <ElevationResponse> węzeł.

Uwaga: adresy URL muszą zawierać prawidłowo zakodowane , a jego długość dla wszystkich usług internetowych jest ograniczona do 16 384 znaków. Pamiętaj o tym podczas tworzenia adresów URL. Pamiętaj, że różne przeglądarki, serwerów proxy i serwery mogą mieć także różne limity znaków adresu URL.

W przypadku żądań, które używają klucza interfejsu API, wymagany jest protokół HTTPS.

Parametry żądania

Żądania do interfejsu Elevation API używają różnych parametrów w zależności od tego, czy żądanie dotyczy konkretnych lokalizacji, uporządkowaną ścieżkę. W przypadku dyskretnych lokalizacji żądanie zwrotu wzniesień dane na temat konkretnych lokalizacji przekazanych w prośbie; ścieżek, Żądania podniesienia uprawnień są zamiast tego próbkowane wzdłuż podanej ścieżki.

Zgodnie ze standardem we wszystkich adresach URL parametry są rozdzielone przy użyciu znaku ampersand (&). Lista parametrów a ich możliwe wartości podano poniżej.

Wszystkie prośby

• key – (wymagany) Twój wniosek klucz interfejsu API. Ten klucz identyfikuje aplikację na potrzeby zarządzania limitami. Dowiedz się, jak uzyskać klucz.

Żądania dotyczące pozycji

• locations (wymagany) określa lokalizację lub lokalizacje na Ziemi, z których mają być zwracane dane o wysokości. Ten parametr przyjmuje albo pojedyncza lokalizacja w postaci rozdzielonej przecinkami pary {szerokość,długość} (np. „40.714728,-73.998672”) lub wiele par szerokości i długości geograficznej przekazywane jako tablica lub zakodowana linia łamana. Obowiązuje limit 512 punktów. dla tego konkretnego parametru. Więcej informacji znajdziesz w sekcji Określanie lokalizacji poniżej.

Próbkowane żądania ścieżek

• path (wymagany) określa ścieżkę na Ziemi dla które mają zwrócić dane o wysokości. Ten parametr określa zestaw dwóch lub bardziej uporządkowane pary {szerokość, długość}, które definiują ścieżkę wzdłuż powierzchni za kulisy. Ten parametr musi być używany w połączeniu z parametrem samplesopisanym poniżej. Ten parametr ma limit 512 punktów. Aby dowiedzieć się więcej, zapoznaj się z sekcją Określanie ścieżek poniżej.
• samples (wymagany) określa liczbę próbek. punktów na ścieżce, dla których mają być zwracane dane o wysokości n.p.m. Parametr samples dzieli daną ścieżkę pathna uporządkowany zbiór punktów równoodległych wzdłuż ścieżki.

Określanie lokalizacji

Żądania pozycjonowania są zgłaszane za pomocą funkcji Parametr locations wskazujący żądania podniesienia uprawnień dla konkretnych lokalizacji przekazanych jako szerokości i długości geograficznej.

Parametr locations może przyjmować takie wartości argumenty:

• Pojedyncza współrzędna: locations=40.714728,-73.998672
• Tablica współrzędnych rozdzielonych pionową kreską („|”) znak: locations=40.714728,-73.998672|-34.397,150.644
• Zbiór zakodowanych współrzędnych za pomocą algorytmu kodowania linii łamanych: locations=enc:gfo}EtohhU

Ciągi współrzędnych szerokości i długości geograficznej są definiowane za pomocą liczb w ciągu tekstowym rozdzielanym przecinkami. Na przykład „40.714728,-73.998672” to prawidłowa wartość locations. Wartości szerokości i długości geograficznej muszą odpowiadać prawidłowej lokalizacji na powierzchni Ziemi. Szerokość geograficzna może przyjmować dowolną wartość z zakresu od -90 do 90, a długość geograficzna – dowolną wartość z zakresu od -180 do 180. Jeśli określisz nieprawidłowa wartość szerokości lub długości geograficznej, żądanie zostanie odrzucone. jako złe żądanie.

W tablicy lub zakodowanej można przekazać do 512 współrzędnych linię łamaną, tworząc prawidłowy adres URL. Zwróć uwagę, że w przypadku przekazywania wielu współrzędnych, dokładność zwróconych danych może mieć niższą rozdzielczość niż w przypadku żądania danych dla jednej współrzędnej. Jeśli w parametrach „locations” lub „path” przekroczysz liczbę 512 punktów lub współrzędnych, zwrócona zostanie odpowiedź INVALID_REQUEST.

Określanie ścieżek

Próbkowane żądania ścieżek są wskazywane za pomocą parametru path i samples, które wskazują żądanie danych o wysokości wzdłuż ścieżki w określonych odstępach czasu. Podobnie jak w przypadku żądań pozycjonowania korzystających z locations, parametr path określa zbiór wartości szerokości i długości geograficznej. W odróżnieniu od żądania dotyczącego pozycji path określa uporządkowany zbiór wierzchołków. Zamiast zwrotu dane o wzroście wysokości tylko w wierzchołkach, żądania ścieżki są próbkowane wzdłuż długość ścieżki na podstawie liczby zdarzeń typu samples. (łącznie z punktami końcowymi).

Parametr path może przyjmować jedną z tych wartości: argumenty:

• Tablica z co najmniej 2 ciągami tekstowymi współrzędnych rozdzielonych przecinkami oddzielone pionową kreską („|”) znak: path=40.714728,-73.998672|-34.397,150.644
• Zakodowane współrzędne za pomocą funkcji Zakodowane Algorytm linii łamanej: path=enc:gfo}EtohhUxD@bAxJmGF

Ciągi tekstowe współrzędnych geograficznych są definiowane za pomocą cyfr w ciągu tekstowym rozdzielanym przecinkami. Przykład: „40.714728,-73.998672|-34.397, 150.644” jest prawidłową wartością Wartość: path. Długość i szerokość geograficzna muszą odpowiadać w odpowiednim miejscu na kuli ziemskiej. Szerokość geograficzna może przyjmować dowolną wartość z zakresu od -90 do 90, a długość geograficzna – dowolną wartość z zakresu od -180 do 180. Jeśli podasz nieprawidłową wartość szerokości geograficznej lub długości geograficznej, Twoje żądanie zostanie odrzucone jako nieprawidłowe.

W tablicy lub zakodowanej można przekazać do 512 współrzędnych linię łamaną, tworząc prawidłowy adres URL. W przypadku przekazywania współrzędne, dokładność zwróconych danych może być mniejsza niż podczas żądania danych dla jednej współrzędnej. Jeśli w parametrach „locations” lub „path” podasz więcej niż 512 punktów lub współrzędnych, zwrócona zostanie odpowiedź INVALID_REQUEST.

Odpowiedzi dotyczące wysokości

Dla każdego prawidłowego żądania usługa wysokości względnej zwróci informację o wysokości w formacie wskazanym w adresie URL żądania.

Gdy kod stanu jest inny niż OK, mogą występować dodatkowe error_message w obiekcie odpowiedzi dotyczącej wysokości. To pole zawiera więcej szczegółowych informacji o przyczynach danego kodu stanu.

Odpowiedź zawiera tablicę results z tymi elementami:

Obiekt location zawiera te elementy:

Przykłady wzniesienia pozycyjnego

W tym przykładzie żądamy wysokości w Denver w Kolorado, czyli w „Mile High City”, w formacie JSON:

https://maps.googleapis.com/maps/api/elevation/json
  ?locations=39.7391536%2C-104.9847034
  &key=YOUR_API_KEY

curl -L -X GET 'https://maps.googleapis.com/maps/api/elevation/json?locations=39.7391536%2C-104.9847034&key=YOUR_API_KEY'

{
  "results":
    [
      {
        "elevation": 1608.637939453125,
        "location": { "lat": 39.7391536, "lng": -104.9847034 },
        "resolution": 4.771975994110107,
      },
    ],
  "status": "OK",
}

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

Poniższy przykład pokazuje wiele odpowiedzi (dla Denver w Kolorado i Death Valley w Kalifornii).

To żądanie demonstruje użycie flagi output JSON:

https://maps.googleapis.com/maps/api/elevation/json
  ?locations=39.7391536%2C-104.9847034%7C36.455556%2C-116.866667
  &key=YOUR_API_KEY

curl -L -X GET 'https://maps.googleapis.com/maps/api/elevation/json?locations=39.7391536%2C-104.9847034%7C36.455556%2C-116.866667&key=YOUR_API_KEY'

To żądanie demonstruje użycie flagi XML output:

https://maps.googleapis.com/maps/api/elevation/xml?locations=39.7391536,-104.9847034|36.455556,-116.866667&key=YOUR_API_KEY

Aby zobaczyć przykładowe odpowiedzi w formacie JSON i XML, kliknij karty poniżej.

{
  "results":
    [
      {
        "elevation": 1608.637939453125,
        "location": { "lat": 39.7391536, "lng": -104.9847034 },
        "resolution": 4.771975994110107,
      },
      {
        "elevation": -52.79492568969727,
        "location": { "lat": 36.455556, "lng": -116.866667 },
        "resolution": 19.08790397644043,
      },
    ],
  "status": "OK",
}

<ElevationResponse>
 <status>OK</status>
 <result>
  <location>
   <lat>39.7391536</lat>
   <lng>-104.9847034</lng>
  </location>
  <elevation>1608.6379395</elevation>
  <resolution>4.7719760</resolution>
 </result>
 <result>
  <location>
   <lat>36.4555560</lat>
   <lng>-116.8666670</lng>
  </location>
  <elevation>-52.7949257</elevation>
  <resolution>19.0879040</resolution>
 </result>
</ElevationResponse>

W tych przykładach żądamy danych dotyczących wysokości w linii prostejpath od Mt. Whitney w Kalifornii do Badwater w Kalifornii, czyli najwyższego i najniższego punktu na kontynencie Stanów Zjednoczonych. Prosimy o 3 samples, aby uwzględnić 2 punkty końcowe i punkt pośredni.

https://maps.googleapis.com/maps/api/elevation/json
  ?path=36.578581%2C-118.291994%7C36.23998%2C-116.83171
  &samples=3
  &key=YOUR_API_KEY

curl -L -X GET 'https://maps.googleapis.com/maps/api/elevation/json?path=36.578581%2C-118.291994%7C36.23998%2C-116.83171&samples=3&key=YOUR_API_KEY'

{
  "results":
    [
      {
        "elevation": 4411.94189453125,
        "location": { "lat": 36.578581, "lng": -118.291994 },
        "resolution": 19.08790397644043,
      },
      {
        "elevation": 1372.8359375,
        "location": { "lat": 36.41150289067028, "lng": -117.5602607523847 },
        "resolution": 9.543951988220215,
      },
      {
        "elevation": -84.51690673828125,
        "location": { "lat": 36.23998, "lng": -116.83171 },
        "resolution": 9.543951988220215,
      },
    ],
  "status": "OK",
}

<ElevationResponse>
 <status>OK</status>
 <result>
  <location>
   <lat>36.5785810</lat>
   <lng>-118.2919940</lng>
  </location>
  <elevation>4411.9418945</elevation>
  <resolution>19.0879040</resolution>
 </result>
 <result>
  <location>
   <lat>36.4115029</lat>
   <lng>-117.5602608</lng>
  </location>
  <elevation>1372.8359375</elevation>
  <resolution>9.5439520</resolution>
 </result>
 <result>
  <location>
   <lat>36.2399800</lat>
   <lng>-116.8317100</lng>
  </location>
  <elevation>-84.5169067</elevation>
  <resolution>9.5439520</resolution>
 </result>
</ElevationResponse>