浏览器版本低!无法浏览完整内容,建议升级或更换浏览器。
服务介绍
服务文档
使用指南
常见问题
更新日志
资源下载
境外地点输入提示服务

境外地点输入提示服务是一类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 E4805d165************7cdc962045 开发者访问密钥,必选。
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、提交工单申请服务权限


服务配额

服务相关配额及并发请求限制请访问开发者权益页面查看。

编码说明
API请求中需要用到中文或一些特殊字符的参数,如query、region等,为了避免提交到后台乱码,需要对这几个参数值进行编码处理,转换成UTF-8字符的二字符十六进制值,凡是不在下表中的字符都需要进行编码。
字符集合 字符
URL非保留