年度画像当前值

接口信息

项目	内容
请求方式	`GET`
接口路径	`/api/bs_v5/province_city_analysis/area_profile`
数据范围	全国、省份、城市
数据时效	当前 ADS 快照
主要来源	`ads_area_metric_current`

请求参数

参数	类型	必填	示例	说明
`area_level`	string	是	`province`	`country`、`province` 或 `city`
`area_id`	integer	是	`44`	对应 DIM ID
`metric_codes`	string	否	`IND-054,IND-094`	逗号分隔指标编号

请求示例

指标编号说明

接口响应以 metric_code 区分指标，业务系统应按下表取值；当前响应不返回 metric_name 字段。

指标编号	指标含义	返回单位	可用层级	口径说明
`IND-054`	常住人口	人	全国、省、城市	当前最终命中人口；全国红黑值由同年各省 `city_name='全部'` 行的 `SUM(resident_population)` 生成。
`IND-0101`	男性人口数	人	全国、省、城市	全国、省取官方人口表的合计行男性人口；城市暂无来源时按本接口的缺失占位规则返回。
`IND-0102`	女性人口数	人	全国、省、城市	全国、省取官方人口表的合计行女性人口；城市暂无来源时按本接口的缺失占位规则返回。
`IND-0103`	男性人口占常住人口比例	`%`	全国、省、城市	官方合计行男性人口 ÷ 官方合计行常住人口 × 100%；城市暂无来源时按本接口的缺失占位规则返回。
`IND-0104`	女性人口占常住人口比例	`%`	全国、省、城市	官方合计行女性人口 ÷ 官方合计行常住人口 × 100%；城市暂无来源时按本接口的缺失占位规则返回。
`IND-055`	土地面积	平方公里	全国、省、城市	对应 DIM 行政区域面积，不参与年度递补。
`IND-068`	人均可支配收入	元	全国、省、城市	全国取 `dim_country`，省/市按年度候选选源。
`IND-069`	人均消费支出	元	省、城市	全国暂不提供。
`IND-081`	城镇人口数	人	全国、省、城市	当前最终命中的城镇人口数。
`IND-082`	农村人口数	人	全国、省、城市	当前最终命中的农村人口数；城市按全市行政辖区口径。
`IND-083`	城镇化率	`%`	全国、省、城市	城镇人口 ÷ 常住人口 × 100%；分子、分母允许分别命中最新可用来源。
`IND-084`	农村人口占比	`%`	全国、省、城市	固定为 `100% - IND-083`。
`IND-085`	0～15 岁人口占比	`%`	城市	`100% - young_rate - old_rate`。
`IND-086`	16～59 岁人口占比	`%`	城市	直接使用 `young_rate`。
`IND-087`	60 岁及以上人口占比	`%`	全国、省、城市	最新可用 60+ 人口数 ÷ 最新可用常住人口；允许跨来源或跨年份。
`IND-088`	0～14 岁人口占比	`%`	全国、省	与 `IND-085` 的年龄边界不同，不互相替代。
`IND-089`	15～59 岁人口占比	`%`	全国、省	与 `IND-086` 的年龄边界不同，不互相替代。
`IND-090`	普通高等教育在校生人数	人	全国、省、城市	全国为本专科生与研究生人数之和。
`IND-094`	地区生产总值（GDP）	亿元	全国、省、城市	先取最新统计年；同年按有哥、官方、红黑优先级选源。
`IND-095`	人均 GDP	元	全国、省、城市	全国优先官方；省/市缺失时允许同年 GDP ÷ 同年常住人口计算。
`IND-096`	GDP 同比增长率	`%`	全国、省、城市	（当年 GDP - 上年 GDP）÷ 上年 GDP × 100%；相邻年度可跨来源。
`IND-087_NUM`	60 岁及以上人口数	人	内部辅助项	用于 `IND-087` 计算；默认不返回，业务系统不建议请求。

除 IND-0101～IND-0104 的城市缺失占位外，不适用层级或尚未产出的指标不会返回 0，也不会出现在 data.items 中。

城市请求这四个性别人口指标、但 ADS 尚无真实数据时，接口仍返回对应 metric_code；value、unit、stat_year、来源、递补、血缘及计算版本字段均为 null。该规则同时适用于未传 metric_codes 的城市请求。

成功响应字段

字段路径	类型	可空	中文含义
`code`	integer	否	业务状态码，成功为 `200`
`message`	string	否	响应信息
`data.data_scope`	string	否	数据范围，固定为 `current`
`data.area_level`	string	否	地区层级
`data.area_id`	integer	否	地区 ID
`data.items`	array	否	当前有效年度指标列表
`data.items[].metric_code`	string	否	指标编号
`data.items[].value`	number	是	指标值；城市性别人口缺失占位时为 `null`
`data.items[].unit`	string	是	指标单位
`data.items[].stat_year`	integer	是	指标统计年度；静态 DIM 指标为空
`data.items[].data_source/source_name`	string	是	最终命中来源编码/中文名称
`data.items[].source_priority`	integer	是	最终来源优先级，数值越小优先级越高
`data.items[].is_fallback`	boolean	否	是否发生来源递补
`data.items[].fallback_from`	string	是	被递补的优先来源
`data.items[].is_mixed_source/is_mixed_year`	boolean	否	计算组成项是否跨来源/跨年份
`data.items[].source_lineage`	array	否	ODS/DIM 来源记录血缘
`data.items[].calculation_version`	string	是	指标计算版本

成功响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "data_scope": "current",
    "area_level": "province",
    "area_id": 44,
    "items": [
      {
        "metric_code": "IND-054",
        "value": 127000000,
        "unit": "人",
        "stat_year": 2025,
        "data_source": "hc",
        "source_name": "红黑",
        "source_priority": 2,
        "is_fallback": false,
        "fallback_from": null,
        "is_mixed_source": false,
        "is_mixed_year": false,
        "source_lineage": [],
        "calculation_version": "province_city_analysis_v2"
      }
    ]
  }
}

业务规则

只返回当前已产出的适用指标，不适用指标不返回 0。递补已在 ADS 完成，接口不读取 ODS、不重新选源；土地面积和全国人均可支配收入等静态事实的 stat_year 返回 null。

城市性别人口缺失响应示例

{
  "metric_code": "IND-0101",
  "value": null,
  "unit": null,
  "stat_year": null,
  "data_source": null,
  "source_name": null,
  "source_priority": null,
  "is_fallback": null,
  "fallback_from": null,
  "is_mixed_source": null,
  "is_mixed_year": null,
  "source_lineage": null,
  "calculation_version": null
}

异常码

code	说明
`400`	参数错误
`404`	区域不存在或未启用
`500`	服务端异常

现有 overview 与 benchmark_brands 接口中的人口密度展示会优先读取 IND-054 当前 ADS，分别返回 resident_population_stat_year / resident_population_source（以及全国对应字段），以便页面说明门店月与人口统计年的差异。

年度画像当前值(v6.70新接口)

年度画像当前值

接口信息

请求参数

请求示例

指标编号说明

成功响应字段

成功响应示例

业务规则

城市性别人口缺失响应示例

异常码

请求参数

请求示例代码

返回响应

年度画像当前值(v6.70新接口)

年度画像当前值#

接口信息#

请求参数#

请求示例#

指标编号说明#

成功响应字段#

成功响应示例#

业务规则#

城市性别人口缺失响应示例#

异常码#

请求参数

请求示例代码

返回响应

年度画像当前值

接口信息

请求参数

请求示例

指标编号说明

成功响应字段

成功响应示例

业务规则

城市性别人口缺失响应示例

异常码