高德服务API接口说明新版.docx
- 文档编号:406338
- 上传时间:2022-10-09
- 格式:DOCX
- 页数:64
- 大小:559.01KB
高德服务API接口说明新版.docx
《高德服务API接口说明新版.docx》由会员分享,可在线阅读,更多相关《高德服务API接口说明新版.docx(64页珍藏版)》请在冰豆网上搜索。
61
0第二章.扩展服务
WebAPI标准服务接口
目录
第一章.标准服务 2
1.1搜索API 2
1.1.1.关键字搜索 2
1.1.2.POIid查询 4
1.1.3周边查询 5
1.1.4多边形查询 7
1.1.5行政区划查询 10
1.1.6公交线路查询 12
1.1.7公交站点查询 18
1.2地理/逆地理编码API 22
1.2.1地理编码 22
1.2.2逆地理编码 24
1.2.3简化版逆地理编码 31
1.3路径规划API 32
1.3.1公交路径规划 32
1.3.2驾车路径规划 38
1.3.3步行路径规划 43
1.3.4行驶距离测量 47
1.4输入提示API 48
1.5栅格取图API 52
1.6静态地图API 53
第二章.扩展服务 56
2.1坐标转换API 56
2.2轨迹纠偏API 57
2.3到达圈查询 59
第三章.服务框架管理 61
3.1webAPI入口服务 61
第四章.错误码 62
第一章.标准服务
1.1搜索API
1.1.1.关键字搜索
兴趣点(POI,PointofInterest)指的是用户兴趣点,每个兴趣点一般应包含名称、类别、经度、纬度等信息,常见的兴趣点如学校、银行、餐厅等。
通过关键字可进行检索各种类别的兴趣点。
■接口功能介绍
兴趣点中带有关键字的数据。
■HTTP请求方式
get
■编码格式
UTF-8
■接口参数说明
用户向服务器发起http请求的接口参数说明见下表。
参数名称
参数含义
备注
是否必填
缺省值
q(query)
关键字
关键字的首字母、拼音格式如,公园/gy/gongyuan
必填
无
scope
检索结果详细程度
取值含义如下:
1返回基本信息;
2返回POI详细信息。
必填
1
type
关键字类型
多个类型之间用”|”分隔。
格式如医院|学校|酒店……
可选
无
page_size
每页记录数
最大值为50,超过50则按照50处理。
可选
10
page_num
分页页码
1为第一页。
可选
1
region
检索区域名称
可输入城市名或省份名或全国
必填
无
ak
用户申请注册的key
用户申请注册的key
必填
无
output
输出格式
可选值json、xml
可选
json
■返回结果参数如下:
属性名称
类型
含义
规则说明
status
String
是否返回成功。
0成功,其他为失败。
message
String
--状态说明。
--
total
Number
--检索记录总数
--
results
Array
--返回结果
--为空,查询无结果
uid
String
--poi唯一标识
--
name
String
--poi名称
--
location
Object。
--坐标
--
lng
Double
--经度
--
lat
Double
--纬度
--
address
String
--POI地址
--
telephone
String
--电话
--
detail_info
Object
--详细信息
--
distance
String。
--与中心点的距离
--单位米
type
String
--POI类型
--
■URL示例
http:
// port>/as/search/poi? query=如家酒店®ion=北京&ak=<用户Key> ■返回结果 { "total": "10265", "message": "ok", "results": [ { "uid": "B0FFG5B3LY", "address": "望京西园1区119号楼北侧", "name": "如家酒店(望京科技园店)", "location": { "lng": "116.474127", "lat": "40.004957" }, "telephone": "010-64730399" }, { "uid": "B0FFG3629I", "address": "荣华南路16号中冀斯巴鲁宾馆", "name": "如家酒店(中冀斯巴鲁店)", "location": { "lng": "116.517391", "lat": "39.784798" }, "telephone": "010-59767666" }, { "uid": "B0FFGVZANM", "address": "泥洼路北口东100米", "name": "如家酒店停车场", "location": { "lng": "116.300461", "lat": "39.866164" }, "telephone": "" }, { "uid": "B000A8TZ35", "address": "魏公村路甲1号3层", "name": "温馨如家酒店(魏公村路)", "location": { "lng": "116.321533", "lat": "39.956750" }, "telephone": "010-68418341" }, { "uid": "B0FFFN8MUJ", "address": "东三环南路48-2附近", "name": "如家酒店(双井店)停车场", "location": { "lng": "116.461907", "lat": "39.890340" }, "telephone": "" } ], "status": "0" } 1.1.2.POIid查询 ■接口功能 通过POIID,查询POI的详情信息。 ■http请求方式 post、get ■编码格式 UTF-8 ■接口参数说明 参数 说明 备注 是否必填 缺省值 ids 兴趣点的唯一标识ID 支持批量查询,多个id之间以分隔 必填 无 ak 用户申请的key。 必填参数 必填 无 callback 回调函数 用户定义的函数名称,仅当输出josn格式的返回结果时该参数有效。 可选 无 output 输出格式 可选值json、xml。 默认为json。 可选 json ■返回结果参数 名称 类型 说明 规则说明 status String 状态 --0为成功,其他为失败。 message String 状态说明。 total number 检索到的类型记录总数。 results Array 关键字检索结果。 --为空,查询无结果 uid String POI的唯一标示id。 name String POI名称。 location object POI的经纬度坐标。 lng double 经度。 lat double 纬度。 address double POI的地址信息。 telephone double 电话。 type double POI类型。 ■URL示例 http: // port>/as/search/poiid? ids=B0FFH04FAB&ak=用户key ■返回结果 { "total": "1", "message": "ok", "results": [ { "uid": "B0FFH04FAB", "address": "望京街9号", "name": "望京国际商业中心F座", "location": { "lng": "116.482979", "lat": "39.989294" }, "telephone": "", "type": "商务住宅;楼宇;商务写字楼" } ], "status": "0" } 1.1.3周边查询 ■接口功能介绍 根据中心点坐标(x,y),查询周边兴趣点 ■HTTP请求方式 get ■编码格式 UTF-8 ■接口参数说明 用户向服务器发起http请求的接口参数说明见下表Error! Referencesourcenotfound.。 参数名称 参数含义 备注 是否必填 缺省值 q(query) 关键字 关键字、关键字的首字母、拼音。 格式如,公园/gy/gongyuan; 必填 无 scope 检索结果详细程度 取值含义如下: 1返回基本信息; 2返回POI详细信息; 必填 1 page_size 每页记录数 最大值为50,超过50则按照50处理。 可选 10 page_num 分页页码 分页页码,1为第一页。 可选 1 location 中心点坐标 格式如: 纬度,经度。 必填 无 radius(r) 搜索半径 取值范围0~50000,超过50000时,按默认值1000进行搜搜,单位米。 可选 1000 callback 回调函数 用户定义的函数名称,仅当输出josn格式的返回结果时该参数有效。 可选 无 ak 用户申请注册的key。 必填参数 必填 无 ■返回结果参数如下: 名称 类型 含义 规则说明 status String 是否返回成功。 0为成功,其他为失败。 message String 状态说明。 -- total number 检索记录总数。 -- results Ar
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 服务 API 接口 说明 新版