百度地图开放平台

所有文档

境外地点检索

快速开始

使用准备

接口文档

服务概览
更新时间: 2026/10/16 16:28
境外地点检索API

百度地图海外地点搜索 API(Place Abroad Search API)是用于在海外地区检索地点信息的 RESTful 接口,支持行政区划检索(Region)、周边检索(Around)、矩形检索(Polygon)、地点详情检索(Detail)与输入提示检索(Suggestion)五种方式,支持多种 POI 类型过滤、分页查询及详细/简要两种返回模式。

一、行政区划检索

当使用 region 参数时,系统会在指定的城市或地区内进行地点检索。支持城市名称、城市编码及英文城市名(英文会自动翻译为中文后再检索)。

API服务地址

https://api.map.baidu.com/place_abroad/v1/search
GET请求

请求示例
https://api.map.baidu.com/place_abroad/v1/search?query=机场&region=洛杉矶&output=json&scope=2&ak=您的ak&city_limit=true
请求参数
参数名类型是否必传说明默认值示例

query

string

是

搜索关键词,支持中文、英文(必填)

-

"ATM机"

region

string

是

搜索区域,支持城市名称 / 城市编码 / 英文城市名(必填)

-

"洛杉矶"

ak

string

是

开发者密钥(必填)

-

type

string

否

更精确的 POI 类型过滤,与 query 配合使用;并集分隔符"|",交集分隔符"&"

-

"银行"

tag

string

否

标签过滤,用于类型过滤

-

"银行"|"银行|酒店"|"美食&景点"

scope

int

否

返回信息详细程度:1-简要信息,2-详细信息

1

2

page_size

int

否

每页返回结果数量,范围 1-20

10

20

page_num

int

否

页码,从 0 开始

0

1

output

string

否

返回数据格式:json 或 xml

"json"

"xml"

city_limit

string

否

是否限制在当前城市内搜索

"false"

"true"

coord_type

int

否

坐标类型:1-WGS84,2-国测局,3-百度经纬度,4-百度墨卡托

3

1

ret_coordtype

string

否

返回坐标类型:gcj02ll-国测局坐标 / bd09ll-百度坐标

-

"gcj02ll"

cuid

string

否

客户端唯一标识符,用于内部服务调用

-

"client_12345"

filter

string

否

过滤条件字符串,多个条件用竖线分隔,每个条件格式为 "key:value"

-

"industry_type:cater|sort_name:distance|sort_rule:0|price_section:0,100"

sn

string

否

开发者的权限签名

-

timestamp

string

sn 存在时必填

设置 sn 后必填

-

返回参数
返回参数类型说明

status

int

状态码,0 表示成功

message

string

状态信息

total

int

结果总数(分页时返回)

results

array

搜索结果列表

name

string

地点名称

location

object

坐标信息

lat

float

纬度

lng

float

经度

address

string

地址信息

telephone

string

电话号码

uid

string

地点唯一标识

detail

int

是否有详细信息(1-有,0-无)

street_id

string

街景 ID

status

string

营业状态

formatted_address

string

格式化地址

country

string

国家

province

string

省份

city

string

城市

district

string

区县

town

string

乡镇

street

string

街道

detail_info

object

详细信息(当 scope=2 时返回)

tag

string

地点标签

type

string

地点类型

detail_url

string

详情页面 URL

distance

int

距离(周边搜索时返回)

navi_location

object

导航坐标

lng

float

导航经度

lat

float

导航纬度

indoor_floor

string

楼层信息

overall_rating

string

总体评分

taste_rating

string

口味评分(餐饮类)

service_rating

string

服务评分

environment_rating

string

环境评分

facility_rating

string

设施评分

hygiene_rating

string

卫生评分

technology_rating

string

技术评分

price

string

价格等级

shop_hours

string

营业时间

image

string

图片 URL

image_num

string

图片数量

groupon_num

string

团购数量

discount_num

string

优惠数量

comment_num

string

评论数量

favorite_num

string

收藏数量

checkin_num

string

签到数量

atmosphere

string

氛围描述

featured_service

string

特色服务

recommendation

string

推荐信息

category

string

分类信息

level

string

等级信息

environment_exterior

string

外部环境

inner_facility

string

内部设施

hotel_facility

string

酒店设施

hotel_service

string

酒店服务

payment_type

string

支付方式

brand

string

品牌信息

alias

string

别名

scope_type

string

经营范围类型

scope_grade

string

经营范围等级

description

string

描述信息

di_review_keyword

array

点评关键词

keyword

string

关键词内容

keyword_category_name

string

关键词分类名称

keyword_category_seq

string

关键词分类序号

keyword_comment_ids

string

相关评论 ID 列表(含 cmt_ksarchid 关键评论 id、start 起始标记、end 结束标记)

keyword_desc

string

关键词描述

keyword_num

string

关键词出现次数

keyword_tag

string

关键词标签

keyword_type

string

关键词类型


二、周边检索

以中心点坐标为圆心、指定半径范围内检索地点。

API服务地址

https://api.map.baidu.com/place_abroad/v1/search
GET请求

请求示例
https://api.map.baidu.com/place_abroad/v1/search?query=restaurant&location=33.941589,-118.40853&radius=1000&output=json&scope=2&ak=您的ak
请求参数
参数名类型是否必传说明默认值示例

query

string

是

搜索关键词,支持中文、英文(必填)

-

"ATM机"

location

string

是

中心点坐标,格式:纬度,经度(必填)

-

"34.052235,-118.243683"

ak

string

是

开发者密钥(必填)

-

"您的ak"

radius

integer

否

搜索半径,单位:米,最大 100000

1000

2000

radius_limit

string

否

是否严格限制在半径范围内

"false"

"true"

coordtype

string

否

坐标类型

"bd09ll"

"wgs84ll"

ret_coordtype

string

否

返回坐标类型

"bd09ll"

"gcj02ll"

scope

integer

否

返回结果详细程度

1

2

page_size

integer

否

每页返回记录数

10

20

page_num

integer

否

页码,从 0 开始

0

1

output

string

否

输出格式

"json"

"xml"

tag

string

否

POI 类型标签

-

"银行"

type

string

否

POI 类型过滤

-

"银行"

filter

string

否

过滤条件

-

"industry_type:cater|sort_name:distance"

cuid

string

否

客户端唯一标识

-

"user123"

sn

string

否

开发者的权限签名

-

timestamp

string

sn 存在时必填

设置 sn 后必填

-

返回参数

返回参数结构同 Region 检索。


三、矩形检索

在指定矩形区域范围内检索地点。

API服务地址

https://api.map.baidu.com/place_abroad/v1/search
GET请求

请求示例
https://api.map.baidu.com/place_abroad/v1/search?query=restaurant&bounds=34.02,-118.30,34.08,-118.20&radius=1000&output=json&scope=2&ak=您的ak
请求参数
参数名类型是否必传说明默认值示例

query

string

是

搜索关键词,支持中文、英文(必填)

-

"ATM机"

bounds

string

是

矩形区域,格式:左下纬度,左下经度,右上纬度,右上经度(必填)

-

"34.02,-118.30,34.08,-118.20"

ak

string

是

开发者密钥(必填)

-

"您的ak"

coordtype

string

否

坐标类型

"bd09ll"

"wgs84ll"

ret_coordtype

string

否

返回坐标类型

"bd09ll"

"gcj02ll"

scope

integer

否

返回结果详细程度

1

2

page_size

integer

否

每页返回记录数

10

20

page_num

integer

否

页码,从 0 开始

0

1

output

string

否

输出格式

"json"

"xml"

tag

string

否

POI 类型标签

-

"银行"

type

string

否

POI 类型过滤

-

"银行"

filter

string

否

过滤条件

-

"industry_type:cater|sort_name:distance"

cuid

string

否

客户端唯一标识

-

"user123"

sn

string

否

开发者的权限签名

-

timestamp

string

sn 存在时必填

设置 sn 后必填

-

返回参数

返回参数结构同 Region 检索。


四、地点详情检索

通过 POI 的 uid 查询单个或批量地点的详细信息,最多支持 10 个 POI 的批量查询。

API服务地址

https://api.map.baidu.com/place_abroad/v1/detail
GET请求

请求示例
# 单个 POI 查询
https://api.map.baidu.com/place_abroad/v1/detail?uid=8fee96d7bdf8bae8b6f42fb0&output=json&scope=2&ak=您的ak
# 批量 POI 查询
https://api.map.baidu.com/place_abroad/v1/detail?uids=8fee96d7bdf8bae8b6f42fb0,aa7710a1f3703f4b9e9d6892&output=json&scope=2&ak=您的ak
请求参数
参数名类型是否必传说明默认值示例

uid

string

二选一

单个 POI 的唯一标识符(uid / uids 二选一)

-

"1234567890"

uids

string

二选一

多个 POI 的唯一标识符,用逗号分隔,最多 10 个

-

"1234567890,9876543210"

ak

string

是

开发者密钥(必填)

-

"您的ak"

scope

integer

否

返回结果详细程度

1

2

output

string

否

输出格式

"json"

"xml"

ret_coordtype

string

否

返回坐标类型

"bd09ll"

"gcj02ll"

cuid

string

否

客户端唯一标识

-

"user123"

sn

string

否

开发者的权限签名

-

timestamp

string

sn 存在时必填

设置 sn 后必填

-

返回参数
返回参数类型说明

status

integer

状态码,0 表示成功

message

string

状态信息

result

object/array

结果数据(单个 POI 为 object,多个 POI 为 array)

name

string

POI 名称

location

object

坐标信息

lat

float

纬度

lng

float

经度

address

string

地址信息

telephone

string

电话号码

uid

string

POI 唯一标识

detail

integer

是否有详情页(1-有,0-无)

street_id

string

街景 ID

status

string

营业状态

detail_info

object

详细信息(当 scope=2 时返回)

tag

string

POI 标签

type

string

POI 类型

detail_url

string

详情页面 URL

navi_location

object

导航坐标

lat

float

导航点纬度

lng

float

导航点经度

indoor_floor

string

室内楼层信息

price

string

价格信息

overall_rating

string

总体评分

taste_rating

string

口味评分

service_rating

string

服务评分

environment_rating

string

环境评分

facility_rating

string

设施评分

hygiene_rating

string

卫生评分

technology_rating

string

技术评分

image

string

图片信息

image_num

string

图片数量

groupon_num

string

团购数量

discount_num

string

优惠数量

comment_num

string

评论数量

favorite_num

string

收藏数量

checkin_num

string

签到数量

di_review_keyword

array

评论关键词

shop_hours

string

营业时间

atmosphere

string

氛围描述

featured_service

string

特色服务

recommendation

string

推荐信息

category

string

分类信息

level

string

等级信息

environment_exterior

string

外部环境

inner_facility

string

内部设施

hotel_facility

string

酒店设施

hotel_service

string

酒店服务

payment_type

string

支付方式

brand

string

品牌信息

alias

string

别名

scope_type

string

经营范围类型

scope_grade

string

经营范围等级

description

string

描述信息

营业状态值说明
状态值说明

""(空)

正常营业

已失效

已删除

暂停营业

暂停营业

尚未开业

尚未开业

已关闭

停止营业

推算位置

模糊上线

可能已关闭

模糊下线


五、输入提示检索

根据输入关键词返回地点建议,区域参数 region / location / bounds 三选一。

API服务地址

https://api.map.baidu.com/place_abroad/v1/suggestion
GET请求

请求参数
参数名类型是否必传说明默认值示例

query

string

是

搜索关键词,支持中文、英文(必填)

-

"银行"

ak

string

是

开发者密钥(必填)

-

"您的ak"

region

string

三选一

搜索区域,支持城市名称或城市编码(区域参数三选一)

-

"东京" 或 "131"

location

string

三选一

中心点坐标,格式:纬度,经度(区域参数三选一)

-

"35.676200,139.650300"

bounds

string

三选一

矩形区域,格式:左下纬度,左下经度,右上纬度,右上经度(区域参数三选一)

-

"35.6762,139.6503,35.7262,139.7003"

coord_type

string

否

坐标类型

"3"

"1"

radius

integer

否

搜索半径,单位:米,最大 100000

1000

2000

city_limit

string

否

是否限制在当前城市

"false"

"true"

output

string

否

输出格式

"json"

"xml"

cuid

string

否

客户端唯一标识

-

"user123"

sn

string

否

开发者的权限签名

-

timestamp

string

sn 存在时必填

设置 sn 后必填

-

请求示例
# 区域检索
https://api.map.baidu.com/place_abroad/v1/suggestion?query=restaurant&region=Tokyo&output=json&ak=您的ak&city_limit=true
# 周边检索
https://api.map.baidu.com/place_abroad/v1/suggestion?query=restaurant&location=35.6762,139.6503&radius=1000&output=json&ak=您的ak&city_limit=true
# 矩形检索
https://api.map.baidu.com/place_abroad/v1/suggestion?query=restaurant&output=json&ak=您的ak&bounds=139.6503,35.6762,139.7003,35.7262&city_limit=true
返回参数
返回参数类型说明

status

integer

状态码,0 表示成功

message

string

状态信息

result

array

建议结果列表

name

string

POI 名称

location

object

坐标信息

lat

float

纬度

lng

float

经度

uid

string

POI 唯一标识

city

string

城市名称

district

string

区县名称

business

string

商圈名称

cityid

string

城市编码

tag

string

POI 标签

address

string

地址信息

上一篇

使用准备

下一篇

服务概览
本篇文章对您是否有帮助?