全部服务产品
开发者频道
定价
登录
附录1:错误码说明
status状态码message描述信息注释
0成功请求成功
1服务器内部错误请求成功
2参数错误具体错误信息将在 message 中给出
3http method错误检查请求的 http method(GET/POST)是否与接口描述一致
3003指定 entity 不存在未查询到 entity_name 为设定值的 entity,请检查 entity_name 是否输入错误或已被删除
3005entity_name已存在entity_name 是 entity 的唯一标识,在同一 service 中不可创建 entity_name 重复的 entity,请更换名字后再次尝试
3006查询时间段内的轨迹点过多,无法进行纠偏,请缩短查询时间entity_name不符合命名规范:仅支持中文、英文大小字母、英文下划线"_"、英文横线"-"和数字。
3007数据解析失败,数据中包含非utf8编码字符返回的字段值中存在非 utf8编码的字符。所有上传的字符均应以 utf8 编码
4005指定service_id不存在请求参数中service_id填写错误或不属于当前账号,请检查是否填写了正确的service_id
5101监控对象的围栏个数超出范围,最多100个一个监控对象最多可创建100个围栏,建议定期清理无效围栏
5102监控对象不存在创建或更新围栏时,指定的监控对象 entity_name 不存在
5103监控对象上没有fence_id为XXX的围栏
5104指定fence_id不存在
9001查询时间段内的轨迹点过多,无法进行轨迹分析,请缩短查询时间 一次请求查询的轨迹点不可超过两万,否则将返回失败
编码说明

API请求中需要用到中文或一些特殊字符的参数,如query、region等,为了避免提交到后台乱码,需要对这几个参数值进行编码处理,转换成UTF-8字符的二字符十六进制值,凡是不在下表中的字符都需要进行编码。

字符集合字符
URL非保留字a b c d e f g h i j k l m n o p q r s t u v w x y z A B C D E F G H I J K L M N O P Q R S T U V W X Y Z 0 1 2 3 4 5 6 7 8 9 - _ . ~
URL保留字! * ' ( ) ; : @ & = + $ , / ? % # [ ]

如果中文参数中使用URL保留字字符的字面意思,例如:region关键字取值为"?北京",检索关键字包含一个问号,此问号也必须进行编码。

附注:

javascript中一般采用encodeURIComponent函数对特殊字符进行编码。

Java中可以使用函数URLEncoder.encode对特殊字符进行编码。

C#中可以使用函数HttpUtility.UrlEncode对特殊字符进行编码。

php中可以使用函数urlencode对特殊字符进行编码。

sn计算算法

假设ak=yourak(yourak为一个字符串),

API控制台 中配置了该ak的验证方式是sn签名的验证方式,点击下面那排星号,显示Security Key,可以看到此ak对应的sk私钥,假设sk=yoursk。

请求的url是:

package test;
import java.io.UnsupportedEncodingException;
import java.net.URLEncoder;
import java.security.NoSuchAlgorithmException;
import java.util.LinkedHashMap;
import java.util.Map;
import java.util.Map.Entry;
//java版计算signature签名
public class SnCal {
public static void main(String[] args) throws UnsupportedEncodingException,
NoSuchAlgorithmException {
SnCal snCal = new SnCal();
// 计算sn跟参数对出现顺序有关,get请求请使用LinkedHashMap保存<key,value>,该方法根据key的插入顺序排序;post请使用TreeMap保存<key,value>,该方法会自动将key按照字母a-z顺序排序。所以get请求可自定义参数顺序(sn参数必须在最后)发送请求,但是post请求必须按照字母a-z顺序填充body(sn参数必须在最后)。以get请求为例:https://api.map.baidu.com/geocoder/v2/?address=百度大厦&output=json&ak=yourak,paramsMap中先放入address,再放output,然后放ak,放入顺序必须跟get请求中对应参数的出现顺序保持一致。
Map paramsMap = new LinkedHashMap<String, String>();
paramsMap.put("address", "百度大厦");
paramsMap.put("output", "json");
paramsMap.put("ak", "yourak");
// 调用下面的toQueryString方法,对LinkedHashMap内所有value作utf8编码,拼接返回结果address=%E7%99%BE%E5%BA%A6%E5%A4%A7%E5%8E%A6&output=json&ak=yourak
String paramsStr = snCal.toQueryString(paramsMap);
// 对paramsStr前面拼接上/geocoder/v2/?,后面直接拼接yoursk得到/geocoder/v2/?address=%E7%99%BE%E5%BA%A6%E5%A4%A7%E5%8E%A6&output=json&ak=yourakyoursk
String wholeStr = new String("/geocoder/v2/?" + paramsStr + "yoursk");
// 对上面wholeStr再作utf8编码
String tempStr = URLEncoder.encode(wholeStr, "UTF-8");
// 调用下面的MD5方法得到最后的sn签名7de5a22212ffaa9e326444c75a58f9a0
System.out.println(snCal.MD5(tempStr));
}
// 对Map内所有value作utf8编码,拼接返回结果
public String toQueryString(Map<?, ?> data)
throws UnsupportedEncodingException {
StringBuffer queryString = new StringBuffer();
for (Entry<?, ?> pair : data.entrySet()) {
queryString.append(pair.getKey() + "=");
queryString.append(URLEncoder.encode((String) pair.getValue(),
"UTF-8") + "&");
}
if (queryString.length() > 0) {
queryString.deleteCharAt(queryString.length() - 1);
}
return queryString.toString();
}
// 来自stackoverflow的MD5计算方法,调用了MessageDigest库函数,并把byte数组结果转换成16进制
public String MD5(String md5) {
try {
java.security.MessageDigest md = java.security.MessageDigest
.getInstance("MD5");
byte[] array = md.digest(md5.getBytes());
StringBuffer sb = new StringBuffer();
for (int i = 0; i < array.length; ++i) {
sb.append(Integer.toHexString((array[i] & 0xFF) | 0x100)
.substring(1, 3));
}
return sb.toString();
} catch (java.security.NoSuchAlgorithmException e) {
}
return null;
}
}

上一篇

坐标系说明

下一篇

鹰眼Android SDK

本篇文章对您是否有帮助?