# 周边POI
# 接口介绍
接口信息
接口 ID：3004
接口名称：周边POI
接口类型：数据获取
接口URL：
HTTP请求方式： POST
授权方式：
接口介绍：
1.目前支持输入经纬度坐标，获取半径范围内，POI点位的坐标及类型；
2.可查询城市范围根据字典进行提供，半径范围最大5公里；
3.数据覆盖100个城市，交通、医疗、教育、商业、负面等共计13个大类别，百余个小分类，每半年度更新一次；
4.单次查询最大返回500条结果；
5.适用于针对项目做可行性研究和经营管理，以坐标点为核心，全面了解周边配套数据。
# 升级版本
版本记录
当前接口无升级版本
# 请求参数：
请求参数
| 参数名称 | 是否必填 | 类型 | 参数说明 |
|---|---|---|---|
| cityId | 是 | string | 城市ID，取自城市字典，支持单一城市查询 |
| coordinateType | 否，默认高德 | string | 坐标类型(坐标类型[百度:bd09,高德:gcj02,默认为高德]) |
| lng | 是 | string | 经度，精确到小数点后6位 |
| lat | 是 | string | 纬度，精确到小数点后6位 |
| radius | 是 | integer | 半径（米），最大不超过5000米 |
| poiTypeCategoryId | 否，默认全部类别 | string | 要素类别，根据字典进行调取，支持多类别同时查询 |
| typeId | 否，默认全部要素 | string | 要素名称，根据字典进行调取，支持多要素同时查询 |
| pageSize | 是 | integer | 每页条数，传参为小于100的整数 |
| pageNum | 是 | integer | 当前页数，传参应小于或等于数据总页数 |
# 返回结果：
JSON示例
{
"meta": {
"code": 1,
"message": null,
"structure": 1,
"encrypted": false,
"cached": false
},
"data": {
"totalCount": 500,
"circumPoiBaseSearchDtoList": [
{
"address": "14路",
"poiName": "福建中路南京东路",
"poiTypeCategoryName": "交通要素",
"poiTypeName": "公交",
"poiGradeName": "普通公交线路",
"lng": "121.481339",
"lat": "31.234232"
},
{
"address": "123路;167路;49路",
"poiName": "福州路福建中路",
"poiTypeCategoryName": "交通要素",
"poiTypeName": "公交",
"poiGradeName": "普通公交线路",
"lng": "121.482414",
"lat": "31.233803"
},
{
"address": "20路",
"poiName": "九江路福建中路",
"poiTypeCategoryName": "交通要素",
"poiTypeName": "公交",
"poiGradeName": "普通公交线路",
"lng": "121.482063",
"lat": "31.235783"
},
{
"address": "都市观光旅游1线",
"poiName": "南京路步行街",
"poiTypeCategoryName": "交通要素",
"poiTypeName": "公交",
"poiGradeName": "普通公交线路",
"lng": "121.480522",
"lat": "31.235464"
},
{
"address": "14路",
"poiName": "湖北路南京东路",
"poiTypeCategoryName": "交通要素",
"poiTypeName": "公交",
"poiGradeName": "普通公交线路",
"lng": "121.479813",
"lat": "31.234610"
},
{
"address": "980路;上川专线;隧道三线;隧道六线;隧道夜宵线",
"poiName": "福州路浙江中路",
"poiTypeCategoryName": "交通要素",
"poiTypeName": "公交",
"poiGradeName": "普通公交线路",
"lng": "121.480095",
"lat": "31.233000"
},
{
"address": "14路",
"poiName": "东新桥",
"poiTypeCategoryName": "交通要素",
"poiTypeName": "公交",
"poiGradeName": "普通公交线路",
"lng": "121.482101",
"lat": "31.232327"
},
{
"address": "805路/805路旅游观光环线",
"poiName": "九江路山东中路",
"poiTypeCategoryName": "交通要素",
"poiTypeName": "公交",
"poiGradeName": "普通公交线路",
"lng": "121.483475",
"lat": "31.236216"
},
{
"address": "980路;上川专线;隧道三线;隧道六线;隧道夜宵线",
"poiName": "福建中路延安东路",
"poiTypeCategoryName": "交通要素",
"poiTypeName": "公交",
"poiGradeName": "普通公交线路",
"lng": "121.482674",
"lat": "31.231909"
},
{
"address": "申城观光1号线",
"poiName": "南京路步行街(浙江中路)",
"poiTypeCategoryName": "交通要素",
"poiTypeName": "公交",
"poiGradeName": "普通公交线路",
"lng": "121.478287",
"lat": "31.234440"
},
{
"address": "167路;20路;330路;37路;49路;805路/805路旅游观光环线",
"poiName": "九江路浙江中路",
"poiTypeCategoryName": "交通要素",
"poiTypeName": "公交",
"poiGradeName": "普通公交线路",
"lng": "121.478287",
"lat": "31.234440"
},
{
"address": "330路;37路",
"poiName": "天津路福建中路",
"poiTypeCategoryName": "交通要素",
"poiTypeName": "公交",
"poiGradeName": "普通公交线路",
"lng": "121.478783",
"lat": "31.236736"
},
{
"address": "都市观光旅游1线",
"poiName": "世纪广场",
"poiTypeCategoryName": "交通要素",
"poiTypeName": "公交",
"poiGradeName": "普通公交线路",
"lng": "121.478111",
"lat": "31.235834"
},
{
"address": "220路;306路;66路;66路区间;805路/805路旅游观光环线;929路",
"poiName": "河南中路南京东路",
"poiTypeCategoryName": "交通要素",
"poiTypeName": "公交",
"poiGradeName": "普通公交线路",
"lng": "121.485329",
"lat": "31.236338"
},
{
"address": "17路;306路;66路;66路区间;805路/805路旅游观光环线;929路",
"poiName": "河南中路延安东路",
"poiTypeCategoryName": "交通要素",
"poiTypeName": "公交",
"poiGradeName": "普通公交线路",
"lng": "121.486061",
"lat": "31.233728"
},
{
"address": "14路",
"poiName": "福建中路北京东路",
"poiTypeCategoryName": "交通要素",
"poiTypeName": "公交",
"poiGradeName": "普通公交线路",
"lng": "121.479416",
"lat": "31.238199"
},
{
"address": "330路;37路",
"poiName": "天津路河南中路",
"poiTypeCategoryName": "交通要素",
"poiTypeName": "公交",
"poiGradeName": "普通公交线路",
"lng": "121.483810",
"lat": "31.238398"
},
{
"address": "49路",
"poiName": "汉口路江西中路",
"poiTypeCategoryName": "交通要素",
"poiTypeName": "公交",
"poiGradeName": "普通公交线路",
"lng": "121.486687",
"lat": "31.236202"
},
{
"address": "20路;330路;37路",
"poiName": "九江路江西中路",
"poiTypeCategoryName": "交通要素",
"poiTypeName": "公交",
"poiGradeName": "普通公交线路",
"lng": "121.486534",
"lat": "31.236992"
},
{
"address": "都市观光旅游1线",
"poiName": "南京路步行街东侧",
"poiTypeCategoryName": "交通要素",
"poiTypeName": "公交",
"poiGradeName": "普通公交线路",
"lng": "121.485802",
"lat": "31.237869"
}
]
}
}
# 参数说明：
参数说明
| 参数名 | 描述 |
|---|---|
| data | 返回查询结果，没有匹配记录则返回为空，具体字段含义见下表 |
| meta | 返回值描述 |
| code | 返回码.1为成功,http状态码为统一http请求错误,其他5位状态码为自定义错误码 |
| message | 消息 |
字段说明：
| 返回值字段 | 类型 | 说明 | 描述 |
|---|---|---|---|
| totalCount | integer | 结果数量 | |
| CircumPoiBaseSearchDto | array | POI列表 | |
| poiName | string | 点位名称 | |
| address | string | 地址 | |
| lng | string | 经度，会根据入参"coordinateType"字段进行返回 | |
| lat | string | 纬度，会根据入参"coordinateType"字段进行返回 | |
| poiTypeCategoryName | string | 要素类别名称 | |
| poiTypeName | string | 要素名称 | |
| poiGradeName | string | 等级名称 |
← 周边二手房