anitabi 中文文档 下载 App

给定 Bangumi Subject ID,怎么拿到一部作品的全部巡礼地标

先确认 Bangumi Subject ID

每部作品在番组计划 bangumi.tv 上有唯一的 Subject ID:

https://bangumi.tv/subject/{subjectID}

这个 Subject ID 就是调 Anitabi API 的唯一参数。比如:

端点 1:轻量版 /lite

GET https://api.anitabi.cn/bangumi/115908/lite

适合快速展示某作品的巡礼概览,不需要完整地标列表时:

{
    "id": 115908,
    "cn": "吹响吧!上低音号",
    "title": "響け!ユーフォニアム",
    "city": "宇治市",
    "cover": "https://image.anitabi.cn/bangumi/115908.jpg?plan=h160",
    "color": "#02a7bd",
    "geo": [34.90646037778022, 135.81221398475236],
    "zoom": 12.383488825333831,
    "modified": 1674702846652,
    "litePoints": [
        {
            "id": "qys7fu",
            "cn": "京都音乐厅",
            "name": "京都コンサートホール",
            "image": "https://image.anitabi.cn/points/115908/qys7fu.jpg?plan=h160",
            "ep": 1,
            "s": 1,
            "geo": [35.0503, 135.7664]
        }
    ],
    "pointsLength": 388,
    "imagesLength": 388
}

关键字段说明:

端点 2:完整详情 /points/detail

GET https://api.anitabi.cn/bangumi/115908/points/detail

适合需要全部地标时调用。返回数组,每个地标:

[
    {
        "id": "5qypywi9",
        "name": "第二箸別バス停前(箸別駅西側)",
        "image": "https://image.anitabi.cn/points/126461/5qypywi9.jpg?plan=h160",
        "ep": 1,
        "s": 282,
        "geo": [43.8578, 141.5462],
        "origin": "Google Maps",
        "originURL": "https://www.google.com/maps/d/viewer?mid=1hkF1issn0oVQDeN4BIrBPp5b5Ek..."
    }
]

额外有两个有用的 QueryString:

常见问题

Subject ID 传错了会怎样

返回空对象或 404——先确认 Bangumi 上真的有这个 Subject 条目。

怎么知道作品在 Anitabi 上有没有地标

调 /lite 端点,如果 pointsLength = 0 说明该作品在 Anitabi 上还没有地标贡献。

geo 数组的顺序

geo 是 [纬度, 经度],和 Google Maps 的坐标系一致。

快速验证

直接在浏览器地址栏输入:

就能看到原始 JSON 返回。