正在跳转至目标页,请稍后…
概述
通过本服务,可将第三方POI数据,通过名称、地址、经纬度等信息,关联到腾讯位置服务的POI,获取腾讯位置服务POI ID。
注:
本服务属于高级付费服务,如需试用请提交商务合作开通服务试用。
请求URL
该请求为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
}]
}
}
这篇文章对您解决问题是否有帮助?
已解决
未解决