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 mengirimkan kueri elevasi ke server Google. |
Metode | |
---|---|
getElevationAlongPath |
getElevationAlongPath(request[, callback]) Parameter:
Nilai Hasil:
Promise<PathElevationResponse> Membuat permintaan elevasi sepanjang jalur, dan data elevasi dikembalikan sebagai sampel berdasarkan jarak sepanjang jalur itu. |
getElevationForLocations |
getElevationForLocations(request[, callback]) Parameter:
Nilai Hasil:
Promise<LocationElevationResponse> Membuat permintaan elevasi untuk daftar lokasi terpisah. |
Antarmuka LocationElevationRequest
Antarmuka
google.maps.LocationElevationRequest
Permintaan elevasi yang dikirim oleh ElevationService
yang berisi daftar koordinat terpisah (LatLng
) yang data elevasinya akan ditampilkan.
Properti | |
---|---|
locations optional |
Jenis:
Array<LatLng|LatLngLiteral> optional Lokasi diskret yang ingin diambil 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 yang digunakan untuk menampilkan sampel data. Permintaan ini mendefinisikan jalur berkelanjutan di sepanjang bumi dan sampel elevasi yang harus diambil pada jarak yang berjarak sama. Semua jalur dari verteks ke verteks 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 diambil, termasuk titik akhir. Jumlah sampel harus berupa nilai antara 2 dan 512 inklusif. |
path optional |
Jenis:
Array<LatLng|LatLngLiteral> optional Jalur yang digunakan 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 contoh 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 Ketinggian 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 akan 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
google.maps.ElevationStatus
konstanta
Status yang ditampilkan oleh ElevationService
setelah menyelesaikan permintaan elevasi. 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 menemukan error apa pun. |
OVER_QUERY_LIMIT |
Halaman web telah melampaui batas permintaan dalam jangka waktu yang terlalu singkat. |
REQUEST_DENIED |
Halaman web tidak diizinkan menggunakan layanan ketinggian. |
UNKNOWN_ERROR |
Permintaan elevasi tidak berhasil diproses, tapi alasan pasti kegagalan tidak diketahui. |