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:
Nilai yang Ditampilkan:
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:
Nilai yang Ditampilkan:
Promise<LocationElevationResponse> Membuat permintaan elevasi untuk daftar lokasi terpisah. |
LocationElevationRequest interface
google.maps.LocationElevationRequest
interface
Permintaan elevasi yang dikirim oleh ElevationService
yang berisi daftar koordinat diskrit (LatLng
) yang akan ditampilkan data elevasinya.
Properti | |
---|---|
locations optional |
Jenis:
Array<LatLng|LatLngLiteral> optional Lokasi terpisah yang elevasi akan diambil. |
LocationElevationResponse interface
google.maps.LocationElevationResponse
interface
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
google.maps.PathElevationRequest
interface
Kueri elevasi yang dikirim oleh ElevationService
yang berisi jalur yang akan digunakan untuk menampilkan data yang diambil sampelnya. Permintaan ini menentukan jalur berkelanjutan di sepanjang bumi yang sampel elevasinya harus diambil pada jarak yang sama. Semua jalur dari verteks ke verteks menggunakan segmen lingkaran besar di antara kedua titik tersebut.
Properti | |
---|---|
samples |
Jenis:
number Wajib. Jumlah titik 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 yang akan digunakan untuk mengumpulkan nilai elevasi. |
Antarmuka PathElevationResponse
google.maps.PathElevationResponse
interface
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
google.maps.ElevationResult
interface
Hasil permintaan ElevationService
, yang terdiri dari kumpulan koordinat elevasi dan nilai elevasi. 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. |
ElevationStatus constants
google.maps.ElevationStatus
konstanta
Status yang ditampilkan oleh ElevationService
setelah penyelesaian permintaan peningkatan. Tentukan ini berdasarkan nilai, atau 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. |
OVER_QUERY_LIMIT |
Halaman web telah melampaui batas permintaan dalam jangka waktu yang terlalu singkat. |
REQUEST_DENIED |
Halaman web tidak diizinkan menggunakan layanan elevasi. |
UNKNOWN_ERROR |
Permintaan elevasi tidak dapat diproses dengan berhasil, tetapi alasan pasti kegagalan tidak diketahui. |