当前位置：首页 > news >正文

腾讯位置服务地点搜索开发指南

news 来源：原创 2025/7/3 7:11:55

概述

提供多种搜索功能：

指定城市/区域搜索：如在北京搜索景点。新增高级参数：支持获取车站、机场、园区等较大范围地点的子点和出入口热度，辅助用户选择准确目的地。
周边搜索：如，搜索颐和园附近半径500米内的酒店（一个圆形范围）；
矩形范围搜索：在地图应用中，往往用于视野内搜索，因为显示地图的区域是个矩形。
多边形范围搜索：自定义多边形范围进行地点搜索，由此您可以更好地控制搜索范围的准确性。
周边推荐：只需提供中心点及半径（无须关键词），即可搜索获取周边高热度地点，一般用于发送位置、地点签到等场景，自动为用户提供备选地点列表
POI详情：通过POI ID查询POI信息

周边搜索

请求URL

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

请求参数

请求方式（Method）： GET

参数	必填	说明	示例
key	是	开发密钥（Key）	key=OB4BZ-D4W3U-***
keyword	是	搜索关键字，长度最大96个字节，注：keyword仅支持检索一个。（API采用UTF-8字符编码，1个英文字符占用1个字节，1个中文字符占3个字节，具体请参阅相关技术资料）	keyword=酒店，注意键值要进行URL编码（推荐encodeURI），如 keyword=%e9%85%92%e5%ba%97
boundary	是	格式： boundary=nearby(lat,lng,radius[, auto_extend]) 子参数： lat,lng：搜索中心点的经纬度，格式顺序为纬度在前，经度在后 radius：搜索半径，单位：米，取值范围：10到1000 auto_extend：[可选] 是否自动扩大范围，取值： 0 不扩大 1 [默认] 自动扩大范围（依次按照按1公里、2公里、5公里，最大到全城市范围搜索）	boundary=nearby(28.681114,115.918377,1000,1)
get_subpois	否	是否返回子地点，如大厦停车场、出入口等取值： 0 [默认]不返回 1 返回	get_subpois=1
filter	否	筛选条件 1. 指定分类筛选，语句格式为： category=分类名1,分类名2 分类词数量建议不超过5个，支持设置分类编码（支持的分类请参考：POI分类表） 2. 排除指定分类，语句格式为： category<>分类名1,分类名2 分类词数量建议不超过5个，支持设置分类编码（支持的分类请参考：POI分类表） 3. 筛选有电话的地点：tel<>null	搜索指定分类分类名：filter=category=公交车站分类编码：filter=category=271013 搜索多个分类分类名：filter=category=大学,中学分类编码：filter=category= 241000,241100 排除指定分类分类名：filter=category<>商务楼宇分类编码：filter=category<>281200 （注意参数值要进行url编码）
added_fields	否	返回指定标准附加字段，取值支持： category_code - poi分类编码	added_fields=category_code
orderby	否	排序，支持按距离由近到远排序，取值：_distance 说明： 1. 周边搜索默认排序会综合考虑距离、权重等多方面因素 2. 设置按距离排序后则仅考虑距离远近，一些低权重的地点可能因距离近排在前面，导致体验下降	orderby=_distance
page_size	否	每页条目数，最大限制为20条，默认为10条	page_size=10
page_index	否	第x页，默认第1页	page_index=2
output	否	返回格式：支持JSON/JSONP，默认JSON	output=json
callback	否	JSONP方式回调函数	callback=function1

响应结果

名称				类型	必有	说明
status				number	是	状态码，0为正常，其它为异常，详细请参阅状态码说明
message				string	是	状态说明
count				number	是	本次搜索结果总数，另外本服务限制最多返回200条数据(data)，翻页（page_index）页码超过总页数之后返回最后一页的结果。
request_id				string	是	本次请求的唯一标识，由系统自动生成，用于追查结果有异常时使用
data				array	是	搜索结果POI（地点）数组，每项为一个POI（地点）对象
	id			string	是	POI（地点）唯一标识
	title			string	是	POI（地点）名称
	address			string	是	地址
	tel			string	是	电话
	category			string	是	POI（地点）分类
	category_code			number	否	POI（地点）分类编码，设置added_fields=category_code时返回
	type			number	是	POI类型，值说明：0:普通POI / 1:公交车站 / 2:地铁站 / 3:公交线路 / 4:行政区划
	location			object	是	坐标
		lat		number	是	纬度
		lng		number	是	经度
	_distance			number	是	直线距离，单位：米，在周边搜索、城市范围搜索传入定位点时返回
	ad_info			object	是	行政区划信息
		adcode		number	是	行政区划代码，详见：行政区划代码说明
		province		string	是	省
		city		string	是	市，如果当前城市为省直辖县级区划，此字段会返回为空，由district字段返回。注：省直辖县级区划adcode第3和第4位分别为9、0，如济源市adcode为419001
		district		string	是	区
sub_pois				array	否	子地点列表，仅在输入参数get_subpois=1时返回
	parent_id			string	是	主地点ID，对应data中的地点ID
	id			string	是	地点唯一标识
	title			string	是	地点名称
	tel			string	是	电话
	category			string	是	POI（地点）分类
	type			number	是	POI类型，值说明：0:普通POI / 1:公交车站 / 2:地铁站 / 3:公交线路 / 4:行政区划
	address			string	是	地址
	location			object	是	坐标
		lat	number		是	纬度
		lng		number	是	经度
	ad_info			object	是	行政区划信息
		adcode		number	是	行政区划代码，详见：行政区划代码说明
		province		string	是	省
		city		string	是	市，如果当前城市为省直辖县级区划，此字段会返回为空，由district字段返回。注：省直辖县级区划adcode第3和第4位分别为9、0，如济源市adcode为419001
		district		string	是	区

调用示例

//GET请求示例，注意参数值要进行URL编码
//周边搜索（圆形范围）：boundary=nearby(lat,lng<中心坐标>,radius<半径/米>)
https://apis.map.qq.com/ws/place/v1/search?boundary=nearby(40.040589,116.273543,1000)&keyword=公园&page_size=10&page_index=1&key=OB4BZ-D4W3U-*****

前往示例中心在线体验 ➤

城市/区域搜索

请求URL

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

请求参数

请求方式（Method）： GET

参数	必填	说明	示例
key	是	开发密钥（Key）	key=OB4BZ-D4W3U-***
keyword	是	搜索关键字，长度最大96个字节，注：keyword仅支持检索一个。（API采用UTF-8字符编码，1个英文字符占用1个字节， 1个中文字符占3个字节，具体请参阅相关技术资料）	keyword=酒店，注意键值要进行URL编码（推荐encodeURI），如 keyword=%e9%85%92%e5%ba%97
boundary	是	格式： boundary=region(city_name [,auto_extend][,lat,lng]) 子参数： city_name：检索城市名称，如北京市，同时支持adcode（行政区划代码，可精确到区县级），如130681 auto_extend：[可选]当前范围无结果时，是否自动扩大范围，取值 0 仅在当前城市搜索； 1 [默认] 若当前城市搜索无结果，则自动扩大范围； 2 限制在当前区/县范围搜索，无结果时不自动扩大范围（仅在传入city_name为区级或区级行政区划代码时有效）。 lat,lng：[可选] 当keyword使用酒店、超市等泛分类关键词时，这类场景大多倾向于搜索附近，传入此经纬度，搜索结果会优先就近地点，体验更优。格式顺序为纬度在前，经度在后	boundary=region(北京,1,40.040493,116.273545)
get_subpois	否	是否返回子地点，如大厦停车场、出入口等取值： 0 [默认]不返回 1 返回	get_subpois=1
返回子点热度	否	支持获取车站、机场、园区等较大范围地点的子点和出入口热度，辅助用户选择准确目的地。本参数属于高级付费参数，如需试用请提交商务合作开通试用。
filter	否	筛选条件 1. 指定分类筛选，语句格式为： category=分类名1,分类名2 分类词数量建议不超过5个，支持设置分类编码（支持的分类请参考：POI分类表） 2. 排除指定分类，语句格式为： category<>分类名1,分类名2 分类词数量建议不超过5个，支持设置分类编码（支持的分类请参考：POI分类表） 3. 筛选有电话的地点：tel<>null	搜索指定分类分类名：filter=category=公交车站分类编码：filter=category=271013 搜索多个分类分类名：filter=category=大学,中学分类编码：filter=category= 241000,241100 排除指定分类分类名：filter=category<>商务楼宇分类编码：filter=category<>281200 （注意参数值要进行url编码）
added_fields	否	返回指定标准附加字段，取值支持： category_code - poi分类编码	added_fields=category_code
page_size	否	每页条目数，最大限制为20条，默认为10条	page_size=10
page_index	否	第x页，默认第1页	page_index=2
output	否	返回格式：支持JSON/JSONP，默认JSON	output=json
callback	否	JSONP方式回调函数	callback=function1

响应结果 - 正常搜索结果

名称				类型	必有	说明
status				number	是	状态码，0为正常，其它为异常，详细请参阅状态码说明
message				string	是	状态说明
count				number	是	本次搜索结果总数，另外本服务限制最多返回200条数据(data)，翻页（page_index）页码超过总页数之后返回最后一页的结果
request_id				string	是	本次请求的唯一标识，由系统自动生成，用于追查结果有异常时使用
data				array	是	搜索结果POI（地点）数组，每项为一个POI（地点）对象
	id			string	是	POI（地点）唯一标识
	title			string	是	POI（地点）名称
	address			string	是	地址
	tel			string	是	电话
	category			string	是	POI（地点）分类
	category_code			number	否	POI（地点）分类编码，设置added_fields=category_code时返回
	type			number	是	POI类型，值说明：0:普通POI / 1:公交车站 / 2:地铁站 / 3:公交线路 / 4:行政区划
	location			object	是	坐标
		lat		number	是	纬度
		lng		number	是	经度
	_distance			number	是	距离，单位：米，在周边搜索、城市范围搜索传入定位点时返回
	ad_info			object	是	行政区划信息
		adcode		number	是	行政区划代码，详见：行政区划代码说明
		province		string	是	省
		city		string	是	市，如果当前城市为省直辖县级区划，此字段会返回为空，由district字段返回。注：省直辖县级区划adcode第3和第4位分别为9、0，如济源市adcode为419001
		district		string	是	区
sub_pois				array	否	子地点列表，仅在输入参数get_subpois=1时返回
	parent_id			string	是	主地点ID，对应data中的地点ID
	id			string	是	地点唯一标识
	title			string	是	地点名称
	tel			string	是	电话
	category			string	是	POI（地点）分类
	type			number	是	POI类型，值说明：0:普通POI / 1:公交车站 / 2:地铁站 / 3:公交线路 / 4:行政区划
	address			string	是	地址
	location			object	是	坐标
		lat	number		是	纬度
		lng		number	是	经度
	ad_info			object	是	行政区划信息
		adcode		number	是	行政区划代码，详见：行政区划代码说明
		province		string	是	省
		city		string	是	市，如果当前城市为省直辖县级区划，此字段会返回为空，由district字段返回。注：省直辖县级区划adcode第3和第4位分别为9、0，如济源市adcode为419001
		district		string	是	区
lines				array	否	搜索公交线路数组，每项为一个公交路线对象
	id			string	否	公交线路唯一标识
	title			string	否	公交线路名称
	origin			object	否	当前公交线路的始发站
		title		string	否	始发站站点名称
	destination			object	否	当前公交线路的终点站
		title		string	否	终点站站点名称
region				object	是	POI数据所属地区
	title			string	是	所属地区名称

响应结果 - 按城市统计结果

当搜索范围过大，如 boundary=region(全国) 时，而且keyword的搜索结果在各城市无明显权重特别高的时，将返回各城市搜索结果数量的统计数，您可以将此统计结果展示给用户，供用户缩小城市范围，再次发起搜索使用。

名称		类型	必有	说明
status		number	是	状态码，0为正常，其它为异常，详细请参阅状态码说明
message		string	是	状态说明
count		number	是	本次搜索结果总数
request_id		string	是	本次请求的唯一标识，由系统自动生成，用于追查结果有异常时使用
data		array	是	搜索结果POI（地点）数组，每项为一个POI（地点）对象
cluster		array	是	统计结果数组
	title	string	是	城市名称
	count	number	是	根据搜索条件，在该城市搜到的结果数

调用示例：正常搜索结果

//GET请求示例，注意参数值要进行URL编码
//指定地区名称，不自动扩大范围：boundary=region(北京,0)
https://apis.map.qq.com/ws/place/v1/search?boundary=region(北京,0)&keyword=颐和园&page_size=20&page_index=1&key=OB4BZ-D4W3U-*****

前往示例中心在线体验 ➤

调用示例：按城市统计结果

//GET请求示例，注意参数值要进行URL编码
https://apis.map.qq.com/ws/place/v1/search?boundary=region(全国)&keyword=博物馆&key=OB4BZ-D4W3U-*****

前往示例中心在线体验 ➤

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

请求URL

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

请求参数

请求方式（Method）： GET

参数	必填	说明	示例
key	是	开发密钥（Key）	key=OB4BZ-D4W3U-***
keyword	是	搜索关键字，长度最大96个字节，注：keyword仅支持检索一个。（API采用UTF-8字符编码，1个英文字符占用1个字节， 1个中文字符占3个字节，具体请参阅相关技术资料）	keyword=酒店，注意键值要进行URL编码（推荐encodeURI），如 keyword=%e9%85%92%e5%ba%97
boundary	是	格式： boundary=rectangle(lat,lng,lat,lng) 子参数：由矩形左下角（西南）和右上角（东北）两对经纬度组成，格式顺序为纬度在前，经度在后	boundary=rectangle(40.037961,116.267921,40.051036,116.284873)
filter	否	筛选条件 1. 指定分类筛选，语句格式为： category=分类名1,分类名2 分类词数量建议不超过5个，支持设置分类编码（支持的分类请参考：POI分类表） 2. 排除指定分类，语句格式为： category<>分类名1,分类名2 分类词数量建议不超过5个，支持设置分类编码（支持的分类请参考：POI分类表） 3. 筛选有电话的地点：tel<>null	搜索指定分类分类名：filter=category=公交车站分类编码：filter=category=271013 搜索多个分类分类名：filter=category=大学,中学分类编码：filter=category= 241000,241100 排除指定分类分类名：filter=category<>商务楼宇分类编码：filter=category<>281200 （注意参数值要进行url编码）
added_fields	否	返回指定标准附加字段，取值支持： category_code - poi分类编码	added_fields=category_code
page_size	否	每页条目数，最大限制为20条，默认为10条	page_size=10
page_index	否	第x页，默认第1页	page_index=2
output	否	返回格式：支持JSON/JSONP，默认JSON	output=json
callback	否	JSONP方式回调函数	callback=function1

响应结果

名称			类型	必有	说明
status			number	是	状态码，0为正常，其它为异常，详细请参阅状态码说明
message			string	是	状态说明
count			number	是	本次搜索结果总数，另外本服务限制最多返回200条数据(data)，翻页（page_index）页码超过总页数之后返回最后一页的结果。
request_id			string	是	本次请求的唯一标识，由系统自动生成，用于追查结果有异常时使用
data			array	是	搜索结果POI（地点）数组，每项为一个POI（地点）对象
	id		string	是	POI（地点）唯一标识
	title		string	是	POI（地点）名称
	address		string	是	地址
	tel		string	是	电话
	category		string	是	POI（地点）分类
	category_code		number	否	POI（地点）分类编码，设置added_fields=category_code时返回
	type		number	是	POI类型，值说明：0:普通POI / 1:公交车站 / 2:地铁站 / 3:公交线路 / 4:行政区划
	location		object	是	坐标
		lat	number	是	纬度
		lng	number	是	经度
	ad_info		object	是	行政区划信息
		adcode	number	是	行政区划代码，详见：行政区划代码说明
		province	string	是	省
		city	string	是	市，如果当前城市为省直辖县级区划，此字段会返回为空，由district字段返回。注：省直辖县级区划adcode第3和第4位分别为9、0，如济源市adcode为419001
		district	string	是	区

调用示例

//GET请求示例，注意参数值要进行URL编码
//矩形区域范围：boundary=rectangle(lat,lng<左下/西南>, lat,lng<右上/东北>)
https://apis.map.qq.com/ws/place/v1/search?boundary=rectangle(39.907293,116.368935,39.914996,116.379321)&keyword=美食&page_size=10&page_index=1&key=OB4BZ-D4W3U-*****

前往示例中心在线体验 ➤

多边形范围搜索

本接口提供基于多边形范围的地点搜索能力。

请求URL

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

请求参数

请求方式（Method）： GET

参数	必填	说明	示例
key	是	开发key：您可在控制台Key管理界面自行创建，且需要开启WebServiceAPI功能	key=OB4BZ-D4W3U-***
polygon	是	多边形区域： 1. 格式为lat,lng;lat,lng… 2. 支持凸多边形及凹多边形，多边形不可自相交 4. 面积<30平方公里 5. 目前多边形不支持支持跨城市	polygon=39.932512,116.355515;39.933697,116.434650;39.913291,116.435509;39.913555,116.356201
keyword	是	搜索关键字，长度最大96个字节，注：keyword仅支持检索一个。 API采用UTF-8字符编码，1个英文字符占用1个字节，1个中文字符占3个字节，具体请参阅相关技术资料）	keyword=美食
filter	否	筛选条件 1. 指定分类筛选，语句格式为：category=分类名1,分类名2 分类词数量建议不超过5个，支持设置分类编码（支持的分类请参考：POI分类表） 2. 排除指定分类，语句格式为：category<>分类名1,分类名2分类词数量建议不超过5个，支持设置分类编码（支持的分类请参考：POI分类表）	搜索指定分类filter=category=公交站搜索多个分类filter=category=大学,中学排除指定分类 filter=category<>商务楼宇注意参数值要进行url编码）
get_subpois	否	是否返回子地点，如大厦停车场、出入口等取值： 0 [默认]不返回 1 返回	get_subpois=1
page_size	否	每页条目数，最大限制为20条，默认为10条	page_size=10
page_index	否	页码，默认第1页	page_index=1
output	否	返回值类型：json、jsonp	output=jsonp
callback	否	回调函数	callback=cb

响应结果

名称				类型	必有	说明
status				number	是	状态码，0为正常，其它为异常，详细请参阅状态码说明
message				string	是	状态说明
count				number	是	本次搜索结果总数，另外本服务限制最多返回200条数据(data)，翻页（page_index）页码超过总页数之后返回最后一页的结果。
request_id				string	是	本次请求的唯一标识，由系统自动生成，用于追查结果有异常时使用
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:行政区划
	location			object	是	坐标
		lat		number	是	纬度
		lng		number	是	经度
	_distance			number	是	距离，单位：米，在周边搜索、城市范围搜索传入定位点时返回
	ad_info			object	是	行政区划信息
		adcode		number	是	行政区划代码，详见：行政区划代码说明
		province		string	是	省
		city		string	是	市，如果当前城市为省直辖县级区划，此字段会返回为空，由district字段返回。注：省直辖县级区划adcode第3和第4位分别为9、0，如济源市adcode为419001
		district		string	是	区
sub_pois				array	否	子地点列表，仅在输入参数get_subpois=1时返回
	parent_id			string	是	主地点ID，对应data中的地点ID
	id			string	是	地点唯一标识
	title			string	是	地点名称
	tel			string	是	电话
	category			string	是	POI（地点）分类
	type			number	是	POI类型，值说明：0:普通POI / 1:公交车站 / 2:地铁站 / 3:公交线路 / 4:行政区划
	address			string	是	地址
	location			object	是	坐标
		lat	number		是	纬度
		lng		number	是	经度
	ad_info			object	是	行政区划信息
		adcode		number	是	行政区划代码，详见：行政区划代码说明
		province		string	是	省
		city		string	是	市，如果当前城市为省直辖县级区划，此字段会返回为空，由district字段返回。注：省直辖县级区划adcode第3和第4位分别为9、0，如济源市adcode为419001
		district		string	是	区

调用示例

//GET请求示例，注意参数值要进行URL编码
https://apis.map.qq.com/ws/place/v1/search_by_polygon?polygon=39.932512,116.355515;39.933697,116.434650;39.913291,116.435509;39.913555,116.356201&keyword=公园&key=OB4BZ-D4W3U-*****

前往示例中心在线体验 ➤

周边推荐（explore）

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

请求URL

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

请求参数

请求方式（Method）： GET

参数	必填	说明	示例
key	是	开发密钥（Key）	key=OB4BZ-D4W3U-***
boundary	是	格式： boundary=nearby(lat,lng,radius[, auto_extend]) 子参数： lat,lng：搜索中心点的经纬度，纬度在前，经度在后 radius：搜索半径，单位：米，取值范围：200到1000 auto_extend：[可选] 当前范围无结果时，是否自动扩大范围，取值： 0 不扩大 1 [默认] 自动扩大范围（依次按照按1公里、2公里、5公里，最大到全城市范围搜索）	boundary=nearby(28.681114,115.918377,1000,1)
policy	否	搜索策略，可选值： 1 [默认]地点签到场景，针对用户签到的热门地点进行优先排序。 2 位置共享场景，用于发送位置、位置分享等场景的热门地点优先排序	policy=1
filter	否	筛选条件，支持指定分类筛选，语句格式为： category=分类名1,分类名2 分类词数量建议不超过5个（支持的分类请参考：POI分类表）	搜索指定分类 filter=category=公交车站分类编码：filter=category=271013 搜索多个分类 filter=category=大学,中学分类编码：filter=category= 241000,241100 （注意参数值要进行url编码）
orderby	否	排序，支持按距离由近到远排序，取值：_distance 说明：周边搜索默认排序会综合考虑距离、权重等多方面因素，而设置按距离排序后则仅考虑距离远近，一些低权重的地点可能因距离近排在前面	orderby=_distance
address_format	否	地址格式，可选值：short，返回不包含省市区的短地址（缺省则为包含省市区的标准地址）	address_format=short
page_size	否	每页条目数，最大限制为20条，默认为10条	page_size=10
page_index	否	第x页，默认第1页	page_index=2
output	否	返回格式：支持JSON/JSONP，默认JSON	output=json
callback	否	JSONP方式回调函数	callback=function1

响应结果

名称			类型	必有	说明
status			number	是	状态码，0为正常，其它为异常，详细请参阅状态码说明
message			string	是	状态说明
count			number	是	本次搜索结果总数，另外本服务限制最多返回200条数据(data)，翻页（page_index）超过搜索结果总数或最大200条限制时，将返回最后一页数据。
request_id			string	是	本次请求的唯一标识，由系统自动生成，用于追查结果有异常时使用
data			array	是	搜索结果POI（地点）数组，每项为一个POI（地点）对象
	id		string	是	POI（地点）唯一标识
	title		string	是	POI（地点）名称
	address		string	是	地址
	category		string	是	POI（地点）分类
	location		object	是	坐标
		lat	number	是	纬度
		lng	number	是	经度
	_distance		number	是	与boundary传入的经纬度的直线距离，单位：米
	ad_info		object	是	行政区划信息
		adcode	number	是	行政区划代码，详见：行政区划代码说明
		province	string	是	省
		city	string	是	市，如果当前城市为省直辖县级区划，city与district字段均会返回此城市注：省直辖县级区划adcode第3和第4位分别为9、0，如济源市adcode为419001
		district	string	是	区

调用示例

//GET请求
//周边推荐：boundary=nearby(lat,lng<中心坐标>,radius<半径/米>)
https://apis.map.qq.com/ws/place/v1/explore?boundary=nearby(40.040394,116.273523,1000)&policy=1&page_size=10&page_index=1&key=OB4BZ-D4W3U-*****

前往示例中心在线体验 ➤

周边推荐（here）

与explore相似，只需提供搜索中心点及半径（无须关键词），即可搜索获取周边高热度地点，

但本接口侧重于以地标+主要的路+近距离POI为主，着力描述当前位置，同时提供到家场景（如创建收货地址）、出行场景的地点推荐。

本服务属于高级服务，如需接入请在官网工单系统提交工单申请开通调用权限。

请求URL

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

请求参数

请求方式（Method）： GET

参数	必填	说明	示例
key	是	开发密钥（Key）	key=OB4BZ-D4W3U-***
boundary	是	格式： boundary=nearby(lat,lng,radius[, auto_extend]) 子参数： lat,lng：搜索中心点的经纬度，纬度在前，经度在后 radius：搜索半径，单位：米，取值范围：10到1000	boundary=nearby(28.681114,115.918377,1000)
policy	否	搜索策略： policy=1[默认] 以地标+主要的路+近距离POI为主，着力描述当前位置； policy=2 到家场景：筛选合适收货的POI，并会细化收货地址，精确到楼栋； policy=3 出行场景：过滤掉车辆不易到达的POI(如一些景区内POI)，增加道路出入口、交叉口、大区域出入口类POI，排序会根据真实API大用户的用户点击自动优化。	policy=1
filter	否	筛选条件，支持指定分类筛选，语句格式为： category=分类名1,分类名2 分类词数量建议不超过5个（支持的分类请参考：POI分类表）	搜索指定分类 filter=category=公交站搜索多个分类 filter=category=美食,购物
address_format	否	地址格式，可选值：short，返回不包含省市区的短地址（缺省则为包含省市区的标准地址）	address_format=short
output	否	返回格式：支持JSON/JSONP，默认JSON	output=json
callback	否	JSONP方式回调函数	callback=function1

响应结果

名称			类型	必有	说明
status			number	是	状态码，0为正常，其它为异常，详细请参阅状态码说明
message			string	是	状态说明
count			number	是	本次搜索结果总数，另外本服务限制最多返回10条数据(data)
request_id			string	是	本次请求的唯一标识，由系统自动生成，用于追查结果有异常时使用
data			array	是	搜索结果POI（地点）数组，每项为一个POI（地点）对象
	id		string	是	POI（地点）唯一标识
	title		string	是	POI（地点）名称
	address		string	是	地址
	category		string	是	POI（地点）分类
	location		object	是	坐标
		lat	number	是	纬度
		lng	number	是	经度
	_distance		number	是	与boundary传入的经纬度的直线距离，单位：米
	ad_info		object	是	行政区划信息
		adcode	number	是	行政区划代码，详见：行政区划代码说明
		province	string	是	省
		city	string	是	市，如果当前城市为省直辖县级区划，city与district字段均会返回此城市注：省直辖县级区划adcode第3和第4位分别为9、0，如济源市adcode为419001
		district	string	是	区

调用示例

//GET请求
//周边推荐：boundary=nearby(lat,lng<中心坐标>,radius<半径/米>)
https://apis.map.qq.com/ws/place/v1/here?boundary=nearby(40.040394,116.273523,1000)&policy=1&page_size=10&page_index=1&key=OB4BZ-D4W3U-*****

前往示例中心在线体验 ➤

POI详情

提供通过POI ID查询其基础详情信息的能力。

请求URL

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

请求参数

请求方式（Method）： GET

参数	必填	说明	示例
key	是	开发密钥（Key）	key=OB4BZ-D4W3U-*****
id	是	腾讯地图POI（地点）唯一标识，支持多poiid检索，最大支持10个，用英文逗号分隔	id=6621879543162709731
output	否	返回格式：支持JSON/JSONP，默认JSON	output=json
callback	否	JSONP方式回调函数	callback=function1

响应结果

名称			类型	必有	说明
status			number	是	状态码，0为正常，其它为异常，详细请参阅状态码说明
message			string	是	状态说明
count			number	是	本次搜索结果总数
request_id			string	是	本次请求的唯一标识，由系统自动生成，用于追查结果有异常时使用
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:行政区划
	location		object	是	坐标
		lat	number	是	纬度
		lng	number	是	经度
	ad_info		object	是	行政区划信息
		adcode	number	是	行政区划代码，详见：行政区划代码说明
		province	string	是	省
		city	string	是	市，如果当前城市为省直辖县级区划，此字段会返回为空，由district字段返回。注：省直辖县级区划adcode第3和第4位分别为9、0，如济源市adcode为419001
		district	string	是	区/县，当type（POI类型）为3（公交线路）时，district由city补全

调用示例

//GET请求
//查询ID为6621879543162709731的地点信息
https://apis.map.qq.com/ws/place/v1/detail?id=6621879543162709731&key=OB4BZ-D4W3U-*****

腾讯位置服务地点搜索开发指南

概述提供多种搜索功能： 指定城市/区域搜索：如在北京搜索景点。新增高级参数：支持获取车站、机场、园区等较大范围地点的子点和出入口热度，辅助用户选择准确目的地。周边搜索：如，搜索颐和园附近半径500米内…...

编程日记 2025/7/3 7:11:55

101个α因子#12

(sign(delta(volume, 1)) * (-1 * delta(close, 1)))worldquant brain平台上调整后的语法： (sign(ts_delta(volume, 1)) * (-1 * ts_delta(close, 1)))这个alpha因子的逻辑可以分为以下几个步骤： 1. 计算成交量的变化方向：sign(ts_delta(vol…...

编程日记 2025/6/27 23:29:06

opencv_version_win32

很多人发了opencv的编译方法，很少见到启动和关闭了那些模块，现在发个WIN64 opencv编译后的信息。执行opencv_version_win32.exe 因为显卡较老 2060 super, NVIDIA GPU arch: 75 80 86 87 89 90。至于更高的反本没有显卡因此不知道。 BLAS库使用效率较高…...

编程日记 2025/7/1 4:39:04

Flask 路由装饰器：从 URL 到视图函数的优雅映射

前置知识，关于Python装饰器的语法，链接：Python 装饰器：从“语法糖”到“代码神器”的深度解析 1、路由装饰器的功能：给 URL 贴 “功能标签” 在 Flask 开发中，你一定见过这样的代码： from fla…...

编程日记 2025/7/1 16:00:25

动态规划3、悟到核心

题目引入： #include <iostream> #include <queue> #include <vector> #include <tuple> #include <algorithm> #include <cstring> using namespace std;// dp[i]考虑前i家店能收获的最大价值 // 面对第i家店铺，你可…...

编程日记 2025/6/27 5:28:49

VLM-MPC：自动驾驶中模型预测控制器增强视觉-语言模型

《VLM-MPC: Model Predictive Controller Augmented Vision Language Model for Autonomous Driving》2024年8月发表，来自威斯康星大学的论文。受视觉语言模型（VLM）的紧急推理能力及其提高自动驾驶系统可理解性的潜力的启发，本文…...

编程日记 2025/6/27 23:12:24

HTTP/HTTPS 协议浅解

文章目录一、HTTP 协议（一）定义（二）特点（三）应用场景（四）优势（五）劣势二、HTTPS 协议（一）定义（二）特点&…...

编程日记 2025/7/1 18:46:42

Ajax快速入门教程

输入java时，页面并没有刷新但是下面自动联想出了跟java有关的东西，像这种就叫异步交互它不会妨碍你的输入，同时还能够同步进行对于java相关联想词的推送发送异步请求需要借助工具axios 引入axios，可以直接在scripts中引入 get和…...

编程日记 2025/6/27 23:18:44

如何在Java中处理PDF文档（教程）

在开发文档管理系统、自动化工具或商业应用程序时，Java开发者常需处理PDF文档的编辑需求。无论是添加页面、调整内容尺寸、插入水印还是添加注释，选择一套可靠易用的Java PDF开发工具包至关重要。 JPedal（Java PDF开发工具包）的新…...

编程日记 2025/6/27 23:01:15

springcloud集成seata报错Error creating bean with name ‘globalTransactionScanner‘

1. pom文件引入依赖 <dependency><groupId>com.alibaba.cloud</groupId><artifactId>spring-cloud-starter-alibaba-seata</artifactId></dependency> 2. 报错 3. 在启动配置中添加一行配置: --add-opensjava.base/j…...

编程日记 2025/6/27 22:54:37

使用 OpenCV 实现哈哈镜效果：让图像“扭曲起来”！

在计算机视觉和图像处理领域，OpenCV 提供了非常强大的图像几何变换能力，不仅可以用于纠正图像，还能制造各种“有趣”的视觉效果。今天，我们就来实现一个经典的“哈哈镜”效果，让图像像在游乐园里一样被拉伸、压缩、扭曲…...

编程日记 2025/7/2 1:23:37

pikachu靶场暴力破解

学习中参考的博客如下 pikachu靶场暴力破解专题-CSDN博客 1，基于表单的暴力破解出现了一个登录页面解题步骤：抓包，发到bp里，右键发到Intruder，因为有两个位置要爆破，所以选择集群炸弹攻击&#xff…...

编程日记 2025/6/30 16:42:25

鸿蒙开发：应用上架第三篇，配置签名信息打出上架包

前言本文基于Api13 经过前面两篇文章，我们获取到了密钥和证书请求文件以及最终的发布证书和发布证书Profile文件，可以说，所有的签名信息文件，我们都已经完成了，正所谓，万事俱备只欠东风，这篇文…...

编程日记 2025/6/27 23:39:55

基于R语言的贝叶斯网络模型实践技术应用：开启科研新视角

在现代科研领域，变量间的因果关系推断是生态学、环境科学、医学等多学科研究的核心问题。然而，传统的统计学方法往往只能揭示变量间的相关关系，而非因果关系。贝叶斯网络作为一种结合图论与统计学理论的新型模型，不仅能够统合多种…...

编程日记 2025/7/1 15:58:33

第五章 GPT模块配置

由于GPT配置需要和Irq和Mcu进行配合设置（GPT可以由芯片外设中的GTM和GPT12实现，这次是以GTM为实现）。 1 GTM外设时钟配置首先需要对MCU组件进行配置，配置GTM的时钟,需要参照GTM的CMU时钟树。下图时钟树的CLS0_CLK为MCU(McuClockSettingConfig_0中的 McuSTMFrequency )f…...

编程日记 2025/7/2 12:35:50

虚拟机NAT模式获取不到ip

虚拟机NAT模式获取不到ip 如图所示解决方案： 先查看NetworkManager是否启动 systemctl status NetworkManager如果没启动就启动一遍使用DHCP手动获取一遍ip sudo dhclient ens33成功得到ip 这是后遇到了另一个问题，ip释放后，不能自动…...

编程日记 2025/7/3 11:05:28

Docker的网络介绍

网络简单介绍在介绍 Docker 的网络模式之前，先简单说下我们在使用 Vmware 虚拟机中的网络模式，形成对比，更好理解。 1、Vmware 中的网络模式 1.1、VMnet0（桥接模式） 虚拟机通过宿主机的物理网卡直接连接到外部网络…...

编程日记 2025/7/3 11:05:49

Nginx负载均衡配置详解

在Nginx中配置负载均衡主要通过 upstream 模块实现，结合反向代理将请求分发到多个后端服务器。以下是详细配置步骤和案例解析：一、基础配置 1. 配置语法 http {upstream backend_servers {# 负载均衡策略server backend1.example.com;server backend2.example.com;server …...

编程日记 2025/7/3 15:30:57

关于 Web 漏洞原理与利用：4. 文件上传漏洞

定义：文件上传漏洞是指应用程序允许用户上传文件，但没有严格校验上传文件的类型、内容、路径等属性，导致攻击者可以上传并执行恶意代码。绕过方式： 前端绕过 1. 前端限制的原理前端限制上传文件类型的常见方式有三种&#xf…...

编程日记 2025/6/27 23:37:45

(6)python爬虫--selenium

文章目录前言一、初识selenium二、安装selenium2.1 查看chrome版本并禁止chrome自动更新2.1.1 查看chrome版本2.1.2 禁止chrome更新自动更新 2.2 安装对应版本的驱动程序2.3安装selenium包三、selenium关于浏览器的使用3.1 创建浏览器、设置、打开3.2 打开/关闭网页及浏览器3…...

编程日记 2025/6/27 23:18:40

MCU 上电不启动的常见原因分析与排查思路

在开发过程中，“MCU 上电不运行”是我们经常遇到的问题之一。但客户对此类问题的描述往往较为模糊，仅简单表示“产品不工作”或“怀疑 MCU 没有运行”，这给我们现场排查带来了较大的挑战。即便工程师到达现场，往往也无法迅速定位问…...

编程日记 2025/6/29 8:43:20

Spark Core 源码关键环节的深度解析

以下是对 Spark Core 源码关键环节的深度解析，包括核心组件启动与调度机制、Shuffle与调度系统、RDD高级机制。每个环节都细化到具体方法、逻辑、源码片段，附有流程图思路与速记口诀，便于记忆和理解。一、核心组件启动与调度机制 1. RpcEnv…...

编程日记 2025/7/3 19:54:05

net Core》》包与库 LibMan、NPM

LibMan 资料 NPM 资料在 Visual Studio 中使用 npm package.json 保存之后 vs会自动下载的。注意：如果您没有看到 node_modules 文件夹，请确保在 Visual Studio 解决方案资源管理器中启用了“显示所有文件”选项要卸载该库，您只需从 …...

编程日记 2025/6/27 23:21:35

数学建模，机器决策人建模

目录数学建模微分方程动态系统建模时间序列分析概述指数衰减随机漂移总结曲线拟合最优化方法梯度下降法概率建模（如贝叶斯建模、马尔可夫过程、MDP/POMDP） 等贝叶斯建模贝叶斯定理优势马尔可夫过程马尔可夫过程的分类…...

编程日记 2025/6/26 23:20:56

FFmpeg中使用Android Content协议打开文件设备

引言随着Android 10引入的Scoped Storage（分区存储）机制，传统的文件访问方式发生了重大变化。FFmpeg作为强大的多媒体处理工具，也在不断适应Android平台的演进。本文将介绍如何在FFmpeg 7.0版本中使用Android content协议直接访…...

编程日记 2025/7/2 12:16:19

SQL查询, 响应体临时字段报: Unknown column ‘data_json_map‘ in ‘field list‘

Overridepublic AjaxResult list(AgentPageReqVO pageReqVO, Integer pageNo, Integer pageSize) {// 1. 查询数据库获取代理列表List<AgentDO> list agentMapper.selectPage(pageReqVO).getList();// 如果结果为空，直接返回空分页结果if (CollectionUtils.i…...

编程日记 2025/7/1 4:14:57

OpenCv高阶（十四）——LBPH人脸识别

文章目录前言一、LBPH原理1. LBP（局部二值模式）特征提取2. 图像分块处理3. 生成直方图4. 人脸识别（匹配阶段）5. LBPH的特点6. 变种与优化二、LBPH人脸识别简单实现（一）LBPH人脸识别1、图像读取&#xff0…...

编程日记 2025/7/3 4:43:56

C#开发利器：SharpBoxesCore全解析

SharpBoxesCore 是一个基于 C# 的开源开发工具库，旨在为开发者提供一系列常用功能模块和辅助类，以提高开发效率、减少重复代码编写，并增强项目的可维护性和扩展性。该库集成了多种实用工具类和通用扩展方法，适用于桌面应用、Web 项…...

编程日记 2025/7/2 5:02:08

回表是数据库概念，还是mysql的概念？

主键索引没有列，根据耳机索引去查主键索引，又没有查表，为啥叫回表呢？ “回表”这个词，其实算是数据库里的一个通用概念，不过它最常见的应用场景是在 MySQL 的 InnoDB 引擎里，所以很多人一提起回…...

编程日记 2025/7/1 4:21:08

49、c# 能⽤foreach 遍历访问的对象需满足什么条件？

在 C# 中，要使用 foreach 循环遍历一个对象，该对象必须满足以下条件之一： 1. 实现 IEnumerable 或 IEnumerable 接口非泛型版本：System.Collections.IEnumerable public class MyCollection : IEnumerable {private int[] _da…...

编程日记 2025/6/30 6:34:33

DL00987-基于深度学习YOLOv11的红外鸟类目标检测含完整数据集

提升科研能力，精准识别红外鸟类目标！ 完整代码数据集见文末针对科研人员，尤其是研究生们，是否在鸟类目标检测中遇到过数据不够精准、处理困难等问题？现在，我们为你提供一款基于深度学习YOLOv11的红外鸟类…...

编程日记 2025/7/1 20:13:09

07 接口自动化-用例管理框架之pytest单元测试框架

文章目录一、pytest用例管理框架（单元测试框架）二、pytest简介三、pytest的最基本的测试用例的规则四、运行方式1.主函数方式2.命令行方式3.通过pytest.ini的配置文件运行五、pytest 默认执行测试用例的顺序六、跳过测试用例1.无条件跳过 pytest.mark.…...

编程日记 2025/6/27 23:01:16

Flutter 中 build 方法为何写在 StatefulWidget 的 State 类中

Flutter 中 build 方法为何写在 StatefulWidget 的 State 类中在 Flutter 中，build 方法被设计在 StatefulWidget 的 State 类中而非 StatefulWidget 类本身，这种设计基于几个重要的架构原则和实际考量： 1. 核心设计原因 1.1 生命周期管理…...

编程日记 2025/7/2 1:39:57

多技术栈 iOS 项目的性能调试实战：从 Flutter 到 Unity（含 KeyMob 工具实测）

多技术栈 iOS 项目的性能调试实战：从 Flutter 到 Unity 随着移动端开发日趋多元化，iOS 项目中纯 Objective-C/Swift 已不再是唯一选择。越来越多团队采用 Flutter、React Native、Unity、WebView 混合等方案构建 App。这种“技术栈混合”带来灵活性的同…...

编程日记 2025/7/1 14:57:04

Base64加密解密

Base64 是一种基于 64 个可打印字符来表示二进制数据的编码方式，常用于需要通过文本协议传输二进制数据的场景（如 URL、邮件）。以下是不同场景下生成 Base64 编码的方法： 一、编程语言实现 Python import base64# 字符串转Base…...

编程日记 2025/6/27 23:13:53

程序设计基础----排序（2）

1、冒泡排序 #include <stdio.h>#define N 1000 int arr[N];/* 对长度为n的数组arr执行冒泡排序 */ void bubbleSort(int arr[], int n);/* 打印长度为n的数组arr */ void printArray(int arr[], int n);void swap(int *xp, int *yp) {int temp *xp;*xp *yp;*yp temp…...

编程日记 2025/7/3 1:18:54

C++：vector容器

vector容器与array容器相似，但vector容器是动态的，可以自动扩容。使用方法和一些注意如下： #include<iostream> #include<vector> using namespace std;int main() {vector<char> vec { a,b,c,d };vec[4] e;//不能以此…...

编程日记 2025/6/30 4:57:22