用途:为 Data Commons 提供 Python API v2 访问能力,Data Commons 是将人口普查、健康、环境等权威来源统计数据聚合为统一知识图谱的平台。适合查询统计观测值、探索图谱实体关系、解析实体标识符。
主要能力:包含三类端点。Observation 端点查询时间序列统计,如人口、失业率、收入等,支持 date="latest"、"all" 或指定年份,支持按层级表达式批量查询;Node 端点探索知识图谱,如获取实体属性标签、导航地理父子层级、获取实体名称;Resolve 端点将名称、坐标或 Wikidata ID 转换为 DCID。所有观测响应可与 Pandas 集成,转换为 DataFrame。
使用方式:安装后从 datacommons_client 导入 DataCommonsClient 初始化。典型流程为先解析实体名称得到 DCID,再查询可用统计变量,然后拉取数据并处理结果。访问 datacommons.org 需 API key,可通过环境变量 DC_API_KEY 或初始化参数传入,申请地址为 https://apikeys.datacommons.org/;自定义实例无需 key,可传入 url 参数。安装命令:pip install "datacommons-client[Pandas]",仅基础使用:pip install datacommons-client。
适用场景:跨地区统计比较、历史趋势分析、按行政区层级汇总、实体关系查询与数据源一致性筛选。
限制:公开资料未提供具体收费、价格、性能指标或数据覆盖完整度信息;默认服务需 API key,使用前需确认数据可用性。官方文档见 https://docs.datacommons.org/api/python/v2/。