你可以通过一次简单的位置同步的来了解 Realtime Location 的用法。
环境准备
- 支持 Chrome、IE 10+ 、Firefox、Safari 等主流浏览器环境
1. 创建应用
首先,你需要在控制面板中创建应用。
2. 安装 SDK
Realtime Location 依赖于高德定位 SDK,因此需要按顺序引入:
通过标签引用
<script src="http://webapi.amap.com/maps?v=1.3&key=<AMapKey>"></script>
<script src="https://cdn.wilddog.com/sdk/js/2.5.6/wilddog.js"></script>
<script src="https://cdn.wilddog.com/sdk/js/0.1.0/wilddog-location.js"></script>
|
注意:
引入高德定位 SDK 的时候,需要填入你高德应用的 AMapKey。如果没有,请在高德开放平台中获取。
通过 npm 下载
1.安装依赖。
npm install wilddog wilddog-location
2.在代码中注册 Realtime Location 服务。
var wilddog = require('wilddog'); var RealtimeLocation = require('wilddog-location');
wilddog.regService('location', function(app) { if (app == null) { throw new Error('application not initialized!Please call wilddog.initializeApp first'); return; }; return new RealtimeLocation(app); }); wilddog.Location = RealtimeLocation;
|
3.在 html 中引用高德 api。
<script src="http://webapi.amap.com/maps?v=1.3&key=<AMapKey>"></script>
|
注意:
引入高德定位 SDK 的时候,需要填入你高德应用的 AMapKey。如果没有,请在高德开放平台中获取。
3. 初始化 SDK
使用 Realtime Location SDK 之前,需要先创建实例。
var config = { syncURL: "https://<appId>.wilddogio.com" }; wilddog.initializeApp(config); var wildLocation = wilddog.location();
|
注意:
初始化需要野狗 AppID。野狗 AppID 野狗控制面板 应用中获取。
4. 位置上传
startTracingPosition()
方法可以根据 Key 向云端持续上传设备位置,如果云端不存在该 Key,将会自动创建。
var locationProvider = wildLocation.AMapLocationProvider("timeInterval", 5000); wildLocation.startTracingPosition(key, locationProvider);
|
5. 位置监听
开启位置上传之后,你可以通过上传的 Key 监听位置的变化。
onPosition()
用于实时获取指定 Key 的最新位置信息。
var cancelCallback = wildLocation.onPosition(key, function(position) { console.log('最新位置的经纬度为: ', position.latitude(), ',' , position.longitude()); })
|
Realtime Location 更多使用方式,请参考 完整指南 和 API 文档。