ElevationService class
google.maps.ElevationService
zajęcia
Definiuje klasę usługi, która komunikuje się bezpośrednio z serwerami Google w celu przesyłania próśb o dane o wysokości.
Dostęp przez połączenie pod numer const {ElevationService} = await google.maps.importLibrary("elevation").
Zobacz Biblioteki w Maps JavaScript API.
Zespół | |
|---|---|
ElevationService |
ElevationService()Parametry: brak
Tworzy nową instancję ElevationService, która wysyła zapytania o wysokość do serwerów Google. |
Metody | |
|---|---|
getElevationAlongPath |
getElevationAlongPath(request[, callback])Parametry:
Zwracana wartość:
Promise<PathElevationResponse>Wysyła żądanie wysokości względnej wzdłuż ścieżki, w którym dane wysokości względnej są zwracane jako próbki oparte na odległości wzdłuż tej ścieżki. |
getElevationForLocations |
getElevationForLocations(request[, callback])Parametry:
Zwracana wartość:
Promise<LocationElevationResponse>Wysyła żądanie wysokości dla listy oddzielnych lokalizacji. |
LocationElevationRequest interfejs
google.maps.LocationElevationRequestinterfejs
Żądanie wysokościowe wysłane przez ElevationService zawierające listę dyskretnych współrzędnych (LatLng), dla których mają zostać zwrócone dane o wysokości.
Właściwości | |
|---|---|
locations optional |
Typ:
Array<LatLng|LatLngLiteral> optionalDyskretne lokalizacje, dla których mają zostać pobrane wysokości. |
LocationElevationResponse interfejs
google.maps.LocationElevationResponseinterfejs
Odpowiedź dotycząca wysokości zwrócona przez interfejs ElevationService zawierająca listę obiektów ElevationResult pasujących do lokalizacji LocationElevationRequest.
Właściwości | |
|---|---|
results |
Typ:
Array<ElevationResult>Lista ElevationResult pasujących do lokalizacji LocationElevationRequest. |
PathElevationRequest interfejs
google.maps.PathElevationRequestinterfejs
Zapytanie o wysokość wysłane przez interfejs ElevationService zawierające ścieżkę, wzdłuż której mają być zwracane próbkowane dane. Ta prośba określa ciągłą ścieżkę na powierzchni Ziemi, wzdłuż której należy pobrać próbki wysokości w równych odstępach. Wszystkie ścieżki od wierzchołka do wierzchołka wykorzystują segmenty koła wielkiego między tymi dwoma punktami.
Właściwości | |
|---|---|
samples |
Typ:
numberWymagane. Liczba równoodległych punktów na danej ścieżce, dla których mają być pobierane dane o wysokości, w tym punkty końcowe. Liczba próbek musi być wartością z przedziału od 2 do 512 (włącznie). |
path optional |
Typ:
Array<LatLng|LatLngLiteral> optionalŚcieżka, wzdłuż której mają być zbierane wartości wysokości. |
PathElevationResponse interfejs
google.maps.PathElevationResponseinterfejs
Odpowiedź dotycząca wysokości względnej zwrócona przez interfejs ElevationService, zawierająca listę punktów ElevationResult równomiernie rozmieszczonych wzdłuż ścieżki PathElevationRequest.
Właściwości | |
|---|---|
results |
Typ:
Array<ElevationResult>Lista ElevationResult pasujących do próbek PathElevationRequest. |
ElevationResult interfejs
google.maps.ElevationResultinterfejs
Wynik żądania ElevationService, który zawiera zbiór współrzędnych wysokościowych i ich wartości. Pamiętaj, że jedno żądanie może wygenerować wiele ElevationResult.
Właściwości | |
|---|---|
elevation |
Typ:
numberWysokość tego punktu na Ziemi w metrach nad poziomem morza. |
resolution |
Typ:
numberOdległość w metrach między punktami próbkowania, z których interpolowano wysokość. Jeśli rozdzielczość jest nieznana, ta właściwość nie będzie występować. Pamiętaj, że dane o wysokości stają się bardziej przybliżone (większe wartości resolution), gdy przekraczasz wiele punktów. Aby uzyskać jak najdokładniejszą wartość wysokości dla danego punktu, należy wysłać zapytanie osobno. |
location optional |
Typ:
LatLng optionalLokalizacja tego wyniku wysokości. |
ElevationStatus stałe
google.maps.ElevationStatus
stałe
Stan zwracany przez ElevationService po zakończeniu żądania wysokości. Możesz je określić za pomocą wartości lub nazwy stałej. Na przykład 'OK' lub google.maps.ElevationStatus.OK.
Dostęp przez połączenie pod numer const {ElevationStatus} = await google.maps.importLibrary("elevation").
Zobacz Biblioteki w Maps JavaScript API.
Stałe | |
|---|---|
INVALID_REQUEST |
Żądanie było nieprawidłowe. |
OK |
Żądanie nie spowodowało żadnych błędów. |
OVER_QUERY_LIMIT |
Strona internetowa przekroczyła limit żądań w zbyt krótkim czasie. |
REQUEST_DENIED |
Strona nie może korzystać z usługi wysokości. |
UNKNOWN_ERROR |
Nie udało się przetworzyć żądania wysokości, ale dokładna przyczyna niepowodzenia nie jest znana. |