Elevation

ElevationService class

google.maps.ElevationService class

Określa klasę usługi, która komunikuje się bezpośrednio z serwerami Google, aby żądać danych dotyczących rzeźby terenu.

Dostęp przez połączenie telefoniczne 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:  request:  PathElevationRequest callback:  function(Array<ElevationResult> optional, ElevationStatus): void optional Wartość zwracana:  Promise<PathElevationResponse> Wysyła żądanie dotyczące wysokości wzdłuż ścieżki, gdzie dane wysokości są zwracane jako próbki na podstawie odległości wzdłuż tej ścieżki.
getElevationForLocations	getElevationForLocations(request[, callback]) Parametry:  request:  LocationElevationRequest callback:  function(Array<ElevationResult> optional, ElevationStatus): void optional Wartość zwracana:  Promise<LocationElevationResponse> Wysyła żądanie dotyczące elewacji dla listy pojedynczych lokalizacji.

Interfejs LocationElevationRequest

google.maps.LocationElevationRequestinterfejs

żądanie wysokości 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 Wybrane lokalizacje, dla których mają być pobierane wysokości.

Interfejs LocationElevationResponse

google.maps.LocationElevationResponseinterfejs

Odpowiedź dotycząca wysokości zwrócona przez ElevationService zawierająca listę ElevationResult pasujących do lokalizacji LocationElevationRequest.

Właściwości
results	Typ:  Array<ElevationResult> Lista ElevationResult pasujących do lokalizacji LocationElevationRequest.

Interfejs PathElevationRequest

google.maps.PathElevationRequestinterfejs

Zapytanie dotyczące wysokości wysłane przez ElevationService zawierające ścieżkę, wzdłuż której mają być zwracane dane próbkowane. To żądanie definiuje ciągłą ścieżkę na kuli ziemskiej, 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 korzystają z segmentów wielkiego koła między tymi 2 punktami.

Właściwości
samples	Typ:  number Wymagane. Liczba punktów równoodległych wzdłuż danej ścieżki, dla których mają być pobierane dane o wysokości, w tym punkty końcowe. Liczba próbek musi być liczbą z zakresu 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.

Interfejs PathElevationResponse

google.maps.PathElevationResponseinterfejs

Odpowiedź dotycząca wysokości zwrócona przez ElevationService zawierająca listę ElevationResult rozmieszczonych równomiernie wzdłuż ścieżki PathElevationRequest.

Właściwości
results	Typ:  Array<ElevationResult> Lista ElevationResult pasujących do próbek PathElevationRequest.

Interfejs ElevationResult

google.maps.ElevationResultinterfejs

Wynik żądania ElevationService, który składa się z zestawu współrzędnych wysokości i ich wartości. Pamiętaj, że pojedyncze żą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, na podstawie których została interpolowana wysokość. Ta właściwość nie będzie widoczna, jeśli rozdzielczość jest nieznana. Pamiętaj, że dane dotyczące wysokości stają się mniej dokładne (wartości resolution są większe), gdy przechodzi się przez wiele punktów. Aby uzyskać najdokładniejszy odczyt wysokości dla danego punktu, należy go zapytać osobno.
location optional	Typ:  LatLng optional Lokalizacja tego wyniku wzniesienia.

stałe ElevationStatus

google.maps.ElevationStatus stałe

Stan zwracany przez ElevationService po zakończeniu przetwarzania prośby o podniesienie uprawnień. Określ je za pomocą wartości lub nazwy stałej. Na przykład 'OK' lub google.maps.ElevationStatus.OK.

Dostęp przez połączenie telefoniczne const {ElevationStatus} = await google.maps.importLibrary("elevation"). Zobacz Biblioteki w Maps JavaScript API.

Stałe
INVALID_REQUEST	Żądanie jest nieprawidłowe.
OK	Żądanie nie napotkało żadnych błędów.
OVER_QUERY_LIMIT	Strona przekroczyła limit żądań w zbyt krótkim czasie.
REQUEST_DENIED	Strona internetowa nie może korzystać z usługi dotyczącej wysokości.
UNKNOWN_ERROR	Nie udało się przetworzyć żądania podwyższenia uprawnień, ale dokładny powód niepowodzenia nie jest znany.