# 项目详情

# 接口介绍

接口信息

接口 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 成交金额

copyright © 2021 北京中指宏远数据信息技术有限公司 Beijing Zhong Zhi Hong Yuan Data Information Technology Co.,Ltd 版权所有

京 ICP备 18037826号-5