Roastbook 开放咖啡馆数据集
数据集简介
这份数据是什么
Roastbook Open Coffee Data 面向任何希望复用咖啡馆信息的使用者,提供一份开放的咖啡馆与精品咖啡馆名录。数据集以慕尼黑为起点,收录供应咖啡的场所,并对每家店的位置、营业时间、咖啡供应方式等属性做结构化记录。每条记录都带有核查时间,方便使用者分辨信息的新旧程度。
数据遵循 Open Coffee Schema,字段组织与命名保持一致,便于跨城市、跨国家拼接与比对。
快速上手
主数据按城市组织,路径形如 datasets/coffee-places/<country>/<city>.json,文件内包含 $schema、meta 与 places[] 三部分:meta 承载该城市的元信息,places[] 则是逐家咖啡馆的记录数组。
除主数据外,仓库还提供三份配套参考数据:
datasets/brew-methods/brew-methods.json:冲泡方法清单datasets/pour-patterns/pour-patterns.json:注水配方datasets/distribution-methods/distribution-methods.json:分配方法清单
需要其他格式时,可在 data.roastbook.coffee 的下载页获取按城市拆分的 NDJSON 与 GeoJSON,以及覆盖全部场所的单个 GeoParquet 与单个 CSV 文件;/artifacts/index.json 提供产物索引。
仓库结构
仓库以目录分层组织内容,主数据与参考数据各占独立目录:
| 目录/文件 | 内容 |
|---|---|
datasets/coffee-places/<country>/<city>.json |
按国家、城市存放的咖啡馆主数据 |
datasets/brew-methods/brew-methods.json |
冲泡方法 |
datasets/pour-patterns/pour-patterns.json |
注水配方 |
datasets/distribution-methods/distribution-methods.json |
分配方法 |
/artifacts/index.json |
构建产物索引 |
当前收录 266 个咖啡馆,其中 Tier A 23 个、Tier B 23 个、非精品咖啡馆 220 个;覆盖城市 1 个;配套数据包含冲泡方法 21 种、注水配方 37 个、分配方法 7 种。
版本与稳定性
数据集按版本发布,发布日期为 2026 年 11 月 6 日。结构化记录采用 JSON 及其衍生格式(NDJSON、GeoJSON、GeoParquet、CSV)分发,字段定义以 Open Coffee Schema 为准,便于使用者在版本更新时对照字段变化。
参与贡献
仓库欢迎外部贡献,贡献流程与规范随仓库一并提供。新增或修订咖啡馆记录时,应保持与 Open Coffee Schema 一致的字段结构,并为每条记录标注核查时间。
许可说明
数据以 CDLA-Permissive-2.0 许可发布,代码以 MIT 许可发布。使用者可在遵守相应许可条款的前提下复用、分发与再加工数据与代码。