carto-find-spatial-data

carto-find-spatial-data

CARTO Data Observatory（DO） 是一个经过筛选的外部空间数据集目录，涵盖人口统计、兴趣点、环境数据、出行和金融等领域。你可以订阅这些数据集，并将其实体化到自己的数据仓库中。用户无需再费力寻找美国人口普查的 shapefile；这项技能会回答：“DO 中已经筛选好的哪些数据集能满足这里的需求？”

这项技能涵盖发现和订阅。订阅后，数据会存储在用户的数据仓库中，可以像查询其他表一样查询 — 参见 carto-query-datawarehouse。

访问路径路由。 如果已连接 CARTO MCP 服务，则通过 search_data_observatory（method: list_datasets|list_filters|search_variables|get_dataset|sample）进行发现 — 令牌认证会话也可使用；通过 manage_data_observatory_subscriptions（method: list|subscribe|unsubscribe）管理订阅，该操作需要 OAuth 会话。如果未连接服务、用于脚本化操作，或要从令牌会话订阅，请改用 carto do CLI。以下评估指南（覆盖范围、许可、更新频率）适用于所有路径。检测信号：carto-basics/references/access-paths.md。

何时使用这项技能

• 用户询问“人口统计”“兴趣点”“边界”“出行数据”“天气”或任何其他类别的外部空间数据。
• 用户拥有内部数据，并希望用外部背景信息对其进行丰富（例如，对其门店执行空间连接，以匹配人口普查区）。
• 用户想在决定是否付费订阅之前，先了解有哪些数据可用。

如果用户的数据仓库中已经有该数据集，请改用 carto-explore-datawarehouse — DO 用于获取新的外部数据。

快速参考

MCP（任何会话均可搜索；订阅需要 OAuth）：

search_data_observatory { method: "list_datasets", keyword: "census", country: "usa" }
search_data_observatory { method: "get_dataset", dataset_id }        # inspect before subscribing
manage_data_observatory_subscriptions { method: "list" }
manage_data_observatory_subscriptions { method: "subscribe", dataset_id, connection, destination }

CLI 备用方式（未连接服务／脚本化操作／令牌会话订阅）：

carto do search --keyword "census" --country usa --json
carto do get <dataset-id> --json
carto do subscriptions list --json
carto do subscribe <dataset-id> --connection carto_dw --destination my_project.do.census_tracts

这项技能的内容

主题	参考
发现：搜索、筛选和评估数据集	references/data-observatory.md
订阅：付费与免费、实体化、刷新、成本	references/subscribe.md

始终适用的指南

• 免费与付费：许多 DO 数据集免费（美国人口普查、基于 OpenStreetMap 的数据、NaturalEarth）。高级数据集（Spatial.ai、Mastercard、AirSage 等）需要 CARTO 订阅合同 — get_dataset / carto do get 会显示许可和定价层级。
• 订阅会将数据写入用户的数据仓库。 这不是远程视图 — 实际数据行会写入目标表，用户需为其支付数据仓库存储费用。请合理规划目标表命名。
• 需要空间扩展。 DO 数据集通常包含 H3 单元格／几何类型，这些内容依赖于在目标数据仓库中安装 CARTO 空间扩展。如果订阅失败并提示“找不到函数”，请检查是否已安装该扩展 — 参见 carto-manage-platform。
• 未检查前，不要推荐 DO 数据集（get_dataset / carto do get）。其元数据会显示覆盖范围（仅美国、仅欧盟、全球）、更新频率（每月、每年、实时）和许可信息 — 这些因素对判断是否适合用户的问题至关重要。
• DO 是外部数据；命名数据源是内部数据。 命名数据源（见 carto-explore-datawarehouse/references/named-sources.md）是用户保存的查询；DO 则是经过筛选的第三方数据目录。不要混淆两者。