接口文档

通信协议

目前支持HTTP、HTTPS 两种通讯方式

请求方法

请求接口:

GET http://lbs.baidubce.com

公共请求头

头域 类型 说明
x-bce-request-id uuid 请求id 36位uuid(非必须)
x-bce-date String UTC时间格式%YYYY-%mm-%ddT%HH:%MM:%SSZ
x-app-id uuid 应用ID 在console上可见
Host String Http HEADER必须项
Authorization String 百度智能云统一认证字符串详情

说明:字符集 charset=utf-8

接口定义

坐标转换

请求示例

HTTP_METHOD URI 说明
GET /geoconv/v1/ 调用请求

请求例子:

curl -H "x-bce-user-id: 9e8ef339f58f4d70b442bc55a7c13a3f" -H "x-app-id: XX....XX" -H "x-bce-date:2018-02-22T09:47:52Z" -H "Authorization:bce-auth-v1/XXXXXX.." http://lbs.baidubce.com/geoconv/v1/?coords=114.21892734521,29.575429778924&from=1&to=5

请求参数

参数名称 含义 类型 举例 默认值 是否必须
coords 需转换的源坐标,多组坐标以“;”分隔
(经度,纬度)
float 114.21892734521,29.575429778924
from 源坐标类型:
1:GPS设备获取的角度坐标,WGS84坐标;
2:GPS获取的米制坐标、sogou地图所用坐标;
3:google地图、soso地图、aliyun地图、mapabc地图和amap地图所用坐标,国测局(GCJ02)坐标;
4:3中列表地图坐标对应的米制坐标;
5:百度地图采用的经纬度坐标;
6:百度地图采用的米制坐标;
7:mapbar地图坐标;
8:51地图坐标
int 1 1
to 目标坐标类型:
5:bd09ll(百度经纬度坐标);
6:bd09mc(百度米制经纬度坐标)
int 5 5
output 返回结果格式 string json json

返回结果

返回结果参数:

名称 类型 说明
status Int 本次API访问状态,如果成功返回0,如果失败返回其他数字
result json或者xml数组 转换结果
+x float 经度
+y float 纬度

状态码说明:

返回码 英文描述 定义 常见原因
0 ok 正常 服务请求正常召回
1 内部错误
4 转换失败 X→GPS时必现,根据法律规定,不支持将任何类型的坐标转换为GPS坐标
21 from非法
22 to非法
24 coords格式非法
25 coords个数非法,超过限制
26 参数错误