腾讯位置商业授权POI关联开发指南
概述
通过本服务，可将第三方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 | 否 | 关联结果可信度，取值：0-1 大于0.8即为可信度高，结果可采纳，小于0.8 建议自行判断。 |
调用示例
// GET请求，注意参数值要进行URL编码
https://apis.map.qq.com/ws/poi_association/v1?&location=39.99287,116.31025&title=北京大学&key=OB4BZ-D4W3U-*****