2 功能使用

2.1 设置APP-KEY

设置APP-KEY除了1.2节中提到的在AndroidManifest.xml中配置外，SDK还提供了api在代码中来设置，比如

OneNetApi.setAppKey("xxxxxxxxx");

提供该api的目的是让开发者可以管理不同产品下的设备。

2.2 HTTP请求结果回调

public interface OneNetApiCallback {

    /**
     * Called when the HTTP response code was 2xx.
     */
    void onSuccess(int errno, String error, String data);

    /**
     * Called when the request could not be executed due to cancellation, a connectivity problem,
     * timeout or the HTTP response code was not 2xx.
     */
    void onFailed(Exception e);

}

• SDK请求结果回调的onSuccess()和onFailed()方法均运行在UI线程，方便对UI进行刷新
• onSuccess()方法表示Http请求成功，即Http响应码范围为[200, 300)时触发，并不是SDK的Api调用成功，Api调用是否成功取决于onSuccess()第一个参数errno，errno = 0表示该Api调用成功
• 同理，onFailed()方法表示Http请求失败。

2.3 地图数据点

数据点的通用格式为

{
    "at": "2013-04-22T00:35:43",
    "value": 42
}

或

{
    "at": "2013-04-22T00:35:43",
    "value": {}
}

其中at字段表示时间戳，是可选项，value字段支持的数据类型包括：

• 整型（int）
• 浮点数（float）
• 字符串（string）
• JSON格式
• 二进制数据

对于地图数据来说value对应的数据格式为：

{
    "lat": 0.0,
    "lon": 0.0,
    "ele": 0.0
}

lat表示纬度，lon表示经度，ele表示海拔，海拔不传不影响地图的展示，如果上传的数据点为地图支持的格式，那么在开发者中心预览的时候自动以地图的形式来预览，如下所示：