gps

来自于：开发者立即使用

getGpsState openGpsSettingView

概述

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状态
  • 内部字段：
  1. {
  2.     status:1     //注意：这里两个平台的返回值含义不一样，返回值和对应含义如下：
  3.                  //对于iOS:  1：定位服务已打开，0:定位服务未打开  
  4.                  //对于Android：1：同时使用网络和GPS定位；
  5.                                2：仅使用GPS定位；
  6.                                3：仅使用网络定位
  7.                                 0：定位服务未打开 
  8. }

示例代码

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

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

openGpsSettingView

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

openGpsSettingView(callback(ret))

callback(ret)

ret:

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

示例代码

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

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本