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

WEB 服务API

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

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

国际化地点检索服务(又名Place API)是一类Web API接口服务;
服务提供多种场景的地点(POI)检索功能,包括城市检索、周边检索、矩形区域检索。开发者可通过接口获取地点(POI)基础或详细地理信息。
服务数据覆盖港、澳、台,以及海外合计209个国家和地区(注:地点检索v2.0服务同样支持港、澳数据检索,但数据质量不高,建议使用国际化地点检索服务)。
服务权限需申请开通海外服务权限。

功能介绍
行政区划区域检索

开发者可通过该功能,检索某一行政区划内(国际化检索当前支持国家、城市两个级别)的地点信息。


圆形区域检索

开发者可设置圆心和半径,检索圆形区域内的地点信息(常用于周边检索场景)。


矩形区域检索

开发者可设置检索区域左下角和右上角坐标,检索坐标对应矩形内的地点信息(常用于手机或PC端地图视野内检索)


地点详情检索

不同于以上三种检索功能。地点详情检索针对指定POI,检索其相关的详情信息。开发者可以通过三种区域检索(或其他服务)功能,获取POI id。使用“地点详情检索”功能,传入id,即可检索POI详情信息,如评分、营业时间等(不同类型POI对应不同类别详情数据)。


接口功能介绍
行政区划区域检索
http://api.map.baidu.com/place_abroad/v1/search?query=东京塔&page_size=10&page_num=0&scope=1&region=东京&output=json&ak=您的ak //GET请求
请求参数
参数名 参数含义 类型 示例 是否必须
query 检索关键字,周边检索和矩形区域内检索支持多个关键字并集检索,不同关键字间以$符号分隔,最多支持10个关键字检索。如:”银行$酒店”。
检索词支持中英文。
string(45) 东京塔 必选
tag 检索分类,与query组合进行检索,多个分类以","分隔
POI分类
string(50) 美食 可选
region 检索行政区划区域,当前仅支持文本检索 string(50) 东京 必选
output 输出格式为json或者xml string(50) json或xml 可选
scope 检索结果详细程度。取值为1 或空,则返回基本信息;取值为2,返回检索POI详细信息 string(50) 1、2 可选
ret_coordtype 可选参数,添加后POI返回国测局经纬度坐标(港澳台有效)
坐标详细说明
string(50) gcj02ll 可选
page_size 单次召回POI数量,默认为10条记录,最大返回20条。多关键字检索时,返回的记录数为关键字个数*page_size。 int 10 可选
page_num 分页页码,默认为0,0代表第一页,1代表第二页,以此类推。

常与page_size搭配使用。

int 0、1、2 可选
ak 开发者的访问密钥,必填项

申请密钥

string(50) 必选
sn 开发者的权限签名。

Sn校验说明

string(50) 可选,若开发者所用AK的校验方式为SN校验时该参数必须。
timestamp 设置sn后该值必填。 string(50) 设置sn后该值必填。

注意:

① 若检索城市数据,region仅能传入城市名称,否则可能会出现badcase。(如:『东京』。若传入『日本东京』可能会触发badcase)。若出现城市重名问题后期会针对该问题做优化。

② query支持传入中英文内容,region参数支持传入中文及部分英文内容,建议使用中文。

③ 检索结果支持中文、英文、local语言三大类,三种类型语言按中文、英文、local语言的优先级进行展示。返回参数见下方页面内容


周边检索
http://api.map.baidu.com/place_abroad/v1/search?
query=寿司&location=35.711343,139.767111&radius=1000&output=json&ak=您的密钥 //GET请求
请求参数
参数名 参数含义 类型 示例 是否必须
query 检索关键字。周边检索和矩形区域内检索支持多个关键字并集检索,不同关键字间以$符号分隔,最多支持10个关键字检索。如:”银行$酒店” string(45) 天安门 必选
tag 检索分类,与query组合进行检索,多个分类以","分隔
POI分类
string(50) 美食 可选
location 周边检索中心点,不支持多个点 string(50) 35.711343,139.767111

lat<纬度>,lng<经度>

必选
radius 周边检索半径,单位为米。 string(50) 1000(默认) 可选
output 输出格式为json或者xml string(50) json或xml 可选
scope 检索结果详细程度。取值为1 或空,则返回基本信息;取值为2,返回检索POI详细信息 string(50) 1、2 可选
coord_type 坐标类型,1(wgs84ll即GPS经纬度),2(gcj02ll即国测局经纬度坐标,港澳台可用),3(bd09ll即百度经纬度坐标)
坐标详细说明
int 1、2、3(默认)、 可选
ret_coordtype 可选参数,添加后POI返回国测局经纬度坐标(港澳台可用过),默认返回bd09ll(百度经纬度坐标系)
坐标详细说明
string(50) gcj02ll 可选
page_size 单次召回POI数量,默认为10条记录,最大返回20条。多关键字检索时,返回的记录数为关键字个数*page_size。 int 10 可选
page_num 分页页码,默认为0,0代表第一页,1代表第二页,以此类推。

常与page_size搭配使用。

int 0、1、2 可选
ak 开发者的访问密钥,必填项。v2之前该属性为key。

申请密钥

string(50) 必选
sn 开发者的权限签名。

Sn校验说明

string(50) 可选,若开发者所用AK的校验方式为SN校验时该参数必须。
timestamp 设置sn后该值必填。 string(50) 设置sn后该值必填。

注意:若检索的圆形区域覆盖多个城市,取圆心点所在城市边界,与圆形区域截取所得区域作为检索范围。


矩形区域检索
http://api.map.baidu.com/place_abroad/v1/search?query=美食&page_size=10&page_num=0&scope=1&bounds=35.66597,139.797339,35.677669,139.813544&output=json&ak={您的密钥} //GET请求
请求参数
参数名 参数含义 类型 示例 是否必须
query 检索关键字。周边检索和矩形区域内检索支持多个关键字并集检索,不同关键字间以$符号分隔,最多支持10个关键字检索。如:”银行$酒店” string(45) 东京塔 必选
tag 检索分类,与query组合进行检索,多个分类以","分隔
POI分类
string(50) 景点 可选
bounds 检索矩形区域,多组坐标间以","分隔 string(50) 38.76623,116.43213,39.54321,116.46773 lat,lng(左下角坐标),lat,lng(右上角坐标) 必选
output 输出格式为json或者xml string(50) json或xml 可选
scope 检索结果详细程度。取值为1 或空,则返回基本信息;取值为2,返回检索POI详细信息 string(50) 1、2 可选
coord_type 坐标类型,1(wgs84ll即GPS经纬度),2(gcj02ll即国测局经纬度坐标,港澳台可用),3(bd09ll即百度经纬度坐标)
坐标详细说明
int 1、2、3(默认)、 可选
ret_coordtype 可选参数,添加后POI返回国测局经纬度坐标(港澳台有效)
坐标详细说明
string(50) gcj02ll 可选
page_size 单次召回POI数量,默认为10条记录,最大返回20条。多关键字检索时,返回的记录数为关键字个数*page_size。 int 10 可选
page_num 分页页码,默认为0,0代表第一页,1代表第二页,以此类推。

常与page_size搭配使用。

int 0、1、2 可选
ak 开发者的访问密钥,必填项。v2之前该属性为key。

申请密钥

string(50) 必选
sn 开发者的权限签名。

Sn校验说明

string(50) 可选,若开发者所用AK的校验方式为SN校验时该参数必须。
timestamp 设置sn后该值必填。 string(50) 设置sn后该值必填。
返回参数(行政区划区域检索、周边检索、矩形区域检索)
名称 类型 说明
status Int 本次API访问状态,如果成功返回0,如果失败返回其他数字。(见服务状态码)
message string 对API访问状态值的英文说明,如果成功返回"ok",并返回结果字段,如果失败返回错误说明。
total int POI检索总数,开发者请求中设置了page_num字段才会出现total字段。出于数据保护目的,单次请求total最多为400。
name string poi名称
location object poi经纬度坐标
lat float 纬度值
lng float 经度值
address string poi地址信息
telephone string poi电话信息
uid string poi的唯一标示
street_id string 街景图id
detail string 是否有详情页:1有,0没有
detail_info object poi的扩展信息,仅当scope=2时,显示该字段,不同的poi类型,显示的detail_info字段不同。
distance int32 距离中心点的距离,圆形区域检索时返回
type string 所属分类,如’hotel’、’cater’。
tag string 标签
detail_url string poi的详情页
price string poi商户的价格
shop_hours string 营业时间
overall_rating string 总体评分
taste_rating string 口味评分
service_rating string 服务评分
environment_rating string 环境评分
facility_rating string 星级(设备)评分
hygiene_rating string 卫生评分
technology_rating string 技术评分
image_num string 图片数
groupon_num int 团购数
discount_num int 优惠数
comment_num string 评论数
favorite_num string 收藏数
checkin_num string 签到数
地点详情检索服务
http://api.map.baidu.com/place_abroad/v1/detail?uid=9b6a2c1550d8c0b9a1acc40e&output=json&scope=2&ak=您的密钥 //GET请求
请求参数
参数 是否必须 默认值 格式举例 含义
uid ‘8ee4560cf91d160e6cc02cd7’ poi的uid
uids ‘8ee4560cf91d160e6cc02cd7’,‘5ffb1816cf771a226f476058’ uid的集合,最多可以传入10个uid,多个uid之间用英文逗号分隔。
output xml json或xml 请求返回格式
scope 1 1、2 检索结果详细程度。取值为1 或空,则返回基本信息;取值为2,返回检索POI详细信息
ak 您的ak 开发者的访问密钥,必填项。v2之前该属性为key。
sn Sn生成方法 开发者的权限签名。
timestamp 设置sn后该值必填。
返回参数(行政区划区域检索、周边检索、矩形区域检索、地点详情检索)
名称 类型 说明
status Int 本次API访问状态,如果成功返回0,如果失败返回其他数字。(见服务状态码)
message string 对API访问状态值的英文说明,如果成功返回"ok",并返回结果字段,如果失败返回错误说明。
total int POI检索总数,开发者请求中设置了page_num字段才会出现total字段。出于数据保护目的,单次请求total最多为400。
name string poi名称
location object poi经纬度坐标
lat float 纬度值
lng float 经度值
address string poi地址信息
telephone string poi电话信息
uid string poi的唯一标示
street_id string 街景图id
detail string 是否有详情页:1有,0没有
detail_info object poi的扩展信息,仅当scope=2时,显示该字段,不同的poi类型,显示的detail_info字段不同。
distance int32 距离中心点的距离,圆形区域检索时返回
type string 所属分类,如’hotel’、’cater’。
tag string 标签
detail_url string poi的详情页
price string poi商户的价格
shop_hours string 营业时间
overall_rating string 总体评分
taste_rating string 口味评分
service_rating string 服务评分
environment_rating string 环境评分
facility_rating string 星级(设备)评分
hygiene_rating string 卫生评分
technology_rating string 技术评分
image_num string 图片数
groupon_num int 团购数
discount_num int 优惠数
comment_num string 评论数
favorite_num string 收藏数
checkin_num string 签到数

服务状态码
返回码 英文描述 定义 常见原因
0 ok 正常 服务请求正常召回
2 Parameter Invalid 请求参数非法 必要参数拼写错误或漏传(如query和tag请求中均未传入)
3 Verify Failure 权限校验失败
4 Quota Failure 配额校验失败 服务当日调用次数已超限,请前往API控制台提升(请优先进行开发者认证
5 AK Failure ak不存在或者非法 未传入ak参数;ak已被删除(可前往回收站恢复);
使用方法
坐标系说明
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、国际化地点检索部分POI检索不到?

全球POI数量非常庞大,POI数据库我们正在逐步建设中,热门国家地区数据覆盖较高,但也可能存在部分较小国家数据覆盖不够,我们会逐步补齐数据。


2018年3月24日

V1.0


产品发布
国际化地点检索服务V1.0正式上线

服务资源下载
国际化地点检索服务支持的国家list

您可以通过此文件获知国际化地点检索服务国家覆盖情况,持续更新中