概述

提供多种搜索接口、多种搜索功能，适用于不同场景，包括：

1. 周边搜索（关键参数：boundary=nearby）：如，搜索某地方附近半径500米内的酒店（一个圆形范围）；

2. 矩形范围搜索（关键参数：boundary=rectangle）：在地图应用中，往往用于视野内搜索，因为显示地图的区域是个矩形。

3. 周边推荐（/ws/place/v1/explore）：只需提供中心点及半径（无须关键词），即可搜索获取周边高热度地点，一般用于发送位置、地点签到等场景，自动为用户提供备选地点列表。

周边搜索

请求URL

https://apis.map.qq.com/ws/place/v1/search

请求参数

请求方式（Method）： GET

参数	必填	说明	示例
key	是	开发密钥（Key）	key=OB4BZ-D4W3U-B7VVO-XXXXX
keyword	是	搜索关键词	罗森熊本阿苏长阳店
boundary	是	圆形范围：boundary=nearby(lat,lng<中心坐标>,radius<半径/米>)	boundary=nearby(32.902304,130.990217,1000)
page_index	否	页码，默认第1页	page_index=2
page_size	否	每页数据量，默认10条	page_size=20
language	是	返回结果的语言： cn [默认]中文 local 当地语言	language=cn
output	否	返回格式：支持JSON/JSONP，默认JSON	output=json
callback	否	JSONP方式回调函数	callback=function1

注：日本以外中文支持并不完整，部分字段有中文翻译，如果需要体验一致性推荐使用英文

响应结果

名称			类型	必有	说明
status			number	是	状态码，0为正常
message			string	是	状态说明
count			number	是	本次搜索结果总数
data			array	是	搜索结果POI数组，每项为一个POI对象
	id		string	是	POI唯一标识
	title		string	是	poi名称
	address		string	是	地址
	tel		string	是	电话
	category		string	是	POI（地点）分类
	location		object	是	坐标
		lat	number	是	纬度
		lng	number	是	经度
	_distance		number	是	距离，单位：米

调用示例

//GET请求示例，注意参数值要进行URL编码
https://apis.map.qq.com/ws/place/v1/search?key=API_KEY&keyword=bar&boundary=nearby(40.729999,-74.001422,1000)

矩形范围(屏幕视野内)搜索

请求URL

https://apis.map.qq.com/ws/place/v1/search

请求参数

请求方式（Method）： GET

参数	必填	说明	示列
key	是	开发密钥（Key）	key=OB4BZ-D4W3U-XXXXX
keyword	是	搜索关键词	罗森熊本阿苏长阳店
boundary	是	矩形范围 ：boundary=rectangle(lat,lng<左下/西南>, lat,lng<右上/东北>)	boundary=rectangle(32.90,130.9902,32.902308,131.9903)
page_index	否	页码，默认第1页	page_index=2
page_size	否	每页数据量，默认10条	page_size=20
language	是	返回结果的语言： cn [默认]中文 local 当地语言 支持的语言列表详见附录	Language=cn
output	否	返回格式：支持JSON/JSONP，默认JSON	Output=json
callback	否	JSONP方式回调函数	callback=function1

注：日本以外中文支持并不完整，部分字段有中文翻译，如果需要体验一致性推荐使用英文

响应结果

名称					类型	必有	说明
status					number	是	状态码，0为正常
message					string	是	状态说明
count					number	是	本次搜索结果总数
data					array	是	搜索结果POI（地点）数组，每项为一个POI（地点）对象
	id				string	是	POI（地点）唯一标识
	title				string	是	POI（地点）名称
	address				string	是	地址
	tel				string	是	电话
	category				string	是	POI（地点）分类
	type				number	是	POI类型，值说明：0:普通POI / 1:公交车站 / 2:地铁站 / 3:公交线路 / 4:行政区划 只有日本地区有Type
	location				object	是	坐标
		lat			number	是	纬度
		lng			number	是	经度
	region				object	是	行政区划
		title			string	是	国家

调用示例

//GET请求示例，注意参数值要进行URL编码
https://apis.map.qq.com/ws/place/v1/search?keyword=market&boundary=rectangle(28.553164,-81.364145,28.567788,-81.333332)&key=API_KEY

周边地点推荐

只需提供搜索中心点及半径（无须关键词），即可搜索获取周边高热度地点，
一般用于发送位置、门店签到等场景，自动为用户提供备选地点列表

请求URL

https://apis.map.qq.com/ws/place/v1/explore

请求参数

请求方式（Method）： GET

参数	必填	说明	示列
key	是	开发密钥（Key）	key=OB4BZ-D4W3U-XXXXX
boundary	是	圆形范围 ：boundary=nearby(lat,lng<中心坐标>,radius<半径/米>)	boundary=nearby(34.524661,-78.969727,1000)
page_index	否	页码，默认第1页	page_index=2
page_size	否	每页数据量，默认10条	page_size=20
language	是	返回结果的语言： cn [默认]中文 local 当地语言 支持的语言列表详见附录	language=cn
output	否	返回格式：支持JSON/JSONP，默认JSON	output=json
callback	否	JSONP方式回调函数	callback=function1

响应结果

名称					类型	必有	说明
status					number	是	状态码，0为正常
message					string	是	状态说明
count					number	是	本次搜索结果总数
data					array	是	搜索结果POI（地点）数组，每项为一个POI（地点）对象
	id				string	是	POI（地点）唯一标识
	title				string	是	POI（地点）名称
	address				string	是	地址
	tel				string	是	电话
	category				string	是	POI分类
	location				object	是	坐标
		lat			number	是	纬度
		lng			number	是	经度
	_distance				number	是	距离，单位： 米

调用示例

//GET请求
//周边推荐：日本地区
https://apis.map.qq.com/ws/place/v1/explore?boundary=nearby(32.902304,130.990217,1000)&key=API_KEY