百度地图 API
  1. 附录
百度地图 API
  • 获取密钥
    • 获取秘钥
  • 地点检索
    • 地点检索V2.0
      • 服务介绍
      • 服务文档
      • 使用指南
      • 常用问题
      • 更新日志
      • 资源下载
      • 行政区划区域检索
      • 圆形区域检索
      • 地点详情检索
  • 地点输入提示
    • 地点输入提示V2.0
      • 服务介绍
      • 使用指南
      • 常见问题
      • 更新日志
      • 资源下载
      • 地点输入提示接口
  • 正/逆地理编码
    • 地理编码
      • 服务介绍
      • 使用指南
      • 常用问题
      • 更新日志
      • 资源下载
      • 地理编码
    • 全球逆地理编码
      • 服务介绍
      • 使用指南
      • 常见问题
      • 更新日志
      • 资源下载
      • 逆地理编码
  • 轻量级轨迹服务
    • 轨迹纠偏API
      • 服务介绍
      • 使用指南
      • 更新日志
      • 轨迹纠偏
    • 轨迹重合率分析API
      • 服务介绍
      • 使用指南
      • 更新日志
      • 轨迹重合率分析API
    • 轨迹分析API
      • 服务介绍
      • 使用指南
      • 更新日志
      • 轻量轨迹分析API
  • 道路信息预警服务
    • 超速判断API
      • 服务介绍
      • 使用指南
      • 更新日志
      • 超速判断API
  • 路线规划
    • 轻量级路线规划
      • 服务介绍
      • 使用指南
      • 常见问题
      • 更新日志
      • 服务文档
      • 驾车路线规划
      • 骑行路线规划
      • 步行路线规划
      • 公交路线规划
    • 路线规划
      • 服务介绍
      • 使用指南
      • 常见问题
      • 更新日志
      • 服务文档
      • 摩托车路线规划
      • 公交路线规划
      • 骑行路线规划
      • 驾车路线规划
    • 货车路线规划
      • 服务介绍
      • 使用指南
      • 常用问题
      • 更新日志
      • 服务文档
      • 货车路线规划
  • 智能调度
    • 路网矩阵API
      • 服务介绍
      • 服务文档
      • 使用指南
      • 常用问题
      • 更新日志
      • 路网创建接口
      • 路网查询接口
      • 路网新增/减少网点/更新网点坐标
      • 网点线路更新
      • 路网删除
      • 路网任务执行时间查询接口
      • 路网任务权重修改接口
    • 排单排线API
      • 服务介绍
      • 服务文档
      • 使用指南
      • 常用问题
      • 更新日志
      • 排单排线计算
      • 排单排线查询
      • 线内优化排单计算
      • 线内优化结果查询
      • 多点有序排单计算
      • 多点有序排单查询
    • 快速排单API
      • 服务介绍
      • 服务文档
      • 使用指南
      • 常见问题
      • 更新日志
      • 快速排单计算
      • 快速排单查询
    • 多仓排单API
      • 服务介绍
      • 服务文档
      • 使用指南
      • 常见问题
      • 更新日志
      • 多仓排单排线计算
      • 多仓排单排线查询
  • 私有化图层
    • 私有化地址库
      • 服务介绍
      • 服务文档
      • 使用指南
      • 常见问题
      • 更新日志
    • 私有化路线库
      • 服务介绍
      • 服务文档
      • 使用指南
      • 常用问题
      • 更新日志
  • 天气查询
    • 国内天气查询
      • 服务介绍
      • 服务文档
      • 使用指南
      • 常见问题
      • 更新日志
      • 资源下载
      • 基础服务
      • 高级权限(国内经纬度天气查询)
    • 海外天气查询
      • 服务介绍
      • 服务文档
      • 使用指南
      • 常见问题
      • 更新日志
      • 资源下载
      • 基础服务
      • 高级权限(海外经纬度天气查询)
  • 批量算路
    • 服务介绍
    • 服务文档
    • 使用指南
    • 常见问题
    • 更新日志
    • 服务地址批量算路
  • 货车批量算路
    • 服务介绍
    • 服务文档
    • 使用指南
    • 常见问题
    • 更新日志
    • 货车路线规划
  • 地址解析聚合
    • 服务介绍
    • 服务文档
    • 使用指南
    • 常见问题
    • 更新日志
    • 地址解析聚合
  • 城乡类型判别
    • 服务介绍
    • 服务文档
    • 使用指南
    • 常见问题
    • 更新日志
    • 城乡类别判别
  • 行政区划查询服务
    • 服务介绍
    • 使用指南
    • 常见问题
    • 更新日志
    • 服务文档
    • 行政区划查询服务
  • 区域边界查询服务
    • 服务介绍
  • 普通IP定位
    • 服务介绍
    • 使用指南
    • 常见问题
    • 更新日志
    • 服务文档
    • 普通IP定位
  • 智能硬件定位
    • 服务介绍
    • 使用指南
    • 常见问题
    • 更新日志
    • 服务文档
    • 智能硬件定位
  • 鹰眼轨迹
    • 概述
    • 常见问题
    • 更新日志
    • 相关下载
    • 获取密钥
      • 获取密钥
    • 开发指南
      • 账号和获取密钥
      • 鹰眼基本概念
      • 权限和配额
      • Hello鹰眼
      • 连接设备
      • 轨迹追踪
      • 轨迹存储
      • 轨迹查询
      • 轨迹纠偏
      • 空间搜索
      • 地理围栏
      • 轨迹分析
      • 经验行为分析
      • 交通方式识别
      • 图像存储
      • 全球轨迹服务
      • 轨迹管理台使用手册
      • 轨迹管理台开源代码
    • 行业解决方案
      • 物流车队管理方案
    • 鹰眼Web服务API
      • 接口总览
      • 附录
      • 终端管理
        • 终端管理
        • 添加entity
        • 更新entity
        • 删除entity
        • 查询entity
      • 空间搜索
        • 空间搜索
        • 关键字搜索
        • 矩形范围搜索
        • 周边搜索
        • 多边形搜索
        • 行政区搜索
      • 轨迹上传
        • 轨迹上传
        • 上传单个轨迹点
        • 批量添加轨迹点
      • 轨迹查询和纠偏
        • 轨迹查询和纠偏
        • 实时纠偏
        • 查询轨迹里程
        • 轨迹查询与纠偏
      • 轨迹分析
        • 轨迹分析
        • 停留点查询
        • 驾驶行为分析
      • 经验行为分析
        • 经验行为分析
        • createjob接口创建任务
        • getjob接口定期查询任务
      • ETC费用
        • ETC费用
        • 货车ETC费用
        • 乘用车ETC费用
      • 地理围栏管理
        • 地理围栏管理
        • 创建圆形围栏
        • 更新圆形围栏
        • 创建多边形围栏
        • 更新多边形围栏
        • 创建线型围栏
        • 更新线型围栏
        • 创建行政区划围栏
        • 更新行政区划围栏
        • 删除围栏
        • 删除围栏可去除监控的entity
        • 增加围栏需监控的entity
        • 查询围栏
        • 查询围栏监控的所有entity
      • 地理围栏报警
        • 地理围栏报警
        • 查询监控对象相对围栏的状态
        • 根据坐标查询监控对象相对围栏的状态
        • 查询某监控对象的围栏报警信息
        • 批量查询所有围栏报警信息
      • 批量导出轨迹
        • 批量导出轨迹
        • 创建任务
        • 删除任务
        • 查询任务
      • 历史轨迹搜索
        • 历史轨迹搜索
        • 创建检索任务
        • 查询搜索
        • 删除搜索任务
      • 自定义属性字段
        • 自定义属性字段
      • 坐标系说明
        • 坐标系说明
    • 鹰眼Android SDK
      • 概述
      • 获取密钥
      • 更新日志
      • 相关下载
      • Web轨迹管理台
      • 开发指南
        • 快速入门
          • 简介
          • 账号和获取密钥
          • 创建鹰眼服务
          • 鹰眼基本概念
          • 权限和配额
          • 配置工程
          • 隐私合规接口
          • Hello Trace
        • 功能说明
          • 轨迹追踪
          • 缓存轨迹处理
          • 空间搜索
          • 轨迹查询
          • 轨迹纠偏
          • 里程计算
          • 轨迹分析
          • 地理围栏
          • 图像存储
        • 其他说明
          • 服务的存活
          • 电量和流量
          • 运营商网络
          • 坐标系说明
    • 鹰眼iOS SDK
      • 概述
      • 获取密钥
      • 更新日志
      • 相关下载
      • Web轨迹管理台
      • 开发指南
        • 快速入门
          • 简介
          • 账号和获取密钥
          • 创建鹰眼服务
          • 鹰眼基本概念
          • 权限和配额
          • 配置工程
          • CocoaPods自动配置
          • 隐私合规接口说明
        • 功能说明
          • 轨迹追踪
          • 缓存轨迹处理
          • 空间搜索
          • 轨迹查询与纠偏
          • 里程计算
          • 地理围栏
          • 轨迹分析
        • 其他说明
          • 运营商网络
          • 坐标系说明
    • 鹰眼硬件设备
      • 鹰眼硬件产品概览
      • 博实结BSJ-M11
      • 成为CW-601E
      • 北斗易通E-198A
    • Web轨迹管理台
      • Web轨迹管理台
  • 实时路况查询
    • 服务介绍
    • 服务文档
    • 使用指南
    • 更新日志
    • 道路路况查询
    • 矩形区域路况查询
    • 多边形区域路况查询
    • 周边路况查询
  • 时区
    • 服务介绍
    • 服务文档
    • 使用指南
    • 常用问题
    • 更新日志
    • 时区
  • 批量服务
    • 服务介绍
    • 服务文档
    • 使用指南
    • 常见问题
    • 更新日志
    • 批量服务
  • 推荐上车点
    • 服务介绍
    • 服务文档
    • 使用指南
    • 常见问题
    • 更新日志
    • 推荐上车点
  • 坐标转换
    • 服务介绍
    • 服务文档
    • 使用指南
    • 常见问题
    • 更新日志
    • 坐标转换
  • 地图调起
    • 服务介绍
    • 常见问题
    • 更新日志
    • 相关下载
    • 开发指南
      • 简介
      • Hello World
    • 接口说明
      • web端
      • android端
      • iOS端
      • 地图标点功能
      • 地址解析
      • 反向地址解析
      • POI地点检索
      • 公交、地铁线路查询
      • 公交、驾车、步行路线规划
      • POI详情页展示
      • 全景服务
      • 展示地图
      • 自定义打点
      • 展现地图图区
      • 地址解析
      • 附近搜索
      • 驾车导航
      • 骑行导航
      • 步行导航
      • 导航到家
      • 调起离线导航包下载页面
      • 路线(出行)页面调起协议
      • 跳转出行早晚报页面
      • 跳转行程助手主页或者编辑页
      • 实时公交页面
      • 离线地图下载页面
      • 实时汇率页面
      • 实时翻译页面
      • 电子狗功能
      • 路况页面协议
      • AR识楼
      • 地铁图
      • IOS地图标注
      • iOS显示主图区
      • ios地址解析
      • ios反向地址解析
      • ios-POI(地点)搜索
      • ios用户位置附近检索
      • ios路线规划
      • ios公交、地铁线路查询
      • ios驾车导航
      • ios骑行导航
      • ios步行导航
      • ios-POI详情页展示
  • 静态图
    • 服务介绍
    • 服务文档
    • 可视化工具
    • 使用指南
  • 全景静态图
    • 功能介绍
    • 服务文档
    • 使用指南
  • 附录
    • 状态码定义
  • 概述
    • 概述
  1. 附录

状态码定义

状态码定义
状态码定义注释
0正常
1服务器内部错误该服务响应超时或系统内部错误,请留下联系方式
10上传内容超过8MPost上传数据不能超过8M
101AK参数不存在请求消息没有携带AK参数
102MCODE参数不存在,mobile类型mcode参数必需对于Mobile类型的应用请求需要携带mcode参数,该错误码代表服务器没有解析到mcode
200APP不存在,AK有误请检查再重试根据请求的ak,找不到对应的APP
201APP被用户自己禁用,请在控制台解禁
202APP被管理员删除恶意APP被管理员删除
203APP类型错误当前API控制台支持Server(类型1), Mobile(类型2, 新版控制台区分为Mobile_Android(类型21)及Mobile_IPhone(类型22))及Browser(类型3),除此之外其他类型认为是APP类型错误
210APP IP校验失败在申请SERVER类型应用的时候选择IP校验,需要填写IP白名单,如果当前请求的IP地址不在IP白名单或者不是0.0.0.0/0就认为IP校验失败
211APP SN校验失败SERVER类型APP有两种校验方式IP校验和SN校验,当用户请求的SN和服务端计算出来的SN不相等的时候提示SN校验失败
220APP Referer校验失败浏览器类型的APP会校验referer字段是否存且切在referer白名单里面,否则返回该错误码
230APP Mcode码校验失败服务器能解析到mcode,但和数据库中不一致,请携带正确的mcode
240APP 服务被禁用用户在API控制台中创建或设置某APP的时候禁用了某项服务,若需开通权限,可进入API控制台为AK勾选对应服务
250用户不存在根据请求的user_id, 数据库中找不到该用户的信息,请携带正确的user_id
251用户被自己删除该用户处于未激活状态
252用户被管理员删除恶意用户被加入黑名单
260服务不存在服务器解析不到用户请求的服务名称
261服务被禁用该服务已下线
301永久配额超限,限制访问配额超限,如果想增加配额请联系我们
302天配额超限,限制访问配额超限,如果想增加配额请联系我们
401当前并发量已经超过约定并发配额,限制访问并发控制超限,请控制并发量或联系我们
402当前并发量已经超过约定并发配额,并且服务总并发量也已经超过设定的总并发配额,限制访问并发控制超限,请控制并发量或联系我们
编码说明
API请求中需要用到中文或一些特殊字符的参数,为了避免提交到后台乱码,需要对这几个参数值进行编码处理,转换成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保留字字符的字面意思,例如,检索关键字包含一个问号,此问号也必须进行编码。附注:
javascript中一般采用encodeURIComponent函数对特殊字符进行编码。
Java中可以使用函数URLEncoder.encode对特殊字符进行编码。
C#中可以使用函数HttpUtility.UrlEncode对特殊字符进行编码。
php中可以使用函数urlencode对特殊字符进行编码。
sn计算算法
假设ak=yourak(yourak为一个字符串),
在 API控制台 中配置了该ak的验证方式是sn签名的验证方式,点击下面那排星号,显示Security Key,可以看到此ak对应的sk私钥,假设sk=yoursk。
请求的url是:
https://api.map.baidu.com/geocoder/v2/?address=百度大厦&output=json&ak=yourak&sn=7de5a22212ffaa9e326444c75a58f9a0
//后面的sn就是要计算的,sk不需要在url里出现,但是在计算sn的时候需要sk(假设sk=yoursk) 下面提供java、PHP、C#、python 2.7的参考代码。
//假如添加参数需要传经纬度坐标是逗号需要urlencode,示例39.951948,116.351255需要转化为39.951948%2C116.351255
java参考代码如下:
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;
        }
}
PHP参考代码如下:
<?php

//API控制台申请得到的ak(此处ak值仅供验证参考使用)
$ak = 'yourak';

//应用类型为for server, 请求校验方式为sn校验方式时,系统会自动生成sk,可以在应用配置-设置中选择Security Key显示进行查看(此处sk值仅供验证参考使用)
$sk = 'yoursk';

//以Geocoding服务为例,地理编码的请求url,参数待填
$url = "https://api.map.baidu.com/geocoder/v2/?address=%s&output=%s&ak=%s&sn=%s";

//get请求uri前缀
$uri = '/geocoder/v2/';

//地理编码的请求中address参数
$address = '百度大厦';

//地理编码的请求output参数
$output = 'json';

//构造请求串数组
$querystring_arrays = array (
	'address' => $address,
	'output' => $output,
	'ak' => $ak
);

//调用sn计算函数,默认get请求
$sn = caculateAKSN($ak, $sk, $uri, $querystring_arrays);

//请求参数中有中文、特殊字符等需要进行urlencode,确保请求串与sn对应
$target = sprintf($url, urlencode($address), $output, $ak, $sn);

//输出计算得到的sn
echo "sn: $sn \n";

//输出完整请求的url(仅供参考验证,故不能正常访问服务)
echo "url: $target \n";
?>
其中,caculateAKSN的定义如下:
function caculateAKSN($ak, $sk, $url, $querystring_arrays, $method = 'GET')
{  
    if ($method === 'POST'){  
        ksort($querystring_arrays);  
    }  
    $querystring = http_build_query($querystring_arrays);  
    return md5(urlencode($url.'?'.$querystring.$sk));  
}
C#参考代码如下:
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;

 
    public class AKSNCaculater
    {
       private static string MD5(string password)
       {
           byte[] textBytes = System.Text.Encoding.UTF8.GetBytes(password);
           try
           {
               System.Security.Cryptography.MD5CryptoServiceProvider cryptHandler;
               cryptHandler = new System.Security.Cryptography.MD5CryptoServiceProvider();
               byte[] hash = cryptHandler.ComputeHash(textBytes);
               string ret = "";
               foreach (byte a in hash)
               {
                   ret += a.ToString("x2");
               }
               return ret;
           }
           catch
           {
               throw;
           }
       }

       private static string UrlEncode(string str)
       {
           str = System.Web.HttpUtility.UrlEncode(str);
           byte[] buf = Encoding.ASCII.GetBytes(str);//等同于Encoding.ASCII.GetBytes(str)
           for (int i = 0; i < buf.Length; i++)
               if (buf[i] == '%')
               {
                   if (buf[i + 1] >= 'a') buf[i + 1] -= 32;
                   if (buf[i + 2] >= 'a') buf[i + 2] -= 32;
                   i += 2;
               }
           return Encoding.ASCII.GetString(buf);//同上,等同于Encoding.ASCII.GetString(buf)
       }

       private static string HttpBuildQuery(IDictionary<string, string> querystring_arrays)
       {

           StringBuilder sb = new StringBuilder();
           foreach (var item in querystring_arrays)
           {
               sb.Append(UrlEncode(item.Key));
               sb.Append("=");
               sb.Append(UrlEncode(item.Value));
               sb.Append("&");
           }
           sb.Remove(sb.Length - 1, 1);
           return sb.ToString();
       }

       public static string CaculateAKSN(string ak, string sk, string url, IDictionary<string, string> querystring_arrays)
       { 
           var queryString = HttpBuildQuery(querystring_arrays);

           var str = UrlEncode(url + "?" + queryString + sk); 

           return MD5(str);
       }
    } 
python 2.7参考代码如下:
# -*- coding: utf-8 -*- 
# 第一行必须有,否则报中文字符非ascii码错误
import urllib
import hashlib

# 以get请求为例https://api.map.baidu.com/geocoder/v2/?address=百度大厦&output=json&ak=yourak
queryStr = '/geocoder/v2/?address=百度大厦&output=json&ak=yourak'

# 对queryStr进行转码,safe内的保留字符不转换
encodedStr = urllib.quote(queryStr, safe="/:=&?#+!$,;'@()*[]")

# 在最后直接追加上yoursk
rawStr = encodedStr + 'yoursk'

# md5计算出的sn值7de5a22212ffaa9e326444c75a58f9a0
# 最终合法请求url是https://api.map.baidu.com/geocoder/v2/?address=百度大厦&output=json&ak=yourak&sn=7de5a22212ffaa9e326444c75a58f9a0
print hashlib.md5(urllib.quote_plus(rawStr)).hexdigest()
上一页
使用指南
下一页
概述
Built with