Gunakan WVLocation JavaScript API untuk mendapatkan dan mencari lokasi geografis - SuperApp - Alibaba Cloud - SuperApp

Dokumen ini menjelaskan JSAPI untuk kelas WVLocation, yang dapat Anda gunakan sebagai referensi saat mengembangkan aplikasi H5 atau mini program. JSAPI ini memungkinkan Anda mencari dan mengambil informasi lokasi.

WVLocation.getLocation

Mengambil lokasi saat ini.

Catatan

Pada iOS 8 dan versi setelahnya, Apple mengubah persyaratan izin lokasi untuk aplikasi. Untuk menampilkan prompt izin lokasi, Anda harus menambahkan kunci NSLocationWhenInUseUsageDescription dan NSLocationAlwaysUsageDescription ke file Info.plist aplikasi.
Pada iOS 11 dan versi setelahnya, Anda harus menambahkan kedua kunci NSLocationAlwaysAndWhenInUseUsageDescription dan NSLocationWhenInUseUsageDescription ke file Info.plist agar prompt izin lokasi ditampilkan.

Parameter input

enableHighAccuracy ([boolean], opsional): Menentukan apakah akan mengambil lokasi dengan akurasi tinggi. Nilai yang valid adalah true dan false. Nilai default-nya adalah false.
address ([boolean], opsional): Menentukan apakah akan mengambil deskripsi alamat, seperti "Hangzhou, Tiongkok". Jika tidak meminta deskripsi alamat, koordinat akan dikembalikan lebih cepat. Nilai default-nya adalah false.

Parameter callback

Jika operasi berhasil, callback success dipanggil dengan parameter berikut. Jika gagal, callback failure dipanggil.

coords ([object]): Informasi koordinat.
- longitude ([string]): Bujur.
- latitude ([string]): Lintang.
- accuracy ([string]): Akurasi horizontal.
address ([object]): Informasi alamat.
- city ([string]): Kota.
- province ([string]): Provinsi.
- area ([string]): Area.
- road ([string]): Jalan.
- addressLine ([string]): Baris alamat.
- cityCode ([string]): Kode kota. Di Android, bidang ini hanya tersedia pada client Taobao karena data lokasi Google tidak menyertakannya.

Penting

Karena variasi dalam akurasi lokasi dan API dasar yang digunakan, informasi alamat yang dikembalikan mungkin tidak lengkap atau tidak akurat. Aplikasi H5 Anda harus mampu menangani ketidakkonsistenan data semacam ini.

var params = {
        // Menentukan apakah akan mengambil lokasi dengan akurasi tinggi
        enableHighAccuracy: true,
        // Menentukan apakah akan mengambil deskripsi alamat
        address: true
};
window.WindVane.call('WVLocation', 'getLocation', params, function(e) {
        alert('success:' + JSON.stringify(e));
}, function(e) {
        alert('failure:' + JSON.stringify(e));
});

WVLocation.searchLocation

Catatan

API ini hanya tersedia pada WindVane untuk iOS.

Mencari koordinat dari alamat tertentu.

Parameter input

addrs ([string]): Alamat yang akan dicari.

Parameter callback

Jika operasi berhasil, callback success dipanggil dengan parameter berikut. Jika gagal, callback failure dipanggil.

longitude ([string]): Bujur.
latitude ([string]): Lintang.

var params = {
        // Alamat yang akan dicari
        addrs: '960 West xxxx Road'};
window.WindVane.call('WVLocation', 'searchLocation', params, function(e) {
        alert('success:' + JSON.stringify(e));
}, function(e) {
        alert('failure:' + JSON.stringify(e));
});