# 周边新房
# 接口介绍
接口信息
接口 ID：3002
接口名称：周边新房
接口类型：数据获取
接口URL：
HTTP请求方式： POST
授权方式：
接口介绍：
1.目前支持输入经纬度坐标，获取半径范围内，新房楼盘的基本信息、市场交易数据；
2.可查询城市范围根据字典进行提供，半径范围最大5公里；
3.新房楼盘仅展示开盘时间在36个月内的楼盘；
4.单次查询最大返回500条结果；
5.适用于针对项目做可行性研究和经营管理，以坐标点为核心，全面了解周边楼盘详细数据。
# 升级版本
版本记录
当前接口无升级版本
# 请求参数：
请求参数
| 参数名称 | 是否必填 | 类型 | 参数说明 |
|---|---|---|---|
| cityId | 是 | string | 城市ID，取自城市字典，支持单一城市查询 |
| coordinateType | 否，默认高德 | string | 坐标类型(坐标类型[百度:bd09高德:gcj02,默认为高德]) |
| lng | 是 | string | 经度，精确到小数点后6位 |
| lat | 是 | string | 纬度，精确到小数点后6位 |
| radius | 是 | integer | 半径（米），最大不超过5000米 |
| category | 否，默认全部类型 | string | 物业类型（住宅：2，商铺：4，写字楼：5），支持多类型同时查询 |
| saleStatusId | 否，默认全部状态 | string | 销售状态（待售=0、在售=1,售罄=2），支持多状态同时查询 |
| beginDate | 否，默认全部日期 | string | 开盘时间统计开始日期，yyyy-MM-dd |
| endDate | 否，默认全部日期 | string | 开盘时间统计结束日期，yyyy-MM-dd |
| pageSize | 是 | integer | 每页条数，传参为小于100的整数 |
| pageNum | 是 | integer | 当前页数，传参应小于或等于数据总页数 |
# 返回结果：
JSON示例
{
"meta": {
"code": 1,
"message": null,
"structure": 1,
"encrypted": false,
"cached": false
},
"data": {
"totalCount": 2,
"circumNewHouseBaseSearchDtoList": [
{
"projectName": "世茂云图",
"instalmentId": "ccaf566a-7c1a-4988-a28f-c6be5b4d9a71",
"cityName": "上海",
"cityId": "52907f4c-7222-4b38-b50a-3d5346852b53",
"districtName": "浦东新区",
"industryDistrictId": 743,
"priceUnitType": "元/平方米",
"quotedPrice": "57334.00",
"porpertyType": "住宅",
"saleStatus": "在售",
"fixStatus": "带装修",
"houseAddress": "康涵路58弄",
"livinDate": "2017-06-01",
"groundArea": "49369.00",
"buildingArea": "120135.83",
"rightYear": "世茂云图普通住宅产权为70年",
"totalDoorNum": 830,
"lat": "31.115261",
"lng": "121.546026",
"newHouseDealDataMonthDtoList": [
{
"dateMonth": "2020-07",
"dealNum": 81,
"dealArea": "8525.84",
"dealPrice": "58261.90",
"dealAmount": "49673.16",
"supplyNum": null,
"supplyArea": null,
"availableNum": 103,
"availableArea": "11376.61"
},
{
"dateMonth": "2020-06",
"dealNum": 186,
"dealArea": "18142.10",
"dealPrice": "57195.98",
"dealAmount": "103765.53",
"supplyNum": 348,
"supplyArea": "35901.64",
"availableNum": 223,
"availableArea": "23939.18"
},
{
"dateMonth": "2020-05",
"dealNum": null,
"dealArea": null,
"dealPrice": null,
"dealAmount": null,
"supplyNum": null,
"supplyArea": null,
"availableNum": 6,
"availableArea": "566.84"
},
{
"dateMonth": "2020-04",
"dealNum": null,
"dealArea": null,
"dealPrice": null,
"dealAmount": null,
"supplyNum": null,
"supplyArea": null,
"availableNum": null,
"availableArea": null
},
{
"dateMonth": "2020-03",
"dealNum": null,
"dealArea": null,
"dealPrice": null,
"dealAmount": null,
"supplyNum": null,
"supplyArea": null,
"availableNum": null,
"availableArea": null
},
{
"dateMonth": "2020-02",
"dealNum": null,
"dealArea": null,
"dealPrice": null,
"dealAmount": null,
"supplyNum": null,
"supplyArea": null,
"availableNum": null,
"availableArea": null
}
]
},
{
"projectName": "保利首创颂",
"instalmentId": "d0337afb-5c0f-472d-a637-8b5015bdae65",
"cityName": "上海",
"cityId": "52907f4c-7222-4b38-b50a-3d5346852b53",
"districtName": "浦东新区",
"industryDistrictId": 743,
"priceUnitType": "元/平方米",
"quotedPrice": "69500.00",
"porpertyType": "住宅",
"saleStatus": "在售",
"fixStatus": "带装修",
"houseAddress": "年家浜路1468号(林海公路年家浜路路口)",
"livinDate": "2020-09-30",
"groundArea": "69433.10",
"buildingArea": "224388.77",
"rightYear": "保利首创颂普通住宅产权为70年,叠拼产权为70年",
"totalDoorNum": 1347,
"lat": "31.112575",
"lng": "121.546936",
"newHouseDealDataMonthDtoList": [
{
"dateMonth": "2020-07",
"dealNum": 83,
"dealArea": "8625.72",
"dealPrice": "66462.28",
"dealAmount": "57328.50",
"supplyNum": null,
"supplyArea": null,
"availableNum": 302,
"availableArea": "36450.42"
},
{
"dateMonth": "2020-06",
"dealNum": 72,
"dealArea": "7059.10",
"dealPrice": "62837.13",
"dealAmount": "44357.36",
"supplyNum": null,
"supplyArea": null,
"availableNum": 391,
"availableArea": "45636.11"
},
{
"dateMonth": "2020-05",
"dealNum": 158,
"dealArea": "15388.52",
"dealPrice": "62426.57",
"dealAmount": "96065.25",
"supplyNum": null,
"supplyArea": null,
"availableNum": 453,
"availableArea": "51744.04"
},
{
"dateMonth": "2020-04",
"dealNum": null,
"dealArea": null,
"dealPrice": null,
"dealAmount": null,
"supplyNum": 582,
"supplyArea": "64301.63",
"availableNum": null,
"availableArea": null
},
{
"dateMonth": "2020-03",
"dealNum": 6,
"dealArea": "575.48",
"dealPrice": "58241.57",
"dealAmount": "3351.69",
"supplyNum": null,
"supplyArea": null,
"availableNum": null,
"availableArea": null
},
{
"dateMonth": "2020-02",
"dealNum": 1,
"dealArea": "91.04",
"dealPrice": "61440.00",
"dealAmount": "559.35",
"supplyNum": null,
"supplyArea": null,
"availableNum": null,
"availableArea": null
}
]
}
]
}
}
# 参数说明：
参数说明
| 参数名 | 描述 |
|---|---|
| data | 返回查询结果，没有匹配记录则返回为空，具体字段含义见下表 |
| meta | 返回值描述 |
| code | 返回码.1为成功,http状态码为统一http请求错误,其他5位状态码为自定义错误码 |
| message | 消息 |
返段说明：
| 返回值字段 | 类型 | 说明 | 描述 |
|---|---|---|---|
| totalCount | integer | 结果数量 | |
| CircumNewHouseBaseSearchDtoList | array | 新房项目列表 | |
| projectName | string | 楼盘名称 | |
| instalmentId | string | 楼盘ID | |
| lng | string | 经度，会根据入参"coordinateType"字段进行返回 | |
| lat | string | 纬度，会根据入参"coordinateType"字段进行返回 | |
| cityName | string | 城市名称 | |
| cityId | string | 城市ID | |
| districtName | string | 区县名称 | |
| industryDistrictId | string | 区县ID | |
| priceUnitType | string | 报价单位 | |
| quotedPrice | string | 报价 | |
| porpertyType | string | 物业类型 | |
| saleStatus | string | 销售状态(0 待售，1 在售，2 售罄) | |
| fixStatus | string | 装修状况 | |
| houseAddress | string | 楼盘地址 | |
| livinDate | string | 交房时间 | |
| groundArea | string | 占地面积 | |
| buildingArea | string | 建筑面积 | |
| rightYear | string | 产权年限 | |
| totalDoorNum | string | 总户数 | |
| NewHouseDealDataMonthDtoList | Array | 交易数据 | |
| dateMonth | string | 月份 | |
| dealNum | integer | 成交套数 | |
| dealArea | string | 成交面积 | |
| dealPrice | string | 成交价格 | |
| dealAmount | string | 成交额 | |
| supplyNum | integer | 上市套数 | |
| supplyArea | string | 上市面积 | |
| availableNum | integer | 可售套数 | |
| availableArea | string | 可售面积 |