react-native-amaptrace

Amap Trace SDK modules for React Native (Android),高德地图猎鹰轨迹 React Native 模块。(安卓)


Keywords
react-native
Install
npm install react-native-amaptrace@1.0.1

Documentation

react-native-amaptrace

Amap Trace SDK modules for React Native (Android),高德地图猎鹰轨迹 React Native 模块。(安卓)

高德猎鹰轨迹SDK文档

Getting started

$ npm install react-native-amaptrace --save

Mostly automatic installation

$ react-native link react-native-amaptrace

Manual installation

iOS

​ 暂不支持ios

Android

  1. 设置高德apiKey

    在AndroidManifest.xml设置高德apiKey。key申请方法详情参见高德申请密钥

    <meta-data
    	android:name="com.amap.api.v2.apikey"
        android:value="您申请的高德apikey" />
    
  2. 配置权限

    在AndroidManifest.xml中配置以上权限

    <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/>
    <!--用于访问GPS定位-->
    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>
    <!--用于获取运营商信息,用于支持提供运营商信息相关的接口-->
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
    <!--用于访问wifi网络信息,wifi信息会用于进行网络定位-->
    <uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/>
    <!--用于获取wifi的获取权限,wifi信息会用来进行网络定位-->
    <uses-permission android:name="android.permission.CHANGE_WIFI_STATE"/>
    <!--用于访问网络,网络定位需要上网-->
    <uses-permission android:name="android.permission.INTERNET"/>
    <!--用于读取手机当前的状态-->
    <uses-permission android:name="android.permission.READ_PHONE_STATE"/>
    <!--用于写入缓存数据到扩展存储卡-->
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
    <!--用于申请调用A-GPS模块-->
    <uses-permission android:name="android.permission.ACCESS_LOCATION_EXTRA_COMMANDS"/>
    <!--用于申请获取蓝牙信息进行室内定位-->
    <uses-permission android:name="android.permission.BLUETOOTH"/>
    <uses-permission android:name="android.permission.BLUETOOTH_ADMIN"/>
    

Usage

import RNAmaptrace, { AmapTraceEventEmitter } from 'react-native-amaptrace';

Init Service

RNAmaptrace.init({
    serviceId: 轨迹服务id,
    terminalId: 终端id,
    terminalName: 设备标识,
})

Start Service

// 开启轨迹上报
RNAmaptrace.createTrack();

Stop Service

RNAmaptrace.stopGather();  // 停止轨迹采集
RNAmaptrace.stopTrack();   // 停止轨迹服务

Query Trace

// 查询轨迹不能超过24小时,时间格式为字符串格式的时间戳
RNAmaptrace.historyTrackQuery({
    startTime: (new Date().getTime() - 12*60*60*1000).toString(),  // 起始时间
    endTime: new Date().getTime().toString(),  					   // 结束时间
});

添加事件监听

监听器标志 备注
ON_START_GATHER 开启定位采集
ON_START_TRACK 开启定位服务
ON_STOP_GATHER 停止定位采集
ON_STOP_TRACK 停止定位服务
LATLNG 查询轨迹信息
AmapTraceEventEmitter.addListener('ON_START_GATHER', (result) => {
	// 开启定位采集时的监听回调
	console.log('ON_START_GATHER', result);
})