datacommons-client

Data Commons Client - 公共统计数据 Python API 客户端

技能概述

通过统一的 Python 接口访问 Data Commons 平台的全球公共统计数据，包括人口、经济、健康、环境等权威数据源。

适用场景

数据科学研究与经济分析：获取各国、各地区的人口统计、GDP、失业率、收入中位数等经济指标数据，支持趋势分析和对比研究

健康与环境数据查询：访问疾病流行率、死亡率、环境指标等公共卫生和环境统计数据

地理实体解析与层级探索：将地名、坐标、Wikidata ID 转换为 Data Commons 标识符，并探索地理层级关系（如州-县-市）

核心功能

统计观测数据查询：通过 Observation Endpoint 查询时序统计数据，支持单点查询（最新值）、全时序查询、层级批量查询，并可按数据源过滤确保一致性

知识图谱探索：通过 Node Endpoint 探索实体关系、获取可用属性列表、导航地理层级关系、检索实体名称和元数据

实体标识解析：通过 Resolve Endpoint 将地名、经纬度坐标、Wikidata ID 等（用户能理解的标识）转换为 Data Commons DCID（API 查询所需的标识符）

常见问题

Data Commons API 是免费的吗？

是的，Data Commons API 对公共数据查询免费开放，但需要注册获取 API 密钥。访问 apikeys.datacommons.org 即可申请。对于自定义的 Data Commons 实例，则无需 API 密钥。

如何开始使用统计数据？

典型工作流是：先通过 Resolve Endpoint 将地名转换为 DCID 标识符，然后通过 Observation Endpoint 查询统计变量数据。如果不确定有哪些统计变量可用，可以使用 fetch_available_statistical_variables() 方法先查看可用变量列表。

支持哪些类型的统计数据？

Data Commons 聚合了来自人口普查局、世界银行、卫生组织、环保机构等权威来源的数据，支持人口统计（Count_Person、Median_Age_Person）、经济指标（GDP、失业率、收入中位数）、健康数据（死亡率、疾病发病率）以及环境指标等多种统计变量。