Lokasi geografis - SuperApp

Topik ini menjelaskan API JavaScript dari WVLocation. Anda dapat merujuk ke topik ini saat membuat aplikasi HTML5 atau MiniApps. Gunakan API JavaScript WVLocation untuk mencari atau mendapatkan lokasi geografis.

WVLocation.getLocation

Mendapatkan lokasi geografis.

Catatan

Dari iOS 8 hingga iOS 10, permintaan izin lokasi hanya ditampilkan setelah NSLocationWhenInUseUsageDescription dan NSLocationAlwaysUsageDescription ditambahkan ke Info.plist.
Di iOS 11 dan seterusnya, permintaan izin lokasi hanya ditampilkan setelah NSLocationAlwaysAndWhenInUseUsageDescription dan NSLocationWhenInUseUsageDescription ditambahkan ke Info.plist.
iOS perlu mendaftarkan EMASUserInfoService untuk memanggil API ini.

Parameter Input

[string] enableHighAccuracy: (opsional) menentukan apakah akan mendapatkan lokasi dengan presisi tinggi. Nilai valid: true dan false. Nilai default: false.
[boolean] address: (opsional) menentukan apakah akan mendapatkan alamat, seperti China (Hangzhou). Nilai valid: true dan false. Waktu respons dapat dipersingkat dengan mengatur parameter ini ke false. Nilai default: false.

Parameter Callback

Parameter callback diteruskan menggunakan metode callback. Jika lokasi geografis berhasil diperoleh, callback success dipanggil. Sebaliknya, callback failure dipanggil.

[object] coords: koordinat lokasi.
- [string] longitude: garis bujur.
- [string] latitude: garis lintang.
- [string] accuracy: presisi.
[object] address: alamat.
- [string] city: kota.
- [string] province: provinsi.
- [string] area: distrik.
- [string] road: jalan.
- [string] addressLine: alamat lengkap.
- [string] cityCode: kode kota. Jika aplikasi Android Anda bukan Taobao, Anda tidak dapat memperoleh kode kota karena data yang dikembalikan oleh Google tidak berisi bidang ini.

Penting

Presisi lokasi dan antarmuka lokasi dapat memengaruhi alamat yang dikembalikan. Alamat mungkin tidak berisi beberapa bidang, atau alamat mungkin tidak akurat. Oleh karena itu, kami menyarankan agar Anda mengonfigurasi penanganan kesalahan yang tepat untuk data abnormal di aplikasi HTML5 atau MiniApps Anda.

var params = {
        // Tentukan apakah akan mendapatkan lokasi dengan presisi tinggi.
        enableHighAccuracy: true,
        // Tentukan apakah akan mendapatkan alamat.
        address: true
};
window.WindVane.call('WVLocation', 'getLocation', params, function(e) {
        alert('sukses:' + JSON.stringify(e));
}, function(e) {
        alert('gagal:' + JSON.stringify(e));
});

WVLocation.searchLocation

Catatan

API ini hanya tersedia di WindVane iOS.

Mencari alamat yang ditentukan dan mendapatkan garis lintang serta garis bujur.

Parameter Input

[string] addrs: alamat yang ingin Anda cari.

Parameter Callback

Parameter callback diteruskan menggunakan metode callback. Jika lokasi geografis berhasil diperoleh, callback success dipanggil. Sebaliknya, callback failure dipanggil.

[string] longitude: garis bujur.
[string] latitude: garis lintang.

var params = {
        // Alamat yang ingin Anda cari.
        addrs: ' No.960 xxxx West Road'};
window.WindVane.call('WVLocation', 'searchLocation', params, function(e) {
        alert('sukses:' + JSON.stringify(e));
}, function(e) {
        alert('gagal:' + JSON.stringify(e));
});