ElevationService
google.maps.ElevationService
klasa
biblioteka "elevation"
Definiuje klasę usługi, która komunikuje się bezpośrednio z serwerami Google w celu żądania danych o wysokości.
const {ElevationService} = await google.maps.importLibrary("elevation");
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:
Wartość zwracana:
Promise<PathElevationResponse>Wysyła żądanie danych o wysokości na ścieżce, gdzie dane o wysokości są zwracane jako próbki na podstawie odległości na tej ścieżce. |
getElevationForLocations |
getElevationForLocations(request[, callback])Parametry:
Wartość zwracana:
Promise<LocationElevationResponse>Wysyła żądanie dotyczące wysokości dla listy odrębnych lokalizacji. |
LocationElevationRequest interface
Interfejs
google.maps.LocationElevationRequest
Żądanie danych o wysokości wysłane przez ElevationService zawierające listę współrzędnych (LatLng), dla których mają zostać zwrócone dane o wysokości.
Właściwości | |
|---|---|
locations
opcjonalne |
Typ:
Array<LatLng|LatLngLiteral> optionalKonkretne lokalizacje, dla których chcesz pobrać wysokości. |
LocationElevationResponse interface
Interfejs
google.maps.LocationElevationResponse
Odpowiedź dotycząca wysokości zwrócona przez ElevationService, zawierająca listę ElevationResult odpowiadających lokalizacjom LocationElevationRequest.
Właściwości | |
|---|---|
results |
Typ:
Array<ElevationResult>Lista ElevationResult odpowiadających lokalizacjom LocationElevationRequest. |
Interfejs PathElevationRequest
Interfejs
google.maps.PathElevationRequest
Zapytanie o wysokość wysłane przez ElevationService zawierające ścieżkę, wzdłuż której mają zostać zwrócone dane próbkowane. To żądanie definiuje ciągłą ścieżkę na powierzchni Ziemi, wzdłuż której próbki wysokości powinny być pobierane w równych odstępach. Wszystkie ścieżki od wierzchołka do wierzchołka wykorzystują segmenty koła wielkiego między tymi 2 punktami.
Właściwości | |
|---|---|
samples |
Typ:
numberWymagane. 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
opcjonalne |
Typ:
Array<LatLng|LatLngLiteral> optionalŚcieżka, wzdłuż której mają być zbierane wartości wysokości. |
Interfejs PathElevationResponse
Interfejs
google.maps.PathElevationResponse
Odpowiedź dotycząca wysokości zwrócona przez ElevationService, zawierająca listę 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. |
Interfejs ElevationResult
Interfejs
google.maps.ElevationResult
Wynik żądania ElevationService, składający się ze zbioru współrzędnych wysokości i ich wartości. Pamiętaj, że jedno żądanie może wygenerować wiele obiektów 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, na podstawie których interpolowano wysokość. Jeśli rozdzielczość jest nieznana, ta właściwość nie będzie dostępna. Pamiętaj, że dane o wysokości stają się mniej dokładne (większe wartości resolution), gdy przekazywanych jest wiele punktów. Aby uzyskać jak najdokładniejszą wartość wysokości punktu, należy wysłać zapytanie niezależnie. |
location
opcjonalne |
Typ:
LatLng optionalLokalizacja tego wyniku wysokości. |
Stałe ElevationStatus
google.maps.ElevationStatus
stałe
biblioteka "elevation"
Stan zwracany przez ElevationService po zakończeniu żądania podniesienia uprawnień. Możesz je określić za pomocą wartości lub nazwy stałej. Na przykład 'OK' lub google.maps.ElevationStatus.OK.
Te stałe mogą być też używane jako ciągi znaków. W języku TypeScript literały ciągów znaków są definiowane przez typ ElevationStatusString.
const {ElevationStatus} = await google.maps.importLibrary("elevation");
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 internetowa nie może korzystać z usługi wysokości n.p.m. |
UNKNOWN_ERROR |
Nie udało się przetworzyć prośby o podniesienie uprawnień, ale dokładna przyczyna niepowodzenia nie jest znana. |