gps

来自于:开发者立即使用

概述

gps封装了手机获取定位服务开关状态(包括GPS定位、网络定位)和打开系统gps设置界面的功能。

注意由于此模块使用了私有API,会导致iOS上架App Store被拒绝。 如需上架App Store,请不要使用此模块。

模块接口

getGpsState

获取定位服务开关状态。在Android上定位服务分3种,1、同时使用网络和GPS定位;2、仅使用GPS定位;3、仅使用网络定位。在iOS的设置界面上设置定位服务时只有一个开关,即打开和关闭定位服务。所以该接口的返回值需要把iOS和Android两个平台分开处理,请开发者注意。

getGpsState(callback(ret))

callback(ret)

ret:

  • 类型:JSON对象
  • 描述:返回gps状态
  • 内部字段:
{
    status:1     //注意:这里两个平台的返回值含义不一样,返回值和对应含义如下:
                 //对于iOS:  1:定位服务已打开,0:定位服务未打开  
                 //对于Android:1:同时使用网络和GPS定位;
                               2:仅使用GPS定位;
                               3:仅使用网络定位
                                0:定位服务未打开 
}

示例代码

var demo = api.require('gps');
demo.getGpsState(function(ret){
        alert(JSON.stringify(ret));
});

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

openGpsSettingView

打开系统自带的gps设置界面,用户可在此界面打开或关闭gps

openGpsSettingView(callback(ret))

callback(ret)

ret:

  • 类型:JSON对象
  • 内部字段:
{
    status: 1  //1:打开界面成功,0:打开界面失败  
}

示例代码

var demo = api.require('gps');
demo.openGpsSettingView(function(ret){
        alert(JSON.stringify(ret));
});

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本