地点检索

所有文档

服务概览

快速开始

使用准备开始使用

接口文档

地点检索3.0 多维检索深度检索地点检索2.0(原检索)

相关资料

更新日志常见问题资源下载使用指南

地点检索3.0

行政区划区域检索

下载开发文档

接口说明

开发者可通过该功能，检索某一行政区划内（目前最细到区县级别）的地点信息。

API服务地址

https://api.map.baidu.com/place/v3/region?query=ATM机&type=银行&region=北京&ak=您的ak
//GET请求

请求参数

参数名称	参数含义	示例	必选
query	检索关键字	天安门、美食	是
region	检索行政区划区域（支持到区县级）（增加区域内数据召回权重，如需严格限制召回数据在区域内，请搭配使用region_limit参数），可输入行政区划名或对应citycode	北京市海淀区北京，海淀区北京海淀建议填写完整区县信息	是
ak	开发者的访问密钥，必填项。v2之前该属性为key。申请密钥		是
region_limit	区域数据召回限制，为true时，仅召回region对应区域内数据	true/false	否
is_light_version	true：轻量化检索，检索速度大幅提升，排序更简单直接；如对接口平响有要求，建议咨询技术支持进行指导切换。 false，默认：优化检索结果的排序，使返回的POI更接近百度地图App的推荐顺序，提升结果的相关性和体验；可能略微增加响应耗时，建议对结果顺序敏感但对平响要求不高的场景使用。	true/false	否
type	对query召回结果进行二次筛选，type内容建议参考POI分类内容，建议query同属于一个大类；如query=美食 type=火锅（用于泛搜索场景） query和type支持只填一项	火锅	否
center	传入poi坐标，辅助检索结果按距离排序与返回需要搭配排序字段一起使用并结合coord_type字段说明该字段的坐标类型	38.76623,116.43213 lat<纬度>,lng<经度>	否
scope	检索结果详细程度。取值为1 或空，则返回基本信息；取值为2，返回检索POI详细信息	1、 2	否
coord_type	传入的坐标类型，1（wgs84ll即GPS经纬度），2（gcj02ll即国测局经纬度坐标），3（bd09ll即百度经纬度坐标），4（bd09mc即百度米制坐标）	1、2、3(默认)、 4	否
filter	检索排序条件，包含以下3部分 industry_type：排序支持的行业类型，取值有：hotel（酒店宾馆）；cater（餐饮）；life（生活类） sort_name：排序方式，取值有：default（默认）；price（价格）；overall_rating（评分）；distance（距离排序，需结合center字段一起使用） sort_rule：排序规则，取值有：0（从高到低），1（从低到高）	industry_type:cater sort_name:overall_rating sort_rule:1	否
extensions_adcode	是否召回国标行政区划编码、true（召回）、false（不召回）	true、false	否
address_result	query传入结构化地址（如：上地十街10号），检索结果返回数据的类型。若不传入该字段，默认召回门址数据，仅当address_result=false时，召回相应的POI数据	false	否
photo_show	是否输出图片信息：true(输出)，false(不输出) 购买商用授权后可联系商务，提交工单申请开通	false, true 默认值: false	否
from_language	query的语言类型，支持不同语言的检索词作为入参，不填默认为中文，可以设置为auto，大模型会自行判断入参语言，参考语种列表	auto	否
language	多语言检索，支持多种语言召回结果，参考语种列表，默认为中文。注意：该功能为高级付费功能，您可提交工单咨询。	en，fr	否
page_num	分页页码，默认为0,0代表第一页，1代表第二页，以此类推。常与page_size搭配使用，仅当返回结果为poi时可以翻页。	0、1、2	否
page_size	单次召回POI数量，默认为10条记录，最大返回20条。取值为10-20	10	否
ret_coordtype	返回的坐标类型，可选参数，添加后POI返回国测局经纬度坐标	gcj02ll	否
output	输出数据格式，仅支持json	json	否

返回参数

返回参数				类型	备注
status				int	本次API访问状态，如果成功返回0，如果失败返回其他数字。（见服务状态码）
message				string	对API访问状态值的英文说明，如果成功返回ok，并返回结果字段，如果失败返回错误说明。
total				int	召回poi数量，开发者请求中设置了page_num字段才会出现total字段。出于数据保护目的，单次请求total最多为150。
result_type				string	召回结果类型：region_type 行政区划类型;address_type 结构化地址类型;poi_type poi类型;city_type 城市类型
query_type				string	搜索类型：精搜precise/泛搜general
results					返回的结果
	uid			string	poi的唯一标示，ID
	name			string	poi名称，单次请求最多返回10条结果
	location			object	poi经纬度坐标
		lat		float	纬度值
		lng		float	经度值
	province			string	poi所属省份
	city			string	poi所属城市
	area			string	poi所属区县
	town			string	poi所属乡镇街道
	town_code			int	poi所属乡镇街道编码
	adcode			int	poi所属区域代码
	address			string	poi所在地址
	status			string	poi营业状态：空（代表正常营业）推算位置（代表开放/营业/办公状态可能有变化）暂停营业可能已关闭已关闭购买商用授权后可联系商务，提交工单申请开通
	telephone			string	poi的电话
	street_id			string	poi所在街景图id
	detail			string	是否有详情页：1有，0没有
	detail_info			object	详细信息
		classified_poi_tag		string	POI展示分类（细致分类）
		new_alias		string	poi别名
		type		string	类型如（hotel、cater、life），配合filter排序
		detail_url		string	poi的详情页
		shop_hours		string	poi的营业时间 10:30-14:00,16:30-22:00
		price		string	poi商户的价格
		label		string	poi权威标签，标签细分解释，比如停车场标签（地上停车场/地下停车场），知名景区标签（几A级景区），酒店标签（什么类型酒店）等
		overall_rating		string	poi的综合评分
		image_num		string	poi图片数
		comment_num		string	poi的评论数
		navi_location		object	poi对应的导航引导点坐标（上车点）。大型面状poi的导航引导点，一般为各类出入口，方便结合导航、路线规划等服务使用
		brand		string	poi对应的品牌
		indoor_floor		string	室内poi所在楼层
		ranking		string	poi的相关榜单排名
		parent_id		string	poi父点id
		photos		array	poi图片的下载链接购买商用授权后可联系商务，提交工单申请开通
		best_time		string	最佳游玩时间 (如需获取以下字段，请跳转至地点详情检索)
		sug_time		string	建议时长(如需获取以下字段，请跳转至地点详情检索)
		description		string	描述(如需获取以下字段，请跳转至地点详情检索)
		children			poi子点
			uid	string	poi子点ID，可用于poi详情检索
			show_name	string	poi子点简称
			name	string	poi子点名称
			classified_poi_tag	string	poi子点详细分类标签
			location	object	poi子点坐标
			address	string	poi子点地址
		d7_hot_value		int	poi近7天的热度总值
以下为高级权限，可联系商务，提交工单申请开通
		view_heat		int	poi的浏览热度
		arrival_heat		int	poi的到达热度
		interact_heat		int	poi的互动热度
		heat_trend		string	近7天热度增长（递减）XX%

圆形区域检索

下载开发文档

接口说明

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

API服务地址

https://api.map.baidu.com/place/v3/around?query=银行&location=39.915,116.404&radius=2000&ak=您的密钥
//GET请求

请求参数

参数名称	参数含义	示例	必选
query	检索关键字。圆形区域检索和多边形区域内检索支持多个关键字并集检索，不同关键字间以$符号分隔，最多支持10个关键字检索。如:银行$酒店如果需要按POI分类进行检索，请将分类通过query参数进行设置，如query=美食	天安门、美食	是
location	圆形区域检索中心点，不支持多个点	38.76623,116.43213 lat<纬度>,lng<经度>	是
ak	开发者的访问密钥，必填项。v2之前该属性为key。申请密钥		是
radius	圆形区域检索半径，单位为米。（增加区域内数据召回权重，如需严格限制召回数据在区域内，请搭配使用radius_limit参数），当半径过大，超过中心点所在城市边界时，会变为城市范围检索，检索范围为中心点所在城市	可以不传，默认1000	否
radius_limit	是否严格限定召回结果在设置检索半径范围内。true（是），false（否）。	true/false	否
is_light_version	true：优先保证检索速度，排序更简单直接； false，默认：优化检索结果的排序，使返回的POI更接近百度地图App的推荐顺序，提升结果的相关性和体验；可能略微增加响应耗时，建议对结果顺序敏感但对平响要求不高的场景使用。	true/false	否
type	对query召回结果进行二次筛选，type内容建议参考POI分类内容，建议query同属于一个大类；如query=美食 type=火锅（用于泛搜索场景） query和type支持只填一项	火锅	否
scope	检索结果详细程度。取值为1 或空，则返回基本信息；取值为2，返回检索POI详细信息	1、2	否
coord_type	传入的坐标类型，1（wgs84ll即GPS经纬度），2（gcj02ll即国测局经纬度坐标），3（bd09ll即百度经纬度坐标），4（bd09mc即百度米制坐标）	1、2、3(默认)、4	否
filter	检索排序条件，包含以下3个部分： industry_type：排序支持的行业类型，取值有： hotel（酒店宾馆）；cater（餐饮）；life（生活娱乐） sort_name：排序方式，取值有： default（默认）；price（价格）；overall_rating（评价）；distance（距离排序，需结合center字段一起使用） sort_rule：排序规则，取值有：0（从高到低），1（从低到高）	industry_type:cater\|sort_name:overall_rating\|sort_rule:1	否
extensions_adcode	是否召回国标行政区划编码，true（召回）、false（不召回）	true、false	否
photo_show	是否输出图片信息：true(输出)，false(不输出) 购买商用授权后可联系商务，提交工单申请开通	false、true 默认值：false	否
from_language	query的语言类型，支持不同语言的检索词作为入参，不填默认为中文，可以设置为auto，大模型会自行判断入参语言，参考语种列表	auto	否
language	多语言检索，支持多种语言召回结果，参考语种列表，默认为中文。注意：该功能为高级付费功能，您可提交工单咨询。	en，fr	否
page_num	分页页码，默认为0,0代表第一页，1代表第二页，以此类推。常与page_size搭配使用，仅当返回结果为poi时可以翻页。	0、1、2	否
page_size	单次召回POI数量，默认为10条记录，最大返回20条。取值为10-20	10	否
ret_coordtype	返回的坐标类型，可选参数，添加后POI返回国测局经纬度坐标	gcj02ll	否
output	输出数据格式，仅支持json	json	否

返回参数

返回参数				类型	备注
status				int	本次API访问状态，如果成功返回0，如果失败返回其他数字。（见服务状态码）
message				string	对API访问状态值的英文说明，如果成功返回ok，并返回结果字段，如果失败返回错误说明。
total				int	召回poi数量，开发者请求中设置了page_num字段才会出现total字段。出于数据保护目的，单次请求total最多为150。
result_type				string	召回结果类型：region_type 行政区划类型;address_type 结构化地址类型;poi_type poi类型;city_type 城市类型
query_type				string	搜索类型：精搜precise/泛搜general
results					返回的结果
	uid			string	poi的唯一标示，ID
	name			string	poi名称，单次请求最多返回10条结果
	location			object	poi经纬度坐标
		lat		float	纬度值
		lng		float	经度值
	province			string	poi所属省份
	city			string	poi所属城市
	area			string	poi所属区县
	town			string	poi所属乡镇街道
	town_code			int	poi所属乡镇街道编码
	adcode			int	poi所属区域代码
	address			string	poi所在地址
	status			string	poi营业状态：空（代表正常营业）推算位置（代表开放/营业/办公状态可能有变化）暂停营业可能已关闭已关闭购买商用授权后可联系商务，提交工单申请开通
	telephone			string	poi的电话
	street_id			string	poi所在街景图id
	detail			string	是否有详情页：1有，0没有
	detail_info			object	详细信息
		classified_poi_tag		string	POI展示分类（细致分类）
		distance		int32	距离中心点的距离，圆形区域检索时返回
		new_alias		string	poi别名
		type		string	类型如（hotel、cater、life）配合filter排序
		detail_url		string	poi的详情页
		shop_hours		string	poi的营业时间 10:30-14:00,16:30-22:00
		price		string	poi商户的价格
		label		string	poi权威标签，标签细分解释，比如停车场标签（地上停车场/地下停车场），知名景区标签（几A级景区），酒店标签（什么类型酒店）等
		overall_rating		string	poi的综合评分
		image_num		string	poi图片数
		comment_num		string	poi的评论数
		navi_location		object	poi对应的导航引导点坐标（上车点）。大型面状poi的导航引导点，一般为各类出入口，方便结合导航、路线规划等服务使用
		brand		string	poi对应的品牌
		indoor_floor		string	室内poi所在楼层
		ranking		string	poi的相关榜单排名
		parent_id		string	poi父点id
		photos		array	poi图片的下载链接购买商用授权后可联系商务，提交工单申请开通
		best_time		string	最佳游玩时间 (如需获取以下字段，请跳转至地点详情检索)
		sug_time		string	建议时长(如需获取以下字段，请跳转至地点详情检索)
		description		string	描述(如需获取以下字段，请跳转至地点详情检索)
		children			poi子点
			uid	string	poi子点ID，可用于poi详情检索
			show_name	string	poi子点简称
			name	string	poi子点名称
			classified_poi_tag	string	poi子点详细分类标签
			location	object	poi子点坐标
			address	string	poi子点地址
		d7_hot_value		int	poi近7天的热度总值
以下为高级权限，可联系商务，提交工单申请开通
		view_heat		int	poi的浏览热度
		arrival_heat		int	poi的到达热度
		interact_heat		int	poi的互动热度
		heat_trend		string	近7天热度增长（递减）XX%

多边形区域检索

下载开发文档

接口说明

开发者可使用多边形区域检索传入多个坐标对，首尾坐标对需相同，坐标对用”,”分割。两顶点坐标对。即可获取地点（POI）基础或详细地理信息。

API服务地址

https://api.map.baidu.com/place/v3/polygon?query=银行&bounds=39.915,116.404,39.975,116.414&ak=您的密钥
//GET请求

请求参数

参数名称	参数含义	示例	必选
query	检索关键字。圆形区域检索和多边形区域内检索支持多个关键字并集检索，不同关键字间以$符号分隔，最多支持10个关键字检索。如:银行$酒店	天安门、美食	是
bounds	检索多边形区域。需传入多个坐标对集合，坐标对用","分割，首尾坐标对需相同。多边形为矩形时，可传入左下右上两顶点坐标对。 bounds参数范围，最少2对，最大100对坐标 bounds参数在大于2对坐标时，需要首尾相连成闭合多边形	38.76623,116.43213, 40.056878,116.30815, 40.465,116.314, 40.232,116.352, 40.121,116.453, 38.76623,116.43213	是
ak	开发者的访问密钥，必填项。v2之前该属性为key。申请密钥		是
is_light_version	true：优先保证检索速度，排序更简单直接； false，默认：优化检索结果的排序，使返回的POI更接近百度地图App的推荐顺序，提升结果的相关性和体验；可能略微增加响应耗时，建议对结果顺序敏感但对平响要求不高的场景使用。	true/false	否
type	对query召回结果进行二次筛选，type内容建议参考POI分类内容，建议query同属于一个大类；如query=美食 type=火锅（用于泛搜索场景） query和type支持只填一项	火锅	否
scope	检索结果详细程度。取值为1 或空，则返回基本信息；取值为2，返回检索POI详细信息	1、2	否
coord_type	传入的坐标类型，1（wgs84ll即GPS经纬度），2（gcj02ll即国测局经纬度坐标），3（bd09ll即百度经纬度坐标），4（bd09mc即百度米制坐标）	1、2、3(默认)、4	否
filter	检索排序条件，包含以下3个部分 industry_type：排序支持的行业类型，取值有： hotel（酒店宾馆）；cater（餐饮）；life（生活娱乐） sort_name：排序方式，取值有： default（默认）；price（价格）；overall_rating（评价）；distance（距离排序，需结合center字段一起使用） sort_rule：排序规则，取值有：0（从高到低），1（从低到高）	industry_type:cater\|sort_name:overall_rating\|sort_rule:1	否
extensions_adcode	是否召回国标行政区划编码，true（召回）、false（不召回）	true、false	否
photo_show	是否输出图片信息：true(输出)，false(不输出) 购买商用授权后可联系商务，提交工单申请开通	false、true 默认值：false	否
from_language	query的语言类型，支持不同语言的检索词作为入参，不填默认为中文，可以设置为auto，大模型会自行判断入参语言，参考参考语种列表	auto	否
language	多语言检索，支持多种语言召回结果，参考语种列表，默认为中文。注意：该功能为高级付费功能，您可提交工单咨询。	en，fr	否
page_num	分页页码，默认为0,0代表第一页，1代表第二页，以此类推。常与page_size搭配使用，仅当返回结果为poi时可以翻页。	0、1、2	否
page_size	单次召回POI数量，默认为10条记录，最大返回20条。取值为10-20	10	否
ret_coordtype	返回的坐标类型，可选参数，添加后POI返回国测局经纬度坐标	gcj02ll	否
output	输出数据格式，仅支持json	json	否

返回参数

返回参数				类型	备注
status				int	本次API访问状态，如果成功返回0，如果失败返回其他数字。（见服务状态码）
message				string	对API访问状态值的英文说明，如果成功返回ok，并返回结果字段，如果失败返回错误说明。
total				int	召回poi数量，开发者请求中设置了page_num字段才会出现total字段。出于数据保护目的，单次请求total最多为150。
result_type				string	召回结果类型：region_type 行政区划类型;address_type 结构化地址类型;poi_type poi类型;city_type 城市类型
query_type				string	搜索类型：精搜precise/泛搜general
results					返回的结果
	uid			string	poi的唯一标示，ID
	name			string	poi名称，单次请求最多返回10条结果
	location			object	poi经纬度坐标
		lat		float	纬度值
		lng		float	经度值
	province			string	poi所属省份
	city			string	poi所属城市
	area			string	poi所属区县
	town			string	poi所属乡镇街道
	town_code			int	poi所属乡镇街道编码
	adcode			int	poi所属区域代码
	address			string	poi所在地址
	status			string	poi营业状态：空（代表正常营业）推算位置（代表开放/营业/办公状态可能有变化）暂停营业可能已关闭已关闭购买商用授权后可联系商务，提交工单申请开通
	telephone			string	poi的电话
	street_id			string	poi所在街景图id
	detail			string	是否有详情页：1有，0没有
	detail_info			object	详细信息
		classified_poi_tag		string	POI展示分类（细致分类）
		distance		int32	距离中心点的距离，圆形区域检索时返回
		type		string	类型如（hotel、cater、life）配合filter排序
		detail_url		string	poi的详情页
		shop_hours		string	poi的营业时间 10:30-14:00,16:30-22:00
		price		string	poi商户的价格
		label		string	poi权威标签，标签细分解释，比如停车场标签（地上停车场/地下停车场），知名景区标签（几A级景区），酒店标签（什么类型酒店）等
		overall_rating		string	poi的综合评分
		image_num		string	poi图片数
		new_alias		string	poi别名
		comment_num		string	poi的评论数
		navi_location		object	poi对应的导航引导点坐标（上车点）。大型面状poi的导航引导点，一般为各类出入口，方便结合导航、路线规划等服务使用
		brand		string	poi对应的品牌
		indoor_floor		string	室内poi所在楼层
		ranking		string	poi的相关榜单排名
		parent_id		string	poi父点id
		photos		array	poi图片的下载链接购买商用授权后可联系商务，提交工单申请开通
		best_time		string	最佳游玩时间 (如需获取以下字段，请跳转至地点详情检索)
		sug_time		string	建议时长(如需获取以下字段，请跳转至地点详情检索)
		description		string	描述(如需获取以下字段，请跳转至地点详情检索)
		children			poi子点
			uid	string	poi子点ID，可用于poi详情检索
			show_name	string	poi子点简称
			name	string	poi子点名称
			classified_poi_tag	string	poi子点详细分类标签
			location	object	poi子点坐标
			address	string	poi子点地址
		d7_hot_value		int	poi近7天的热度总值
以下为高级权限，可联系商务，提交工单申请开通
		view_heat		int	poi的浏览热度
		arrival_heat		int	poi的到达热度
		interact_heat		int	poi的互动热度
		heat_trend		string	近7天热度增长（递减）XX%

如您需要获取POI图片及POI营业状态，请点击获取POI图片，获取POI营业状态。

地点详情检索

下载开发文档

接口说明

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

注意：请通过检索接口实时获取POI数据UID进行详情检索。

API服务地址

https://api.map.baidu.com/place/v3/detail?uid=435d7aea036e54355abbbcc8&scope=2&ak=您的密钥
//GET请求

请求参数

参数名称	参数含义	示例	必选
uid	poi的uid	8ee4560cf91d160e6cc02cd7	必须提供一项
uids	uid的集合，最多可以传入10个uid，多个uid之间用英文逗号分隔。	8ee4560cf91d160e6cc02cd7,5ffb1816cf771a226f476058	必须提供一项
ak	开发者的访问密钥，必填项。v2之前该属性为key。申请密钥		是
scope	检索结果详细程度。取值为1 或空，则返回基本信息；取值为2，返回检索POI详细信息	1、2	否
extensions_adcode	是否召回国标行政区划编码，true（召回）、false（不召回）	true、false	否
photo_show	是否输出图片信息：true(输出)，false(不输出) 购买商用授权后可联系商务，提交工单申请开通	false、true 默认值：false	否
ret_coordtype	返回的坐标类型，可选参数，添加后POI返回国测局经纬度坐标	gcj02ll	否
language	多语言检索，支持多种语言召回结果，参考语种列表指定输入参数和召回参数结果的语言类型，可支持的语言类型为多种语言，不填默认为中文。注意：该功能为高级付费功能，您可提交工单咨询。	en，fr	否
output	输出数据格式，仅支持json	json	否

返回参数

返回参数				类型	备注
status				int	本次API访问状态，如果成功返回0，如果失败返回其他数字。（见服务状态码）
message				string	对API访问状态值的英文说明，如果成功返回ok，并返回结果字段，如果失败返回错误说明。
results					返回的结果
	uid			string	poi的唯一标示，ID
	name			string	poi名称，单次请求最多返回10条结果
	location			object	poi经纬度坐标
		lat		float	纬度值
		lng		float	经度值
	province			string	poi所属省份
	city			string	poi所属城市
	area			string	poi所属区县
	town			string	poi所属乡镇街道
	town_code			int	poi所属乡镇街道编码
	adcode			int	poi所属区域代码
	address			string	poi所在地址
	status			string	poi营业状态：空（代表正常营业）推算位置（代表开放/营业/办公状态可能有变化）暂停营业可能已关闭已关闭购买商用授权后可联系商务，提交工单申请开通
	telephone			string	poi的电话
	street_id			string	poi所在街景图id
	detail			string	是否有详情页：1有，0没有
	detail_info			object	详细信息
		tag		string	poi分类标签
		classified_poi_tag		string	POI展示分类（细致分类）
		type		string	类型如（hotel、cater、life）配合filter排序
		detail_url		string	poi的详情页
		shop_hours		string	poi的营业时间10:30-14:00,16:30-22:00
		price		string	poi商户的价格
		overall_rating		string	poi的综合评分
		image_num		string	poi图片数
		comment_num		string	poi的评论数
		navi_location		object	poi对应的导航引导点坐标（上车点）。大型面状poi的导航引导点，一般为各类出入口，方便结合导航、路线规划等服务使用
		brand		string	poi对应的品牌
		indoor_floor		string	室内poi所在楼层
		ranking		string	poi的相关榜单排名
		parent_id		string	poi父点id
		photos		array	poi图片的下载链接购买商用授权后可联系商务，提交工单申请开通
		best_time		string	最佳游玩时间
		sug_time		string	建议时长
		description		string	描述
		children		string	poi子点
			uid	string	poi子点ID
			std_tag	string	poi子点分类标签
			name	string	poi子点名称
			show_name	string	poi子点简称
			location	object	poi子点坐标
			distance	int	poi子点与主点的距离（若无distance返回，则说明该子点在主点内）
			pv_rate	string	poi子点的热度（X%选择）
			content_info	string	poi子点内容标签
			classified_poi_tag	string	poi子点详细分类标签

地点输入提示

下载开发文档

接口说明

地点输入提示服务（又名Place Suggestion API）是一类Web API接口服务。

匹配用户输入内容，提供输入提示功能。常与地点检索服务搭配使用。也可作为轻量级地点检索服务单独使用（不支持复杂检索场景）。

用户可通过该服务，匹配用户输入关键词的地点推荐列表。

注意：请通过检索接口实时获取POI数据UID进行详情检索。

API服务地址

https://api.map.baidu.com/place/v3/suggestion?query=天安门&region=北京&region_limit=true&ak=您的ak
//GET请求

请求参数

参数名称	参数含义	示例	必选
query	输入建议关键字（支持拼音）	上地、天安、中关、shanghai	是
region	检索行政区划区域（仅支持到市级） region 检索行政区划区域（仅支持到市级）（增加区域内数据召回权重，如需严格限制召回数据在区域内，请搭配使用region_limit参数），可输入行政区划名或对应citycode	北京市	是
ak	开发者的访问密钥，必填项。v2之前该属性为key。申请密钥		是
region_limit	区域数据召回限制，为true时，仅召回region对应区域内数据	true/false	否
location	传入location参数后，是综合各种相关性排序的，location参数只是其中一个因素，但不会严格按距离排序决定最终的排序	40.047857537164,116.31353434477	否
radius	圆形区域检索半径，单位为米。当半径过大，超过中心点所在城市边界时，会变为城市范围检索，检索范围为中心点所在城市	默认1000	否
bounds	检索多边形区域。需传入多个坐标对集合，坐标对用','分割，首尾坐标对需相同。多边形为矩形时，可传入左下右上两顶点坐标对。 bounds参数范围，最少2对，最大100对坐标 bounds参数在大于2对坐标时，需要首尾相连成闭合多边形	38.76623,116.43213, 40.056878,116.30815, 40.465,116.314, 40.232,116.352, 40.121,116.453, 38.76623,116.43213	否
coord_type	传入的坐标类型，1（wgs84ll即GPS经纬度），2（gcj02ll即国测局经纬度坐标），3（bd09ll即百度经纬度坐标），4（bd09mc即百度米制坐标）	1、2、3(默认)、4	否
extensions_adcode	是否召回国标行政区划编码，true（召回）、false（不召回）	true、false	否
language	多语言检索，支持多种语言召回结果，参考语种列表指定输入参数和召回参数结果的语言类型，可支持的语言类型为多种语言，不填默认为中文。注意：该功能为高级付费功能，您可提交工单咨询。	en，fr	否
ret_coordtype	返回的坐标类型，可选参数，添加后POI返回国测局经纬度坐标	gcj02ll	否
output	输出数据格式，仅支持json	json	否

返回参数

返回参数			类型	备注
status			int	本次API访问状态，如果成功返回0，如果失败返回其他数字。（见服务状态码）
message			string	对API访问状态值的英文说明，如果成功返回ok，并返回结果字段，如果失败返回错误说明。
results				返回的结果
	uid		string	poi的唯一标示，ID
	name		string	poi名称，单次请求最多返回10条结果
	location		object	poi经纬度坐标
		lat	float	纬度值
		lng	float	经度值
	province		string	poi所属省份
	city		string	poi所属城市
	district		string	poi所属区县
	town		string	poi所属乡镇街道
	town_code		int	poi所属乡镇街道编码
	adcode		int	poi所属区域代码
	business		string	poi所属商圈（该字段已废弃，请您关注，会逐步下掉）
	tag		string	poi分类
	classified_poi_tag		string	POI展示分类（细致分类）
	address		string	poi所在地址
	children			poi子点
		uid	string	poi子点ID，可用于poi详情检索
		std_tag	string	poi子点分类标签
		show_name	string	poi子点简称
		location	object	poi子点坐标
		distance	int	poi子点与主点的距离（若无distance返回，则说明该子点在主点内）
		pv_rate	string	poi子点的热度（XX%选择）
		content_info	string	poi子点内容标签
		classified_poi_tag	string	poi子点详细分类标签

开始使用

多维检索

本篇文章对您是否有帮助？