title: 快速入门

title: 快速入门

你可以通过一次简单的位置同步的来了解 Realtime Location 的用法。

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" //输入节点 URL
};
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 文档。