用途:该技能提供对 Data Commons Python API v2 的访问,用于查询聚合自全球公开来源(普查、卫生、环境等机构)的统计数据,并探索知识图谱。适用于拉取国家、州、县、城市的人口、经济、健康、教育、环境等统计,构建跨地区或时间序列对比,以及将地名、坐标、Wikidata ID 解析为 Data Commons DCID。
主要能力:Observation 端点查询时间序列统计,支持 date="latest"、date="all" 及层级表达式;Node 端点探索实体属性、地理层级(如 fetch_place_children)、实体名称;Resolve 端点按名称、坐标、Wikidata ID 解析实体。常用变量如 Count_Person、UnemploymentRate_Person、Median_Income_Household。
使用方式:安装客户端 uv pip install "datacommons-client[pandas]"(基础版 uv pip install datacommons-client)。调用 datacommons.org 时 observation 与 node 查询需 API 密钥,设置 DC_API_KEY 或初始化时传入,密钥在 https://apikeys.datacommons.org/ 申请;自定义实例无需密钥。典型流程为先解析实体、再查询数据、最后用 to_dict()、to_observation_records().model_dump() 或 observations_dataframe() 处理。脚本用法:python scripts/query_datacommons.py observe Count_Person geoId/06 --date latest。
注意事项:本技能为 V2 客户端(datacommons_client),与旧版 datacommons(V1) API 不同,不可混用;关键字参数名称须准确。特定 FRED 序列、美国财政部财政数据、NCI 影像 Data Commons、空间连接或地图几何应改用其他技能。Python 需 ≥ 3.10。