地理位置 - SuperApp

本文介紹地理位置類WVLocation相關的JSAPI，供您建立H5端應用或者小程式時參考。地理位置類WVLocation的JSAPI提供搜尋、擷取地理位置的相關能力。

WVLocation.getLocation

擷取當前的地理位置。

說明

VER.iOS 8後蘋果修改了應用的定位許可權，應用必須在Info.plist中加入 NSLocationWhenInUseUsageDescription和NSLocationAlwaysUsageDescription的關鍵字，才能正常的彈出請求定位許可權的提示。
VER.iOS 11後必須在Info.plist中同時加入NSLocationAlwaysAndWhenInUseUsageDescription和 NSLocationWhenInUseUsageDescription的關鍵字，才能正常的彈出請求定位許可權的提示。

輸入參數

[string]enableHighAccuracy：可選，是否擷取高精度的位置，取值：true、false，預設為false。
[boolean] address：可選，是否擷取地址描述，如中國杭州市，取值：true、false，如果不擷取地址描述，則可以更快的返回經緯度。預設為false。

回調參數

回調參數將會在回調方法中傳遞，如果成功擷取，則進入success回調，否則進入failure回調。

[object]coords：經緯度資訊：
- [string]longitude：經度。
- [string]latitude：緯度。
- [string]accuracy：水平精度。
[object]address：地址資訊：
- [string]city：城市。
- [string]province：省。
- [string]area：區。
- [string]road：道路。
- [string]addressLine：詳細地址。
- [string]cityCode：城市代碼。如果是Android平台的非手淘用戶端，無法擷取此欄位，原因是Google返回的資料中沒有該欄位。

重要

由於定位的精度和使用的介面的緣故，地址資訊可能並不完整（例如缺少某些項），或精度較低，因此 H5端請務必做好資料的異常處理。

var params = {
        // 是否擷取高精度的位置
        enableHighAccuracy: true,
        // 是否擷取地址描述
        address: true
};
window.WindVane.call('WVLocation', 'getLocation', params, function(e) {
        alert('success:' + JSON.stringify(e));
}, function(e) {
        alert('failure:' + JSON.stringify(e));
});

WVLocation.searchLocation

說明

該API僅適用於WindVane iOS。

搜尋給定地址的地理位置經緯度。

輸入參數

[string]addrs：要搜尋的地址。

回調參數

回調參數將會在回調方法中傳遞，如果成功擷取，則進入success回調，否則進入failure回調。

[string]longitude：經度。
[string]latitude：緯度。

var params = {
        // 要搜尋的地址
        addrs: ' xxxx西路960號'};
window.WindVane.call('WVLocation', 'searchLocation', params, function(e) {
        alert('success:' + JSON.stringify(e));
}, function(e) {
        alert('failure:' + JSON.stringify(e));
});