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 ElevationService baru yang mengirimkan kueri elevasi ke server Google. |
Metode | |
---|---|
getElevationAlongPath |
getElevationAlongPath(request[, callback]) Parameter:
Nilai Hasil:
Promise<PathElevationResponse> Membuat permintaan elevasi sepanjang jalur, di mana data elevasi dikembalikan sebagai sampel berbasis jarak di sepanjang jalur tersebut. |
getElevationForLocations |
getElevationForLocations(request[, callback]) Parameter:
Nilai Hasil:
Promise<LocationElevationResponse> Membuat permintaan elevasi untuk daftar lokasi diskret. |
Antarmuka LocationElevationRequest
Antarmuka google.maps.LocationElevationRequest
Permintaan elevasi yang dikirim oleh ElevationService
berisi daftar koordinat diskret (LatLng
) yang akan mengembalikan data elevasi.
Properti | |
---|---|
locations optional |
Jenis:
Array<LatLng|LatLngLiteral> optional Lokasi terpisah yang akan 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 yang akan digunakan untuk menampilkan data sampel. Permintaan ini menetapkan jalur kontinu sepanjang bumi di sepanjang sampel elevasi yang akan diambil pada jarak yang sama. Semua jalur dari verteks ke verteks menggunakan segmen dari lingkaran besar di antara kedua titik tersebut.
Properti | |
---|---|
samples |
Jenis:
number Wajib diisi. Jumlah titik yang berjarak sama di sepanjang jalur yang diberikan untuk mengambil data elevasi, termasuk endpoint. Jumlah sampel harus bernilai antara 2 dan 512. |
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
dengan jarak yang 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 ketinggian dan nilai ketinggiannya. 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 menjadi lebih kasar (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 nilai ini menurut, 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 melebihi batas permintaan dalam jangka waktu yang terlalu singkat. |
REQUEST_DENIED |
Halaman web tidak diizinkan menggunakan layanan ketinggian. |
UNKNOWN_ERROR |
Permintaan elevasi tidak berhasil diproses, tetapi alasan persisnya kegagalan tidak diketahui. |