浏览器版本低!无法浏览完整内容,建议升级或更换浏览器。

WEB 服务API

百度地图Web服务API为开发者提供http/https接口,即开发者通过http/https形式发起检索请求,获取返回json或xml格式的检索数据。用户可以基于此开发JavaScript、C#、C++、Java等语言的地图应用。

服务介绍
服务文档
使用指南
常见问题
更新日志
资源下载
国际化地点输入提示服务

国际化地点输入提示服务是一类Web API接口服务;
和国际化地点检索服务覆盖的国家地区范围一致。服务提供匹配用户输入内容,提供输入提示功能。常与国际化地点检索服务搭配使用。也可作为轻量级地点检索服务单独使用(不支持复杂检索场景)
服务权限需申请开通海外服务权限。

功能介绍
地点输入提示

用户可通过该服务,匹配用户输入关键词的地点推荐列表。用户在自己的产品中,通过点击等交互方式,结合国际化地点检索服务,实现地点详情检索功能。


轻量级地点检索

通过关键词和检索城市限制,可满足轻量级地点检索需求,获取地点基础数据


接口功能介绍
http://api.map.baidu.com/place_abroad/v1/suggestion?query=东京&region=东京&output=json&ak=你的ak //GET请求
请求参数
参数名称 是否必须 默认值 格式 备注
query 东京、Tokyo 需要检索联想的关键字
region 东京、首尔、曼谷 检索地区名称,当前建议传入城市名称
ret_coordtype gcj02ll 坐标详细说明
(仅港澳台有效)
可选参数,添加后POI返回国测局经纬度坐标
若不传该参数,返回结果默认bd09ll(百度经纬度),国外为wgs84
output xml json、xml 返回数据格式,可选json、xml两种
ak E4805d16520de693a3fe707cdc962045 开发者访问密钥,必选。
sn Sn校验说明 用户的权限签名
timestamp 设置sn后该值必选
返回结果参数
名称 类型 说明
status Int 本次API访问状态,如果成功返回0,如果失败返回其他数字。
message string 对API访问状态值的英文说明,如果成功返回"ok",并返回结果字段,如果失败返回错误说明。
name string poi名称
location object poi经纬度坐标
uid string poi的唯一标示,ID
city string 城市
district string 区县
tag string poi分类
address string poi地址
使用方法
坐标系说明
WGS84:为一种大地坐标系,也是目前广泛使用的GPS全球卫星定位系统使用的坐标系。
GCJ02:是由中国国家测绘局制订的地理信息系统的坐标系统。由WGS84坐标系经加密后的坐标系。
BD09:为百度坐标系,在GCJ02坐标系基础上再次加密。其中bd09ll表示百度经纬度坐标,bd09mc表示百度墨卡托米制坐标
国际化地点输入提示服务v1.0的输入参数支持以上三种坐标系,开发者无需进行任何坐标转换,通过请求参数"coord_type"指明所使用的坐标系即可。输出参数支持国测局坐标(gcj02)和 百度坐标(bd09ll)两种坐标,通过请求参数"ret_coordtype"进行设置。
服务开通方法

国际化地点输入提示服务为付费服务,需单独申请开通国际化服务。

1、通过控制台获取ak

2、提交工单申请国际化服务权限

images%2FMacHi%202018-04-13%2019-38-19.png


服务配额

国际化地点输入提示服务为付费服务,根据需求日配额及并发次数付费使用,具体价格和配额提升请通过合作咨询联系我们了解。

每个开发者账号每天调用“国际化地点输入提示服务”API 服务的总次数(即配额)是有限的。

每个开发者账号每天调用“国际化地点输入提示服务”API 服务的总次数(即并发量)是有限的。

同一个账号下的HTTP/HTTPS请求,配额,并发共享。

编码说明
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对特殊字符进行编码。
服务常见问题
1、为什么请求有时返回前几条数据只有name字段有值,其余字段为空?

本服务根据query内容进行检索提示时,除了召回检索频率较高的关联POI外,也同时召回检索频率较高的「热词」,这些热词并不是POI。
区分POI和热词,可通过uid等字段是否为空来判断(值为空时是热词)。
业务层如将检索结果展示给用户,可考虑在用户点击热词时,针对热词内容单独发起一次地点检索请求,同时也可在服务端通过uid字段是否为空,过滤掉热词不对用户展示。

2、检索结果字段太少,能获取详细POI信息吗?

地点输入提示非专业地点检索服务,推荐搜索关键词联想场景使用,或作为轻量级检索服务使用。
如有地点详情需求,可以结合地点检索服务使用:
首先通过“地点输入提示”服务,获取POI list。用户点击某POI,根据uid(百度POI ID),再请求“地点检索”服务,获取POI详情数据。

2018年3月24日

V1.0


产品发布
国际化地点输入提示服务上线

服务资源下载
百度地图POI行业分类(tag)

您可以通过此链接获知百度地图POI(兴趣点)的tag引导体系,辅助您检索POI。 如检索query为百度地图的tag“生活服务”,返回的检索结果即包含关键字为“生活服务”的POI、也包含tag为“生活服务”的POI,从而聚焦检索结果。