3D 数据结构文档

195 阅读9分钟

地理区域数据

基本属性:

  • name: 区域名字,比如说浦东新区
  • code: 区域对应的 code
  • position: 区域的经纬度数据,数据格式为[经度,纬度]

各区域基本数据:

[
  {
    code: 310117,
    name: '松江区',
    position: [
      121.220231,
      31.015194
    ],
  },
  {
    code: 310101,
    name: '黄浦区',
    position: [
      121.483572,
      31.215946
    ],
  },
  {
    code: 310104,
    name: '徐汇区',
    position: [
      121.439405,
      31.162992
    ],
  },
  {
    code: 310105,
    name: '长宁区',
    position: [
      121.380949,
      31.20737
    ],
  },
  {
    code: 310106,
    name: '静安区',
    position: [
      121.450659,
      31.270821
    ],
  },
  {
    code: 310107,
    name: '普陀区',
    position: [
      121.392042,
      31.257895
    ],
  },
  {
    code: 310109,
    name: '虹口区',
    position: [
      121.485443,
      31.276649
    ],
  },
  {
    code: 310110,
    name: '杨浦区',
    position: [
      121.529302,
      31.29835
    ],
  },
  {
    code: 310112,
    name: '闵行区',
    position: [
      121.418901,
      31.087213
    ],
  },
  {
    code: 310113,
    name: '宝山区',
    position: [
      121.404861,
      31.392111
    ],
  },
  {
    code: 310114,
    name: '嘉定区',
    position: [
      121.24439,
      31.358138
    ],
  },
  {
    code: 310115,
    name: '浦东新区',
    position: [
      121.742177,
      31.083823
    ],
  },
  {
    code: 310116,
    name: '金山区',
    position: [
      121.255144,
      30.818932
    ],
  },
  {
    code: 310118,
    name: '青浦区',
    position: [
      121.085188,
      31.124681
    ],
  },
  {
    code: 310120,
    name: '奉贤区',
    position: [
      121.56251,
      30.897998
    ],
  },
  {
    code: 310151,
    name: '崇明区',
    position: [
      121.568484,
      31.635916
    ],
  },
]

需要补充的特殊数据:

{
    code: 310000,
    name: '全部', // 其实就是整个上海市
    position: [
      121.438737,
      31.072559
    ],
},
{
    code: 310199, // 自定义的code,实际不存在
    name: '临港',
    position: [
      121.438737,
      31.072559
    ],
},

以上的这些地理区域数据后续基本都会用到!!!

接口列表

概览页面接口

接口一:根据区域 code 获取概览数据

接口参数:

  • code:区域 code,同时得支持全部临港的 code 进行数据查询

接口返回数据:

data: Array<item>

item:
- code: 区域 code 
- name:区域名称
- position:区域经纬度
- base_data: 基础概览数据
    - comp_util_rate: // 综合利用率
    - gen_intensity: // 产生强度
    - storage_disposal_capacity: // 贮存处置量
    - storage_disposal_trend: // 贮存处置量趋势 down/up
- enterprise_data: 
    - total_num: 总的企业数量
    - generate_num: 产生废料企业总数
    - transport_num: 运输废料企业总数
    - processing_num: 处理废料企业总数
    - small_company_proportion:小型(1 - 100 吨)产废企业比例
    - medium_company_proportion:小型(100 - 1000 吨)产废企业比例
    - large_company_proportion:大型(1000 吨)产废企业比例
    - areaList: Array<AreaItem> // 各个区域数据,只有传入的code是上海市 310000 才会有
    --------------------
    AreaItem: {
        - name:行政区名称
        - code:行政区code
        - generate_num: 产生废料企业总数
        - transport_num: 运输废料企业总数
        - processing_num: 处理废料企业总数
        - total_num: 该区总的企业数量
    }
    --------------------
- planned_waste_volume: 计划产废量
- actual_waste_volume: { // 实际产废数据
    total_num: 实际产废总量
    utilization_rate_data: {
        - total_rate:Array<RateItem> // 综合利用率
        - processing_rate:Array<RateItem> // 处置率
        - savings_rate: Array<RateItem> // 储存率
        --------------------
        RateItem: {
            - name:类型名称
            - rate:该类型所占的比例
        }
        --------------------
    }
    area_data: Array<SingleAreaData>
    --------------------
    SingleAreaData: {
        - code: 区域 code 
        - name:区域名称
        - num:实际产废量
    }
    --------------------
  }
- collect_transport_processing_data: Array<AreaData> // 收运数据
    --------------------
    AreaData: {
        - code: 行政区code
        - name: 行政区名称
        - collect_num: // 收废料总数
        - transport_num: // 运废料总数
        - processing_num: // 处理废料总数
        - actual_receive_num: // 实际接收量
    }
    --------------------
- price_announcement:Array<PriceItem> // 价格公示
  --------------------
  PriceItem: {
      - company_name: 公司名称
      - area_name_list:区域名称列表 Array<AreaName>
      - price:每吨价格
  }
  --------------------

接口二:不同区的工厂坐标数据

接口参数:

  • code:区域 code 接口返回数据:
data: Array<Factory>

--------------------
Factory: {
    - name: 工厂名字
    - code: 工厂code,唯一标识
    - position: 位置 [经度,纬度] 
    - icon_type:red/green/yellow/star
}
--------------------

接口三:工厂模型图表数据

接口参数:

  • code:工厂唯一标识 接口返回数据:
data: {
    - planned_waste_volume: 计划产废量
    - actual_waste_volume: { // 实际产废数据
        total_num: 实际产废总量
        area_data: Array<SingleAreaData>
        --------------------
        SingleAreaData: {
            - code: 区域 code 
            - name:区域名称
            - num:实际产废量
        }
        --------------------
    - transport_handle_data: {
          tranport_total_num: 收运总量 
          handle_total_num: 处置总量
          area_data: Array<SingleAreaData>
          --------------------
          SingleAreaData: {
              - code: 区域 code 
              - name:区域名称
              - tranport_num: 收运总量 
              - handle_num: 处置总量
          }
          --------------------
      }
    - report_receive_data: {
          report_total_num: 上报总量 
          receive_total_num: 接收总量
          area_data: Array<SingleAreaData>
          --------------------
          SingleAreaData: {
              - code: 区域 code 
              - name:区域名称
              - report_num: 收运总量 
              - receive_num: 处置总量
          }
          --------------------
      }
    - industry_list: Array<Industry>
      -------------------- 
      Industry: { 
          - name: 行业名称 
          - rate:产生占比 
      } 
      --------------------
}

产业结构页面接口

接口一:根据区域 code 获取产业机构数据

接口参数:

  • code:区域 code,同时得支持全部临港的 code 进行数据查询

接口返回数据:

data: {
    code: 行政区 code
    name: 行政区名称(如果code为310000,就返回上海市)
    waste_total_mount: 废量总量
    monthly_list: Array<Monthly> // 月度数据
    --------------------
    Monthly: {
        - name: 月份名称
        - num:当月数量
    }
    --------------------
    waste_type_list: Array<WasteType> // 废料分类数据
    --------------------
    WasteType: {
        - name: 废料名称
        - rate:该种废料所占比例
    }
    --------------------
    - enterprise_list: Array<Enterprise> // 环境管理企业数据
    --------------------
    Enterprise: {
        - type: 企业类型
        - desc: 企业描述
        - num:企业数量
    }
    --------------------
    utilization_disposal_data: Array<U> // 综合利用和处置情况
    --------------------
    U: {
        - institution: 相关机构描述
        - enterprise_num: 企业数量
        - utilization_num:利用数量
        - disposal_num:处置数量
    }
    --------------------
    industry_list: Array<Industry> // 行业情况
    --------------------
    Industry: {
        - type: 企业类型 // 原来是 company: 相关企业数量
        - utilization_rate:利用率
        - disposal_rate:处置率
    }
    --------------------
    area_list: Array<Area> // 各区情况,只有选择“全部”区域的时候才会有
    --------------------
    Area: {
        - name: 区名称
        - code: 区code
        - num:废料数量
        - rate:占总数的比例
    }
    --------------------
    registration_info: Array<Info> // 实时登记信息
    --------------------
    Info: {
        - name: 公司名称
        - area:区域描述
        - time:产生时间
        - type:废料类型
        - waste_num: 废料数量
    }
    --------------------
    area_data: Array<AreaItem> // 各个区域的数据,只有选择“全部”区域的时候才会有
}

AreaItem: 就是上面的 data 去掉 area_data 属性

流量流向页面接口

接口一:根据区域 code 获取流量流向数据

接口参数:

  • code:区域 code,同时得支持全部临港的 code 进行数据查询

接口返回数据:

data: {
    flow_out_total: // 总流出
    flow_out_list: Array<Flow> // 流出列表数据
    --------------------
    Flow: {
        - start_point: 起始点位置 [经度,纬度]
        - start_area_name:起始点名称
        - num:数量
        - end_point: 目的点位置 [经度,纬度]
        - end_area_name:目的点名称
    }
    --------------------
    flow_in_list: Array<Flow> // 流入列表数据
    --------------------
    Flow: {
        - start_point: 起始点位置 [经度,纬度]
        - start_area_name:起始点名称
        - num:数量
        - end_point: 目的点位置 [经度,纬度]
        - end_area_name:目的点名称
    }
    --------------------
    receiver_list: Array<Receiver> // 外省接收方列表
    --------------------
    Receiver: {
        - name: 接收方名称
        - num:接收数量
    }
    --------------------
    top5: Array<FlowOutItem> // 跨省品类 top5
    --------------------
    FlowOutItem: {
        - name: 废料名称
        - num:废料数量
        - ranking:排名
    }
    --------------------
    handle_info: {
        flow_out_handle_total: 市外总流量(吨数)
        flow_out_handle_info: Array<HandleInfo> // 流出处理数据
        flow_handle_total: 市内总流量(吨数)
        flow_handle_info: Array<HandleInfo> // 市内处理数据
        --------------------
        HandleInfo: {
            - name: 处理方式名称
            - rate:处理比例
        }
        --------------------
        types: Array<TypeInfo> // 流量类型数据
        --------------------
        TypeInfo: {
            - name: 流量类型名称
            - num:流量类型数量
        }
        --------------------
    }
}

数据分析页面接口

接口一:获取统计数据

接口参数:无

接口返回数据:

data: {
    - enterprise_list: Array<Enterprise> // 企业数据列表
    --------------------
    Enterprise: {
        - type: 企业类型描述
        - num:该类型企业数量
        - generate_num: // 产废量
        - leave_num: // 出厂量
        - transport_num:// 收运量
        - destination_num: // 去向量
        - entry_disposal_num: // 入场处置量
    }
    --------------------
    - active_enterprise_list: Array<A> // 活跃数据列表
    --------------------
    A: {
        - enterprise_name: 公司名称
        - num:废料数量
    }
    --------------------
    industry_list: Array<Industry> // 行业情况
    --------------------
    Industry: {
        - name: 行业名称
        - enterprise_num:企业数量
    }
    --------------------
    actual_waste_num: // 实际产废量
    actual_waste_rate: // 实际产废量占计划产废量的比例
    actual_recive_num: // 实际接收量
    actual_recive_rate: // 实际接收量占企业上报总量的比例
    actual_entering_num: // 实际进厂量
    actual_entering_rate: // 实际进厂量占限额的比例
    actual_transport_num: // 实际收运量
    actual_transport_rate: // 实际收运平衡率
}

接口二(产废图表):获取全上海的产废和出场量趋势数据

接口参数:

  • year: 年份
  • month: 月份
  • day: 日(可以不传)
data: Array<Item>

--------------------
Item: {
    - time: 月份/或者具体日子
    - waste_num:产废数量
    - leave_num: 出场量
}
--------------------

接口三(产废图表):产废量同环比数据

接口参数:

  • startTime:起始年月
  • endTime:截止年月
data: {
    qoq: { // 环比
        num: 所选时间段数量
        last_num: 环比数量
        rate: 环比比例
    },
    yoy: { // 同比
        num: 所选时间段数量
        last_num: 环比数量
        rate: 同比比例
    }
}

接口四(产废图表):出场量同环比数据

接口参数:

  • startTime:起始年月
  • endTime:截止年月
data: {
    qoq: { // 环比
        num: 所选时间段数量
        last_num: 环比数量
        rate: 环比比例
    },
    yoy: { // 同比
        num: 所选时间段数量
        last_num: 环比数量
        rate: 同比比例
    }
}

接口五(产废图表):获取所有区的产废和出厂量对比数据

接口参数:

  • year: 年份
  • month: 月份(可以不传)
data: Array<AreaData>

--------------------
AreaData: {
    - name: 区域名称
    - code: 区域code
    - waste_num:产废数量
    - leave_num: 出场量
}
--------------------

接口六(收运量和处置去向量图表):获取全上海收运量和处置去向量趋势数据

接口参数:

  • year: 年份
  • month: 月份
  • day: 日(可以不传)
data: Array<Item>

--------------------
Item: {
    - time: 月份/或者具体日子
    - transport_num:收运数量
    - destination_num: 处置去向量
}
--------------------

接口七(收运量和处置去向量图表):收运量同环比数据

接口参数:

  • startTime:起始年月
  • endTime:截止年月
data: {
    qoq: { // 环比
        num: 所选时间段数量
        last_num: 环比数量
        rate: 环比比例
    },
    yoy: { // 同比
        num: 所选时间段数量
        last_num: 环比数量
        rate: 同比比例
    }
}

接口八(收运量和处置去向量图表):收运量排行

接口参数:

  • year: 年份
  • month: 月份(可以不传)
data: Array<Rank>
--------------------
Rank: {
    - enterprise_name: 企业名称
    - ranking:排名
    - num: 收运数量
}
--------------------

接口九(收运量和处置去向量图表):获取所有区收运量和处置去向量对比数据

接口参数:

  • year: 年份
  • month: 月份(可以不传)
data: Array<AreaData>

--------------------
AreaData: {
    - name: 区域名称
    - transport_num:收运数量
    - destination_num: 处置去向量
}
--------------------

接口十(处置量图表):处置厂处置量对比

接口参数:

  • year: 年份
  • month: 月份(可以不传)
data: Array<FactoryData>

--------------------
AreaData: {
    - name: 处置厂名称
    - target_num:目标数量
    - actual_num: 实际数量
}
--------------------

接口十一(处置量图表):处置厂进厂总量

接口参数:

  • year: 年份
  • month: 月份
  • day: 日(可以不传)
data: Array<FlowInData>

--------------------
FlowInData: {
    - time: 月份/或者具体日子
    - flow_in_num:进厂数量
}
--------------------

接口十二(处置量图表):处置量同环比数据

接口参数:

  • startTime:起始年月
  • endTime:截止年月
data: {
    qoq: { // 环比
        num: 所选时间段数量
        last_num: 环比数量
        rate: 环比比例
    },
    yoy: { // 同比
        num: 所选时间段数量
        last_num: 环比数量
        rate: 同比比例
    }
}

接口十三(处置量图表):处置车辆进厂分析

接口参数:

  • year: 年份
  • month: 月份
  • day: 日(可以不传)
data: Array<Enterprise>

--------------------
Enterprise: {
    - name: 公司名称
    - train_num:进厂车次
    - car_num: 车辆数量
    - frequency:平均进厂频率
}
--------------------