正在跳转至目标页,请稍后…

概述

通过本服务,可将第三方POI数据,通过名称、地址、经纬度等信息,关联到腾讯位置服务的POI,获取腾讯位置服务POI ID。



本服务属于高级付费服务,如需试用请提交商务合作开通服务试用。

请求URL

该请求为GET请求

https://apis.map.qq.com/ws/poi_association/v1
Method:GET

请求参数

属性 类型 必填 说明 示例
key string 开发者调用服务的身份标识 ,可在控制台Key管理界面自行创建,且需要开启WebServiceAPI功能 key=OB4BZ-D4W3U-*****
title string 名称 &title=黄河壶口瀑布
address string 地址(address和location至少存在一个) &address=陕西省延安市宜川县壶口乡
location string 经纬度坐标,格式:
纬度在前,经度在后,英文逗号分隔 (address和location至少存在一个)
location=36.147412,110.443325
region string 城市名 region=延安市
category string 地图POI分类编名
(2022-07-22新增)
category_code=美食:其它美食
category_code string 地图POI分类编码
(2022-07-22新增)
category_code=801010

响应结果

属性 类型 必有 说明
status number 状态码,0为正常, 其它为异常(可关注message信息)
message string 状态说明
result object 响应结果对象
- data array 关联结果,目前仅支持返回1个数组对象,无结果时返回空数组[]
- - poi_id string 关联成功的POI ID
- - title string 关联到的POI名称
- - address string 地址
- - category string 分类,标准参见:《腾讯地图POI分类关键词》如:“教育学校:大学”
- - location object 经纬度坐标,坐标系为:GCJ-02
- - - lat number 纬度
- - - lng number 经度
- - invalid_status number 关联到的腾讯地图POI是否失效:0:有效,该POI在腾讯地图中为上线状态,可被展示与搜索。-1:失效:包括运营确认已经关闭(如关店不再经营),以及通过各类数据来源判断其不足以达到有效的标准,腾讯地图中不会被展示与搜索到。
- - reliability number 关联结果可信度(预留),目前该字段暂未生效,可忽略

调用示例

// GET请求,注意参数值要进行URL编码
https://apis.map.qq.com/ws/poi_association/v1?&location=39.99287,116.31025&title=北京大学&key=OB4BZ-D4W3U-*****

//响应示例:
{
	"status": 0,
	"message": "query ok",
	"request_id": "b02a12d48bd84e794bdd9deaa84f19",
	"result": {
		"data": [{
			"poi_id": "11107399966856067949",
			"title": "北京大学",
			"address": "北京市海淀区颐和园路5号",
			"category": "教育学校:大学",
			"location": {
				"lat": 39.992591,
				"lng": 116.3107
			},
			"reliability": 0.8500000238418579,
			"invalid_status": 0
		}]
	}
}

这篇文章对您解决问题是否有帮助?

已解决
未解决