百度地图 API
  1. 其他说明
百度地图 API
  • 获取密钥
    • 获取秘钥
  • 地点检索
    • 地点检索V2.0
      • 服务介绍
      • 服务文档
      • 使用指南
      • 常用问题
      • 更新日志
      • 资源下载
      • 行政区划区域检索
      • 圆形区域检索
      • 地点详情检索
  • 地点输入提示
    • 地点输入提示V2.0
      • 服务介绍
      • 使用指南
      • 常见问题
      • 更新日志
      • 资源下载
      • 地点输入提示接口
  • 正/逆地理编码
    • 地理编码
      • 服务介绍
      • 使用指南
      • 常用问题
      • 更新日志
      • 资源下载
      • 地理编码
    • 全球逆地理编码
      • 服务介绍
      • 使用指南
      • 常见问题
      • 更新日志
      • 资源下载
      • 逆地理编码
  • 轻量级轨迹服务
    • 轨迹纠偏API
      • 服务介绍
      • 使用指南
      • 更新日志
      • 轨迹纠偏
    • 轨迹重合率分析API
      • 服务介绍
      • 使用指南
      • 更新日志
      • 轨迹重合率分析API
    • 轨迹分析API
      • 服务介绍
      • 使用指南
      • 更新日志
      • 轻量轨迹分析API
  • 道路信息预警服务
    • 超速判断API
      • 服务介绍
      • 使用指南
      • 更新日志
      • 超速判断API
  • 路线规划
    • 轻量级路线规划
      • 服务介绍
      • 使用指南
      • 常见问题
      • 更新日志
      • 服务文档
      • 驾车路线规划
      • 骑行路线规划
      • 步行路线规划
      • 公交路线规划
    • 路线规划
      • 服务介绍
      • 使用指南
      • 常见问题
      • 更新日志
      • 服务文档
      • 摩托车路线规划
      • 公交路线规划
      • 骑行路线规划
      • 驾车路线规划
    • 货车路线规划
      • 服务介绍
      • 使用指南
      • 常用问题
      • 更新日志
      • 服务文档
      • 货车路线规划
  • 智能调度
    • 路网矩阵API
      • 服务介绍
      • 服务文档
      • 使用指南
      • 常用问题
      • 更新日志
      • 路网创建接口
      • 路网查询接口
      • 路网新增/减少网点/更新网点坐标
      • 网点线路更新
      • 路网删除
      • 路网任务执行时间查询接口
      • 路网任务权重修改接口
    • 排单排线API
      • 服务介绍
      • 服务文档
      • 使用指南
      • 常用问题
      • 更新日志
      • 排单排线计算
      • 排单排线查询
      • 线内优化排单计算
      • 线内优化结果查询
      • 多点有序排单计算
      • 多点有序排单查询
    • 快速排单API
      • 服务介绍
      • 服务文档
      • 使用指南
      • 常见问题
      • 更新日志
      • 快速排单计算
      • 快速排单查询
    • 多仓排单API
      • 服务介绍
      • 服务文档
      • 使用指南
      • 常见问题
      • 更新日志
      • 多仓排单排线计算
      • 多仓排单排线查询
  • 私有化图层
    • 私有化地址库
      • 服务介绍
      • 服务文档
      • 使用指南
      • 常见问题
      • 更新日志
    • 私有化路线库
      • 服务介绍
      • 服务文档
      • 使用指南
      • 常用问题
      • 更新日志
  • 天气查询
    • 国内天气查询
      • 服务介绍
      • 服务文档
      • 使用指南
      • 常见问题
      • 更新日志
      • 资源下载
      • 基础服务
      • 高级权限(国内经纬度天气查询)
    • 海外天气查询
      • 服务介绍
      • 服务文档
      • 使用指南
      • 常见问题
      • 更新日志
      • 资源下载
      • 基础服务
      • 高级权限(海外经纬度天气查询)
  • 批量算路
    • 服务介绍
    • 服务文档
    • 使用指南
    • 常见问题
    • 更新日志
    • 服务地址批量算路
  • 货车批量算路
    • 服务介绍
    • 服务文档
    • 使用指南
    • 常见问题
    • 更新日志
    • 货车路线规划
  • 地址解析聚合
    • 服务介绍
    • 服务文档
    • 使用指南
    • 常见问题
    • 更新日志
    • 地址解析聚合
  • 城乡类型判别
    • 服务介绍
    • 服务文档
    • 使用指南
    • 常见问题
    • 更新日志
    • 城乡类别判别
  • 行政区划查询服务
    • 服务介绍
    • 使用指南
    • 常见问题
    • 更新日志
    • 服务文档
    • 行政区划查询服务
  • 区域边界查询服务
    • 服务介绍
  • 普通IP定位
    • 服务介绍
    • 使用指南
    • 常见问题
    • 更新日志
    • 服务文档
    • 普通IP定位
  • 智能硬件定位
    • 服务介绍
    • 使用指南
    • 常见问题
    • 更新日志
    • 服务文档
    • 智能硬件定位
  • 鹰眼轨迹
    • 概述
    • 常见问题
    • 更新日志
    • 相关下载
    • 获取密钥
      • 获取密钥
    • 开发指南
      • 账号和获取密钥
      • 鹰眼基本概念
      • 权限和配额
      • Hello鹰眼
      • 连接设备
      • 轨迹追踪
      • 轨迹存储
      • 轨迹查询
      • 轨迹纠偏
      • 空间搜索
      • 地理围栏
      • 轨迹分析
      • 经验行为分析
      • 交通方式识别
      • 图像存储
      • 全球轨迹服务
      • 轨迹管理台使用手册
      • 轨迹管理台开源代码
    • 行业解决方案
      • 物流车队管理方案
    • 鹰眼Web服务API
      • 接口总览
      • 附录
      • 终端管理
        • 终端管理
        • 添加entity
        • 更新entity
        • 删除entity
        • 查询entity
      • 空间搜索
        • 空间搜索
        • 关键字搜索
        • 矩形范围搜索
        • 周边搜索
        • 多边形搜索
        • 行政区搜索
      • 轨迹上传
        • 轨迹上传
        • 上传单个轨迹点
        • 批量添加轨迹点
      • 轨迹查询和纠偏
        • 轨迹查询和纠偏
        • 实时纠偏
        • 查询轨迹里程
        • 轨迹查询与纠偏
      • 轨迹分析
        • 轨迹分析
        • 停留点查询
        • 驾驶行为分析
      • 经验行为分析
        • 经验行为分析
        • createjob接口创建任务
        • getjob接口定期查询任务
      • ETC费用
        • ETC费用
        • 货车ETC费用
        • 乘用车ETC费用
      • 地理围栏管理
        • 地理围栏管理
        • 创建圆形围栏
        • 更新圆形围栏
        • 创建多边形围栏
        • 更新多边形围栏
        • 创建线型围栏
        • 更新线型围栏
        • 创建行政区划围栏
        • 更新行政区划围栏
        • 删除围栏
        • 删除围栏可去除监控的entity
        • 增加围栏需监控的entity
        • 查询围栏
        • 查询围栏监控的所有entity
      • 地理围栏报警
        • 地理围栏报警
        • 查询监控对象相对围栏的状态
        • 根据坐标查询监控对象相对围栏的状态
        • 查询某监控对象的围栏报警信息
        • 批量查询所有围栏报警信息
      • 批量导出轨迹
        • 批量导出轨迹
        • 创建任务
        • 删除任务
        • 查询任务
      • 历史轨迹搜索
        • 历史轨迹搜索
        • 创建检索任务
        • 查询搜索
        • 删除搜索任务
      • 自定义属性字段
        • 自定义属性字段
      • 坐标系说明
        • 坐标系说明
    • 鹰眼Android SDK
      • 概述
      • 获取密钥
      • 更新日志
      • 相关下载
      • Web轨迹管理台
      • 开发指南
        • 快速入门
          • 简介
          • 账号和获取密钥
          • 创建鹰眼服务
          • 鹰眼基本概念
          • 权限和配额
          • 配置工程
          • 隐私合规接口
          • Hello Trace
        • 功能说明
          • 轨迹追踪
          • 缓存轨迹处理
          • 空间搜索
          • 轨迹查询
          • 轨迹纠偏
          • 里程计算
          • 轨迹分析
          • 地理围栏
          • 图像存储
        • 其他说明
          • 服务的存活
          • 电量和流量
          • 运营商网络
          • 坐标系说明
    • 鹰眼iOS SDK
      • 概述
      • 获取密钥
      • 更新日志
      • 相关下载
      • Web轨迹管理台
      • 开发指南
        • 快速入门
          • 简介
          • 账号和获取密钥
          • 创建鹰眼服务
          • 鹰眼基本概念
          • 权限和配额
          • 配置工程
          • CocoaPods自动配置
          • 隐私合规接口说明
        • 功能说明
          • 轨迹追踪
          • 缓存轨迹处理
          • 空间搜索
          • 轨迹查询与纠偏
          • 里程计算
          • 地理围栏
          • 轨迹分析
        • 其他说明
          • 运营商网络
          • 坐标系说明
    • 鹰眼硬件设备
      • 鹰眼硬件产品概览
      • 博实结BSJ-M11
      • 成为CW-601E
      • 北斗易通E-198A
    • Web轨迹管理台
      • Web轨迹管理台
  • 实时路况查询
    • 服务介绍
    • 服务文档
    • 使用指南
    • 更新日志
    • 道路路况查询
    • 矩形区域路况查询
    • 多边形区域路况查询
    • 周边路况查询
  • 时区
    • 服务介绍
    • 服务文档
    • 使用指南
    • 常用问题
    • 更新日志
    • 时区
  • 批量服务
    • 服务介绍
    • 服务文档
    • 使用指南
    • 常见问题
    • 更新日志
    • 批量服务
  • 推荐上车点
    • 服务介绍
    • 服务文档
    • 使用指南
    • 常见问题
    • 更新日志
    • 推荐上车点
  • 坐标转换
    • 服务介绍
    • 服务文档
    • 使用指南
    • 常见问题
    • 更新日志
    • 坐标转换
  • 地图调起
    • 服务介绍
    • 常见问题
    • 更新日志
    • 相关下载
    • 开发指南
      • 简介
      • Hello World
    • 接口说明
      • web端
      • android端
      • iOS端
      • 地图标点功能
      • 地址解析
      • 反向地址解析
      • POI地点检索
      • 公交、地铁线路查询
      • 公交、驾车、步行路线规划
      • POI详情页展示
      • 全景服务
      • 展示地图
      • 自定义打点
      • 展现地图图区
      • 地址解析
      • 附近搜索
      • 驾车导航
      • 骑行导航
      • 步行导航
      • 导航到家
      • 调起离线导航包下载页面
      • 路线(出行)页面调起协议
      • 跳转出行早晚报页面
      • 跳转行程助手主页或者编辑页
      • 实时公交页面
      • 离线地图下载页面
      • 实时汇率页面
      • 实时翻译页面
      • 电子狗功能
      • 路况页面协议
      • AR识楼
      • 地铁图
      • IOS地图标注
      • iOS显示主图区
      • ios地址解析
      • ios反向地址解析
      • ios-POI(地点)搜索
      • ios用户位置附近检索
      • ios路线规划
      • ios公交、地铁线路查询
      • ios驾车导航
      • ios骑行导航
      • ios步行导航
      • ios-POI详情页展示
  • 静态图
    • 服务介绍
    • 服务文档
    • 可视化工具
    • 使用指南
  • 全景静态图
    • 功能介绍
    • 服务文档
    • 使用指南
  • 附录
    • 状态码定义
  • 概述
    • 概述
  1. 其他说明

服务的存活

简介
Android系统对应用长时间运行的要求日趋严格,轨迹追踪应用可能会被系统杀死,导致轨迹上传不完整。我们梳理了有助于Android APP保活方法,供开发者参考。同时,开发者应在严格遵守《百度地图开放平台产品和服务隐私政策》并保证应用合法合规的前提下使用百度鹰眼服务。
Android 8.0及以后版本保活建议
方法一:开发者自行向华为申请加入后台APP白名单,加入白名单后可具体申请方法可详询华为客服。以下提供过往开发者的经验供参考,但最终解释权为华为所有:https://github.com/852172891/Android-/tree/master
方法二:Android 8.0系统为实现降低功耗,会对后台应用获取用户当前位置的频率进行限制,只允许后台应用每小时接收几次位置更新。为了适配这一系统特性,开发者可以参考鹰眼Demo,生成一个前台服务通知,使得应用退到后台的时候,仍有前台通知在,从而规避Android 8.0系统对后台定位的限制。
核心代码如下:
Notification.Builder builder = new Notification.Builder(this);
Intent notificationIntent = new Intent(this, TracingActivity.class);
Bitmap icon = BitmapFactory.decodeResource(this.getResources(),
        R.mipmap.icon_tracing);
NotificationManager notificationManager = (NotificationManager)
getSystemService(Context.NOTIFICATION_SERVICE);
// PendingIntent
builder.setContentIntent(PendingIntent.getActivity(this, 0,
notificationIntent, 0))
        .setLargeIcon(icon)  // ()
        .setContentTitle("") //
        .setSmallIcon(R.mipmap.icon_tracing) //
        .setContentText("...") //
        .setWhen(System.currentTimeMillis());
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O && null !=
notificationManager) {
    NotificationChannel notificationChannel =
            new NotificationChannel("trace", "trace_channel",
                    NotificationManager.IMPORTANCE_HIGH);
    notificationManager.createNotificationChannel(notificationChannel);
    builder.setChannelId("trace"); // Android OchannelId
}
notification = builder.build(); // Notification
notification.defaults = Notification.DEFAULT_SOUND; //
LBSTraceClient mClient = new LBSTraceClient(mContext);
Trace mTrace = new Trace(serviceId, entityName);
mTrace.setNotification(notification);
通过上述方式开启前台服务后无需开发者手动释放,鹰眼SDK内部会随着停止鹰眼服务一并释放。开启前台服务在其他版本Android系统中使用也可 最大程度的增加定位进程的存活率,提升后台定位效果。
注意:在Android 8.0之后使用前台服务,需要申请以下权限:
<span style="color: #FF0000;">
<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
</span>
Android 10.0系统对定位限制更新严格,新增了后台定位权限,如果应用退到后台仍需定位,需要申请以下权限:
<uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" />
如何监控鹰眼service是否存活
判断鹰眼servcie存活有两种方法:
调用startTrace()来判断。若返回"服务已开启",则表明服务正在运行;若返回"success",则表明之前服务未在运行,但此时已被开启;若返回"服务正在开启",则表明之前服务未在运行,现在正在开启过程中,需等待服务开启完毕。
调用手机系统API判断当前正在运行的服务中是否有鹰眼服务。
维持鹰眼服务的运行
通常使用轨迹追踪的应用都需要长时间(后台)运行,开发者APP可尝试使用以下方式降低APP被杀死的概率:
关闭省电模式
若手机开启了省电模式、各手机厂商定制的优化模式(如小米手机的神隐模式)、第三方安全应用的省电模式(如360手机卫士),则进程可能会被杀死。 处理策略为,用户在手机端关闭省电模式,或将APP加入这些模式的白名单。
开启新线程定时开启鹰眼服务
当手机系统内存不足时,会回收进程,直至内存充足时系统会自动重启进程。针对这种情况,可在APP内新增一个独立的进程B,定时查询鹰眼serviceA是否是否出于开启状态。当监听到鹰眼进程A被杀死,则重新开启鹰眼服务。但如果进程B同时也被系统回收,则该方法失效。
设置APP允许后台运行
出于功耗和性能问题,当前Android允许禁止APP后台运行,即所谓的黑白名单。被禁止的APP是无法在后台运行,如果集成鹰眼SDK的APP需要后台继续运行,则需要设置允许后台运行。设置项大多手机都在设置功能的隐私和安全中提供。
保持屏幕常亮
手机(设备)在 锁屏状态下,Android系统会先进入浅休眠,然后深度休眠。APP会被挂起,导致继承鹰眼SDK的APP无法运行。设置手机(设备)保持屏幕常亮,可以防止休眠,保证APP运行。
保持手机处于充电状态
Android系统中电池功耗逻辑,会在设备处于充电状态时,不限制某些高功耗的功能,诸如网络链接,结合“保持屏幕常亮”,可以使集成鹰眼SDK的APP保活。
启用多媒体锁
为了确保MediaPlayer的承载的服务在系统睡眠的时候继续正常执行下去。Android为我们提供了一种唤醒锁(wake locks)的机制。它能够在系统睡眠时,依旧保持锁定硬件的正常工作。基于这种思路,可以在集成鹰眼SDK的APP中,使用Service继承MediaPlayer,播放一段无声音频文件,达到保活效果。确保在MediaPlayer执行的时候,哪怕系统睡眠了CUP也能正常执行。需要使用MediaPlayer.setWakeMode()为MediaPlayer设定唤醒锁。以下是setWakMode()的定义:setWakeMode(Context context, int mode)第一个參数是当前上下文,第二个參数为须要加锁的状态,被设定为int类型的常量,定义在PowerManager这个final类中。在这里仅仅须要设定为PARTIAL_WAKE_LOCK就可以。
// 设定CUP锁定 mediaPlayer = new MediaPlayer(); mediaPlayer.setWakeMode(getApplicationContext(), PowerManager.PARTIAL_WAKE_LOCK);
一般对于锁而言。锁定了通常须要解锁。可是这里的唤醒锁与MediaPlayer关联,所以仅仅须要在使用完之后release()释放MediaPlayer就可以,无需显式的为其解锁。在使用setWakeMode设定唤醒锁的时候,还必须为应用赋予对应的权限:
APP加入系统白名单
Doze模式是Android6.0上新出的一种模式,是一种全新的、低能耗的状态,在后台只有部分任务允许运行,其他都被强制停止。当用户一段时间没有使用手机的时候,Doze模式通过延缓app后台的CPU和网络活动减少电量的消耗。若手机厂商生产的定制机型中使用到该模式,需要申请将app添加进白名单,可尽量帮助鹰眼服务在后台持续运行,代码如下:
//位置采集周期
// 在Android 6.0及以上系统,若定制手机使用到doze模式,请求将应用添加到白名单。
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
    String packageName = trackApp.getPackageName();
    boolean isIgnoring = powerManager.isIgnoringBatteryOptimizations(packageName);
    if (!isIgnoring) {
        Intent intent = new Intent(
Settings.ACTION_REQUEST_IGNORE_BATTERY_OPTIMIZATIONS);
        intent.setData(Uri.parse("package:" + packageName));
        try {
            startActivity(intent);
        } catch (Exception ex) {
            ex.printStackTrace();
        }
    }
}
清单文件中添加权限声明:
//位置采集周期
<uses-permission android:name="android.permission.REQUEST_IGNORE_BATTERY_OPTIMIZATIONS"/>
保持设定的轨迹采集频率
手机锁屏后一段时间,cpu可能会进入休眠模式,此时无法严格按照采集周期获取定位依据,导致轨迹点缺失。避免这种情况的方式是APP持有电量锁。
退出应用时鹰眼服务存活问题
用户按下back键退出应用时,开发者可在MainActivity的onDestroy()方法中决定是否要继续追踪轨迹。
退出应用时,停止追踪轨迹:在onDestroy()方法中调用stopTrace(),此时无论是否联网,stopTrace()执行完毕后,鹰眼进程都将被被停止,不再追踪轨迹。
退出应用时,继续追踪轨迹:无需在onDestroy()中执行任何操作,由于activity和鹰眼服务的独立性,在退出应用时,仅会销毁Activity,并不会自动销毁鹰眼Service。因此,此时应用虽然退出了,但鹰眼服务仍在追踪轨迹。同理,当在设备的应用管理中,将正在运行的轨迹追踪应用停止,此时鹰眼service并不会停止,仍在后台运行
stopTrace后缓存数据上传问题
调用stopTrace后,将立即停止采集轨迹,对于缓存数据此时有两种情况:
设备网络通信正常:将继续回传缓存的轨迹数据,直至数据回传完毕,鹰眼服务停止,返回回调信息。数据回传过程中,如果遇到网络中断或鹰眼服务被杀死,将会中断回传,但数据仍会存储在设备端,待下次StartTrace时,优先回传缓存数据,再回传新采集的数据。
设备网络通信中断:立即停止采集轨迹,同时将缓存数据会存储在设备数据库中,鹰眼服务停止,并返回回调信息。
上一页
图像存储
下一页
电量和流量
Built with