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.LocationElevationRequest
interfejs
Żą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> optional Dyskretne lokalizacje, dla których mają zostać pobrane wysokości. |
LocationElevationResponse interfejs
google.maps.LocationElevationResponse
interfejs
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.PathElevationRequest
interfejs
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:
number Wymagane. 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.PathElevationResponse
interfejs
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.ElevationResult
interfejs
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:
number Wysokość tego punktu na Ziemi w metrach nad poziomem morza. |
resolution |
Typ:
number Odległ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 optional Lokalizacja 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. |