# 项目详情
# 接口介绍
接口信息
接口 ID:2002
接口名称:项目详情
接口类型:数据获取
接口URL:
HTTP请求方式: POST
授权方式:
接口介绍:
1.根据楼盘ID查询楼盘详细的基本信息
# 升级版本
版本记录
当前接口无升级版本
# 请求参数:
请求参数
参数名称 | 是否必填 | 类型 | 参数说明 |
---|---|---|---|
cityId | 是 | string | 城市ID,取自城市字典,支持单一城市查询 |
coordinateType | 否,默认高德 | string | 坐标类型(坐标类型 [百度:bd09,高德:gcj02,默认为高德]) |
instalmentId | 是 | string | 楼盘ID,中指项目唯一标识 |
beginDate | 否,默认为历史最早时间 | string | 数据统计开始月份,该时间不可以早于36个月,yyyy-MM |
endDate | 否,默认为最新时间 | string | 数据统计结束月份,该时间不可以早于开始时间,yyyy-MM |
propertyGroupByList | 否,默认按照时间统计 | string | 项目统计分组,选择后将数据按照对应方式进行统计汇总(1.默认为时间,将月度作为统计维度; 2.可选:month=时间(月度)、propertyType=物业类型、roomType=户型、areaSection=面积段、priceSection=价格段、amountSection=总价段; 3.上市数据不支持priceSection和amountSection分组查询,可售数据不支持:day, week,season,halfYear,year,priceSection,amountSection分组查询。) |
areaSectionList | 否,默认取标准面积段 | string | 面积段(1.默认根据项目的面积段划分;2.客户可自主自定义,自定义的区间范围需要≥10;3.单位:㎡) |
priceSectionList | 否,默认取标准价格段 | string | 价格段(1.默认根据项目的价格段划分;2.客户可自主自定义,自定义的区间范围需要≥10;3.单位:元/㎡) |
amountSectionList | 否,默认取标准总价段 | string | 总价段(1.默认根据项目的总价段划分;2.客户可自主自定义,自定义的区间范围需要≥10;3.单位:万元) |
# 返回结果:
JSON示例
{
"meta": {
"code": 1,
"message": null,
"structure": 1,
"encrypted": false,
"cached": false
},
"data": {
"isCharging": 0,
"houseInfoSearchDto": {
"instalmentName": "鸿荣源·壹成中心璞誉府",
"instalmentId": "97cc6cf6-278d-4a91-bbbd-e1e790a5fa05",
"houseType": "住宅",
"projectFeature": "品牌地产,地铁沿线,景观居所",
"buildingCategory": "塔楼",
"fixStatusTypeDetail": "毛坯,公共部分带装修",
"zoneName": "无",
"businessCircle": "龙华",
"dimensionRate": "4.30",
"virescenceRate": "40.00",
"firstOpenDate": "2015-11-07",
"latestOpenDate": "2020-07-10",
"livinDate": "2022-04-30",
"developer": "深圳市鸿荣源实业有限公司",
"saleCard": "深房许字(2020)龙华003号",
"saleAddress": "龙华区人民路(地铁4号线龙华站)",
"saleTel": "0755-29699999",
"propertyManage": "深圳市鸿荣源物业服务有限公司",
"houseAddress": "人民路(地铁4号线龙华站)",
"propertyFee": "5.90元/㎡·月",
"propertyAddition": "住宅物业费5.9元/平·月",
"busText": "地铁:地铁四号线龙华站;公交:电信大厦站、龙华地铁站、壹成中心第九区公交总站、风和日丽北站;导航地址:壹成中心花园展示中心",
"priceUnitType": "元/平方米",
"quotedPrice": "68000.00",
"groundArea": "45812.00",
"purposeArea": "289042.00",
"startDate": "2014-05-12",
"finishDate": "",
"investor": "深圳市鸿荣源实业有限公司,",
"agent": "中原地产代理(深圳)有限公司,",
"totalDoorNum": 1535,
"sightDesigh": "",
"landScapeDesigh": "",
"lng": "114.038361",
"lat": "22.648746",
"rightYear": "鸿荣源·壹成中心璞誉府普通住宅产权为70年",
"provinceName": "广东",
"cityName": "深圳",
"districtName": "龙华区"
},
"newHouseDealDataDtoList": [
{
"groupName1": "2019-08",
"groupName2": "70-80",
"groupName3": "50000(含)-60000元",
"dealNum": 18,
"dealArea": "1401.35",
"dealPrice": "59554.83",
"dealAmount": "8345.72",
"supplyNum": null,
"supplyArea": null,
"availableNum": null,
"availableArea": null
},
{
"groupName1": "2019-12",
"groupName2": "70-80",
"groupName3": "50000(含)-60000元",
"dealNum": 4,
"dealArea": "314.41",
"dealPrice": "59335.68",
"dealAmount": "1865.57",
"supplyNum": null,
"supplyArea": null,
"availableNum": null,
"availableArea": null
},
{
"groupName1": "2020-01",
"groupName2": "70-80",
"groupName3": "50000(含)-60000元",
"dealNum": 1,
"dealArea": "79.40",
"dealPrice": "59471.00",
"dealAmount": "472.20",
"supplyNum": null,
"supplyArea": null,
"availableNum": null,
"availableArea": null
},
{
"groupName1": "2019-11",
"groupName2": "70-80",
"groupName3": "50000(含)-60000元",
"dealNum": 2,
"dealArea": "156.95",
"dealPrice": "59777.02",
"dealAmount": "938.20",
"supplyNum": null,
"supplyArea": null,
"availableNum": null,
"availableArea": null
},
{
"groupName1": "2019-10",
"groupName2": "70-80",
"groupName3": "50000(含)-60000元",
"dealNum": 9,
"dealArea": "706.89",
"dealPrice": "59426.93",
"dealAmount": "4200.83",
"supplyNum": null,
"supplyArea": null,
"availableNum": null,
"availableArea": null
},
{
"groupName1": "2019-09",
"groupName2": "70-80",
"groupName3": "50000(含)-60000元",
"dealNum": 46,
"dealArea": "3587.38",
"dealPrice": "59584.23",
"dealAmount": "21375.13",
"supplyNum": null,
"supplyArea": null,
"availableNum": null,
"availableArea": null
}
],
"esfHouseDealDataDtoList": [
{
"groupName1": "2019-08",
"groupName2": "70-80",
"groupName3": "50000-60000",
"dealPrice": "57859.00",
"dealNum": 10,
"dealArea": "751.67",
"dealAmount": "4349.09"
},
{
"groupName1": "2019-09",
"groupName2": "70-80",
"groupName3": "50000-60000",
"dealPrice": "58771.00",
"dealNum": 7,
"dealArea": "524.17",
"dealAmount": "3080.60"
}
]
}
}
# 参数说明:
参数说明
参数名 | 描述 |
---|---|
data | 返回查询结果,没有匹配记录则返回为空,具体字段含义见下表 |
meta | 返回值描述 |
code | 返回码.1为成功,http状态码为统一http请求错误,其他5位状态码为自定义错误码 |
message | 消息 |
字段说明:
返回值字段 | 类型 | 说明 | 描述 |
---|---|---|---|
HouseDetailDto | 返回数据包括楼盘基础信息、新房交易数据及二手房交易数据 | ||
HouseInfoSearchDto | array | 楼盘基础信息 | |
instalmentId | string | 楼盘ID | |
instalmentName | string | 楼盘名称 | |
lng | string | 经度,会根据入参"coordinateType"字段进行返回 | |
lat | string | 纬度,会根据入参"coordinateType"字段进行返回 | |
provinceName | string | 省份 | |
cityName | string | 城市 | |
districtName | string | 区县 | |
houseType | string | 物业类型 | |
projectFeature | string | 项目特色 | |
buildingCategory | string | 建筑类别 | |
fixStatusTypeDetail | string | 装修状况 | |
zoneName | string | 环线位置 | |
businessCircle | string | 所属商圈 | |
dimensionRate | string | 容积率 | |
virescenceRate | string | 绿化率 | |
firstOpenDate | string | 首次开盘时间 | |
latestOpenDate | string | 最新开盘时间 | |
livinDate | string | 交房时间 | |
developer | string | 开发商 | |
saleCard | string | 预售证号 | |
saleAddress | string | 售楼地址 | |
saleTel | string | 销售电话 | |
propertyManage | string | 物业公司 | |
houseAddress | string | 物业地址 | |
propertyFee | string | 物业费 | |
propertyAddition | string | 物业管理附加信息 | |
busText | string | 交通状况 | |
priceUnitType | string | 报价单位 | |
quotedPrice | string | 报价 | |
groundArea | string | 占地面积 | |
purposeArea | string | 建筑面积 | |
startDate | string | 开工时间 | |
finishDate | string | 竣工时间 | |
investor | string | 投资商 | |
agent | string | 代理商 | |
rightYear | string | 产权年限 | |
totalDoorNum | string | 总户数 | |
sightDesigh | string | 景观设计单位 | |
landScapeDesigh | string | 建筑及园林设计单位 | |
NewHouseDealDataMonthDtoList | array | 新房交易数据 | |
groupName1 | string | 根据入参分组1选择的类型进行展示 | |
groupName2 | string | 根据入参分组2选择的类型进行展示 | |
groupName3 | string | 根据入参分组3选择的类型进行展示 | |
dealNum | integer | 成交套数 | |
dealArea | string | 成交面积 | |
dealPrice | string | 成交价格 | |
dealAmount | string | 成交金额 | |
supplyNum | integer | 批准上市套数 | |
supplyArea | string | 批准上市面积 | |
availableNum | integer | 可售套数 | |
availableArea | string | 可售面积 | |
EsfHouseDealDataDtoList | array | 二手房交易数据 | |
groupName1 | string | 根据入参分组1选择的类型进行展示 | |
groupName2 | string | 根据入参分组2选择的类型进行展示 | |
groupName3 | string | 根据入参分组3选择的类型进行展示 | |
dealNum | integer | 成交套数 | |
dealArea | string | 成交面积 | |
dealPrice | string | 参考成交价 | |
dealAmount | string | 成交金额 |