全部产品
云市场

地理位置 WVLocation

更新时间:2019-01-14 16:37:59

WVLocation.getLocation

获取当前的地理位置。

注意:VER.iOS 8 后苹果修改了应用的定位权限,应用必须在 Info.plist 中加入 NSLocationWhenInUseUsageDescriptionNSLocationAlwaysUsageDescription 的关键字,才能正常的弹出请求定位权限的提示。VER.iOS 11 后必须在 Info.plist 中同时加入 NSLocationAlwaysAndWhenInUseUsageDescriptionNSLocationWhenInUseUsageDescription 的关键字。

输入参数

  • [string] enableHighAcuracy - [可选]是否获取高精度的位置,true/faluse,默认为 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 端请务必做好数据的异常处理。

  1. var params = {
  2. // 是否获取高精度的位置
  3. enableHighAcuracy: true,
  4. // 是否获取地址描述
  5. address: true
  6. };
  7. window.WindVane.call('WVLocation', 'getLocation', params, function(e) {
  8. alert('success:' + JSON.stringify(e));
  9. }, function(e) {
  10. alert('failure:' + JSON.stringify(e));
  11. });

WVLocation.searchLocation

仅限 WindVane iOS

搜索给定地址的地理位置经纬度。

输入参数

  • [string] addrs - 要搜索的地址。

回调参数

回调参数将会在回调方法中传递,如果成功获取,则进入 success 回调,否则进入 failure 回调。

  • [string] longitude - 经度。
  • [string] latitude - 纬度。
  1. var params = {
  2. // 要搜索的地址
  3. addrs: '浙江省杭州市余杭区文一西路960号'
  4. };
  5. window.WindVane.call('WVLocation', 'searchLocation', params, function(e) {
  6. alert('success:' + JSON.stringify(e));
  7. }, function(e) {
  8. alert('failure:' + JSON.stringify(e));
  9. });