高德服务API接口说明-新版20170325 - 图文

1

WebAPI标准服务接口

目录

第一章.标准服务 .......................................................................................................................................................... 2

1.1搜索API ......................................................................................................................................................... 2

1.1.1.关键字搜索 ........................................................................................................................................ 2 1.1.2.POI id查询 ........................................................................................................................................ 4 1.1.3周边查询 ............................................................................................................................................ 5 1.1.4多边形查询 ........................................................................................................................................ 7 1.1.5行政区划查询 ..................................................................................................................................11 1.1.6公交线路查询 ..................................................................................................................................13 1.1.7公交站点查询 ..................................................................................................................................19 1.2地理/逆地理编码API ................................................................................................................................23

1.2.1地理编码 ..........................................................................................................................................23 1.2.2逆地理编码 ......................................................................................................................................25 1.2.3简化版逆地理编码 ..........................................................................................................................32 1.3路径规划API...............................................................................................................................................33

1.3.1公交路径规划 ..................................................................................................................................33 1.3.2驾车路径规划 ..................................................................................................................................39 1.3.3步行路径规划 ..................................................................................................................................44 1.3.4行驶距离测量 ..................................................................................................................................48 1.4输入提示API...............................................................................................................................................49 1.5栅格取图API...............................................................................................................................................53 1.6静态地图API...............................................................................................................................................54 第二章.扩展服务 ........................................................................................................................................................57

2.1坐标转换API...............................................................................................................................................57 2.2轨迹纠偏API...............................................................................................................................................58 2.3到达圈查询 ..................................................................................................................................................60 第三章.服务框架管理 ................................................................................................................................................62

3.1webAPI入口服务 .......................................................................................................................................62 第四章.错误码 ............................................................................................................................................................63

错误！文档中没有指定样式的文字。

2

第一章.标准服务

1.1搜索API

1.1.1.关键字搜索

兴趣点(POI，Point of Interest)指的是用户兴趣点，每个兴趣点一般应包含名称、类别、经度、纬度等信息，常见的兴趣点如学校、银行、餐厅等。 通过关键字可进行检索各种类别的兴趣点。 ■接口功能介绍

兴趣点中带有关键字的数据。 ■HTTP请求方式 get ■编码格式 UTF-8

■接口参数说明

用户向服务器发起http请求的接口参数说明见下表。

参数名称 q(query) scope type page_size page_num region ak output ■返回结果参数如下：

属性名称 status message total results

参数含义 备注 是否必填 必填 缺省值 无 关键字 检索结果详细程度 关键字类型 每页记录数 分页页码 检索区域名称 用户申请注册的key 输出格式 关键字的首字母、拼音格式如，公园/gy/gongyuan 取值含义如下： 1返回基本信息； 2返回POI详细信息。 多个类型之间用”|”分隔。格式如医院|学校|酒店…… 1为第一页。 可输入城市名或省份名或全国 用户申请注册的key 可选值json、xml 必填 1 可选 无 10 1 无 无 json 最大值为50，超过50则按照50处理。 可选 可选 必填 必填 可选 类型 String String Number Array 含义 是否返回成功。 --状态说明。 --检索记录总数 --返回结果 --poi唯一标识 规则说明 0成功，其他为失败。 -- -- --为空，查询无结果 -- uid String

3

0第一章.标准服务

属性名称 name location address telephone detail_info ■URL示例

distance type lng lat 类型 String Object。 Double Double String String Object String。 String 含义 --poi名称 --坐标 --经度 --纬度 --POI地址 --电话 --详细信息 --与中心点的距离 --POI类型 规则说明 -- -- -- -- -- -- -- --单位米 -- http:///as/search/poi?query=如家酒店®ion=北京&ak=<用户Key>

■返回结果

{

\ \ \

{

\

\望京西园1区119号楼北侧\ \如家酒店(望京科技园店)\ \

\ \ },

\ }, {

\

\荣华南路16号中冀斯巴鲁宾馆\ \如家酒店(中冀斯巴鲁店)\ \

\ \ },

\ },

{

\

\泥洼路北口东100米\ \如家酒店停车场\ \

3

错误！文档中没有指定样式的文字。

4

\ \ },

\ },

{

\

\魏公村路甲1号3层\ \温馨如家酒店(魏公村路)\ \

\ \ },

\ }, {

\

\东三环南路48-2附近\ \如家酒店(双井店)停车场\ \

\ \ },

\ } ],

\}

1.1.2.POI id查询

■接口功能

通过POI ID，查询POI的详情信息。 ■http请求方式 post、get ■编码格式 UTF-8

■接口参数说明

参数 说明 ids ak callback 备注 支持批量查询，多个id之间以分隔 必填参数 用户定义的函数名称，仅当输出josn格式的返回结果时该参数有效。 是否必填 必填 必填 可选 缺省值 无 无 无 兴趣点的唯一标识ID 用户申请的key。 回调函数

5

0第一章.标准服务

参数 output 说明 输出格式 备注 可选值json、xml。默认为json。 是否必填 可选 缺省值 json ■返回结果参数

名称 status message total results uid name location lng lat address telephone ■URL示例 ■返回结果

type 类型 String String number Array String String object double double double double double 说明 状态 状态说明。 检索到的类型记录总数。 关键字检索结果。 POI的唯一标示id。 POI名称。 POI的经纬度坐标。 经度。 纬度。 POI的地址信息。 电话。 POI类型。 规则说明 --0为成功，其他为失败。 --为空，查询无结果 http:///as/search/poiid?ids= B0FFH04FAB&ak=用户key

{

\ \ \ {

\

\望京街9号\

\望京国际商业中心F座\ \

\ \ },

\

\商务住宅;楼宇;商务写字楼\ } ],

\}

1.1.3周边查询

■接口功能介绍

根据中心点坐标（x，y），查询周边兴趣点

5