Klasa ElevationService
google.maps.ElevationService
zajęcia
Definiuje klasę usługi, która komunikuje się bezpośrednio z serwerami Google w celu żądania danych o wysokości.
Aby uzyskać dostęp, zadzwoń pod numer const {ElevationService} = await google.maps.importLibrary("elevation")
. Zobacz Biblioteki w interfejsie Maps JavaScript API.
Zespół | |
---|---|
ElevationService |
ElevationService() Parametry: brak
Tworzy nową instancję ElevationService , która wysyła do serwerów Google zapytania dotyczące podniesienia uprawnień. |
Metody | |
---|---|
getElevationAlongPath |
getElevationAlongPath(request[, callback]) Parametry:
Wartość zwrotu:
Promise<PathElevationResponse> Wysyła żądanie dotyczące wysokości wzdłuż ścieżki, przy czym dane o wysokości są zwracane jako próbki na trasie oparte na odległości. |
getElevationForLocations |
getElevationForLocations(request[, callback]) Parametry:
Wartość zwrotu:
Promise<LocationElevationResponse> Wysyła żądanie podniesienia dla listy konkretnych lokalizacji. |
Interfejs LocationElevationRequest
google.maps.LocationElevationRequest
interfejs
Żądanie dotyczące wysokości wysłane przez ElevationService
zawierające listę współrzędnych dyskretnych (LatLng
), dla których mają zostać zwrócone dane o wysokości.
Właściwości | |
---|---|
locations optional |
Typ:
Array<LatLng|LatLngLiteral> optional Oddzielne lokalizacje, dla których mają zostać pobrane dane o wysokości. |
Interfejs LocationElevationResponse
google.maps.LocationElevationResponse
interfejs
Odpowiedź o podniesieniu zwrócona przez funkcję ElevationService
zawierająca listę elementów ElevationResult
pasujących do lokalizacji obiektu LocationElevationRequest
.
Właściwości | |
---|---|
results |
Typ:
Array<ElevationResult> Lista elementów ElevationResult pasujących do lokalizacji obiektu LocationElevationRequest . |
Interfejs PathElevationRequest
google.maps.PathElevationRequest
interfejs
Zapytanie o wysokość wysłane przez ElevationService
zawierające ścieżkę, wzdłuż której mają zostać zwrócone spróbkowane dane. To żądanie określa ciągłą ścieżkę wzdłuż Ziemi, wzdłuż której należy pobrać próbki wysokości dla równomiernych odległości. Wszystkie ścieżki od wierzchołków do wierzchołków korzystają z segmentów wielkiego okręgu między tymi dwoma punktami.
Właściwości | |
---|---|
samples |
Typ:
number To pole jest wymagane. Liczba równoodległych punktów na danej ścieżce, dla których mają zostać pobrane dane o wysokości (w tym punkty końcowe). Liczba próbek musi być wartością z zakresu od 2 do 512 włącznie. |
path optional |
Typ:
Array<LatLng|LatLngLiteral> optional Ścieżka, wzdłuż której zbierane są wartości wysokości. |
Interfejs PathElevationResponse
google.maps.PathElevationResponse
interfejs
Odpowiedź o podniesieniu zwrócona przez funkcję ElevationService
zawierająca listę elementów ElevationResult
rozmieszczonych równomiernie na ścieżce obiektu PathElevationRequest
.
Właściwości | |
---|---|
results |
Typ:
Array<ElevationResult> Lista elementów ElevationResult pasujących do próbek zasobu PathElevationRequest . |
Interfejs ElevationResult
google.maps.ElevationResult
interfejs
Wynik żądania ElevationService
, obejmujący zestaw współrzędnych wysokości i ich wartości wysokości. Pamiętaj, że 1 żądanie może spowodować wygenerowanie wielu 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óbki, z których była interpolowana wysokość. Jeśli rozdzielczość nie będzie znana, ta właściwość będzie niedostępna. Zwróć uwagę, że dane o wysokości stają się bardziej przybliżone (większe wartości resolution ) po przekazaniu wielu punktów. Aby uzyskać możliwie dokładną wartość wysokości punktu, należy przeprowadzić niezależne zapytanie. |
location optional |
Typ:
LatLng optional Lokalizacja tego wyniku wzniesienia. |
Stałe ElevationStatus
google.maps.ElevationStatus
stałe
Stan zwrócony przez ElevationService
po zakończeniu prośby o podniesienie. Określ je według wartości lub nazwy stałej. Na przykład 'OK'
lub google.maps.ElevationStatus.OK
.
Aby uzyskać dostęp, zadzwoń pod numer const {ElevationStatus} = await google.maps.importLibrary("elevation")
. Zobacz Biblioteki w interfejsie Maps JavaScript API.
Stałe | |
---|---|
INVALID_REQUEST |
Żądanie było nieprawidłowe. |
OK |
Żądanie nie napotkał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 podwyższania. |
UNKNOWN_ERROR |
Nie udało się przetworzyć prośby o podwyższenie, ale dokładna przyczyna błędu nie jest znana. |