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> optionalLokasi 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:
numberWajib. 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> optionalJalur 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:
numberKetinggian titik ini di Bumi, dalam meter di atas permukaan laut. |
resolution |
Jenis:
numberJarak, 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 optionalLokasi 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. |