# 周边新房

# 接口介绍

接口信息

接口 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 可售面积

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

京 ICP备 18037826号-5