Elevation

Class ElevationService

Class google.maps.ElevationService

Menentukan class layanan yang berkomunikasi langsung dengan server Google untuk meminta data elevasi.

Akses dengan memanggil const {ElevationService} = await google.maps.importLibrary("elevation"). Lihat Library di Maps JavaScript API.

Konstruktor
ElevationService	ElevationService() Parameter:  Tidak ada Membuat instance baru ElevationService yang mengirim kueri elevasi ke server Google.

Metode
getElevationAlongPath	getElevationAlongPath(request[, callback]) Parameter:  request:  PathElevationRequest callback:  function(Array<ElevationResult> optional, ElevationStatus): void optional Nilai Hasil:  Promise<PathElevationResponse> Membuat permintaan elevasi di sepanjang jalur, dengan data elevasi ditampilkan sebagai sampel berbasis jarak di sepanjang jalur tersebut.
getElevationForLocations	getElevationForLocations(request[, callback]) Parameter:  request:  LocationElevationRequest callback:  function(Array<ElevationResult> optional, ElevationStatus): void optional Nilai Hasil:  Promise<LocationElevationResponse> Membuat permintaan ketinggian untuk daftar lokasi terpisah.

Antarmuka LocationElevationRequest

Antarmuka google.maps.LocationElevationRequest

Permintaan elevasi yang dikirim oleh ElevationService yang berisi daftar koordinat diskret (LatLng) yang akan menampilkan data elevasi.

Properti
locations optional	Jenis:  Array<LatLng|LatLngLiteral> optional Lokasi terpisah yang akan digunakan untuk mengambil elevasi.

Antarmuka LocationElevationResponse

Antarmuka google.maps.LocationElevationResponse

Respons elevasi yang ditampilkan oleh ElevationService yang berisi daftar ElevationResult yang cocok dengan lokasi LocationElevationRequest.

Properti
results	Jenis:  Array<ElevationResult> Daftar ElevationResult yang cocok dengan lokasi LocationElevationRequest.

Antarmuka PathElevationRequest

Antarmuka google.maps.PathElevationRequest

Kueri elevasi yang dikirim oleh ElevationService yang berisi jalur untuk menampilkan data sampel. Permintaan ini menentukan jalur berkelanjutan di sepanjang bumi tempat sampel elevasi harus diambil dengan jarak yang sama. Semua jalur dari vertex ke vertex menggunakan segmen lingkaran besar di antara dua titik tersebut.

Properti
samples	Jenis:  number Wajib. Jumlah titik yang berjarak sama di sepanjang jalur tertentu yang data elevasinya akan diambil, termasuk endpoint. Jumlah sampel harus berupa nilai antara 2 dan 512 inklusif.
path optional	Jenis:  Array<LatLng|LatLngLiteral> optional Jalur untuk mengumpulkan nilai elevasi.

Antarmuka PathElevationResponse

Antarmuka google.maps.PathElevationResponse

Respons elevasi yang ditampilkan oleh ElevationService yang berisi daftar ElevationResult yang berjarak sama di sepanjang jalur PathElevationRequest.

Properti
results	Jenis:  Array<ElevationResult> Daftar ElevationResult yang cocok dengan sampel PathElevationRequest.

Antarmuka ElevationResult

Antarmuka google.maps.ElevationResult

Hasil permintaan ElevationService, yang terdiri dari kumpulan koordinat elevasi dan nilai elevasinya. Perhatikan bahwa satu permintaan dapat menghasilkan beberapa ElevationResult.

Properti
elevation	Jenis:  number Elevasi titik ini di Bumi, dalam meter di atas permukaan laut.
resolution	Jenis:  number Jarak, dalam meter, antara titik sampel yang digunakan untuk interpolasi elevasi. Properti ini tidak akan ada jika resolusi tidak diketahui. Perhatikan bahwa data elevasi menjadi kurang akurat (nilai resolution lebih besar) jika beberapa titik diteruskan. Untuk memperoleh nilai elevasi yang paling akurat bagi sebuah titik, maka harus dibuat kueri terpisah.
location optional	Jenis:  LatLng optional Lokasi hasil elevasi ini.

Konstanta ElevationStatus

Konstanta google.maps.ElevationStatus

Status yang ditampilkan oleh ElevationService setelah permintaan elevasi selesai. Tentukan ini berdasarkan nilai, atau dengan menggunakan nama konstanta. Misalnya, 'OK' atau google.maps.ElevationStatus.OK.

Akses dengan memanggil const {ElevationStatus} = await google.maps.importLibrary("elevation"). Lihat Library di Maps JavaScript API.

Konstanta
INVALID_REQUEST	Permintaan tidak valid.
OK	Permintaan tidak mengalami error apa pun.
OVER_QUERY_LIMIT	Halaman web telah melampaui batas permintaan dalam jangka waktu yang terlalu singkat.
REQUEST_DENIED	Halaman web tidak diizinkan untuk menggunakan layanan elevasi.
UNKNOWN_ERROR	Permintaan elevasi tidak berhasil diproses, tetapi alasan sebenarnya dari kegagalan tersebut tidak diketahui.