# 上海曹家渡建筑信息数据集 (Shanghai Caojiadu Buildings Dataset)

> 面向 AI agent 的机器可读、结构化建筑信息数据集。覆盖上海市静安区**曹家渡**地区（静安、普陀、长宁三区交界，苏州河沿岸近代纺织/工业与商业集散地）的楼宇：中英文名称、地址、建成年代、层数、结构、用途、状态、经纬度坐标、历史沿革与出处。当前约 8 栋建筑，每周按年持续补充。

## 适合哪些 agent / 任务 (Why pay)
- 上海城市史、建筑遗产、里弄与工业遗产研究
- 苏州河沿岸 GIS / 地理编码 / 坐标标注
- 房地产 / 选址 / 区域画像 的本地建筑背景数据
- 中国地方史 / 文旅 / 问答 的事实性结构化来源 (含出处字段, 可溯源)

## 数据访问
- [免费样本预览](/preview): 样本记录 + 总量 (先看后付)
- [全量数据集](/dataset/caojiadu): 付费 0.01 USDC/次, 走 x402 (HTTP 402 + USDC on Base 主网实时结算)
- [单条建筑](/dataset/caojiadu/{id}): 按 id 取单条 (付费)
- [数据集清单 ai-dataset](/.well-known/ai-dataset): 完整 schema / 覆盖范围 / 标签
- [OpenAPI 描述](/openapi.json)

## 每条记录字段 (schema)
`name_cn, name_en, address, year_built, building_type, structure, floors, status, lat, lon, description, sources`

## 如何付费 (x402)
1. GET /dataset/caojiadu → 返回 HTTP 402 + payment-required 挑战 (eip155:8453, 0.01 USDC)
2. 用你的钱包在 Base 主网签名 0.01 USDC 支付授权
3. 带支付凭证重发 → 回源返回全量建筑 JSON

## 说明
- 付费协议: x402 (开放的机器对机器支付标准, USDC on Base 主网实时结算, 无需账号/订阅)
- 更新频率: 每周 (按年补充近代与现代建筑, 数据持续变厚)
- 规范域名: https://data.samye.world
- 关键词: Shanghai, Caojiadu, 曹家渡, Jing'an, Suzhou Creek, 苏州河, buildings, 建筑, GIS, heritage, 历史建筑, 工业遗产, 里弄, urban-history, x402, paid dataset