给定 Bangumi Subject ID,怎么拿到一部作品的全部巡礼地标
先确认 Bangumi Subject ID
每部作品在番组计划 bangumi.tv 上有唯一的 Subject ID:
https://bangumi.tv/subject/{subjectID}
这个 Subject ID 就是调 Anitabi API 的唯一参数。比如:
- 《吹响吧!上低音号》Bangumi 链接 bangumi.tv/subject/115908 → Subject ID = 115908
- 《你的名字。》Bangumi 链接 bangumi.tv/subject/139870 → Subject ID = 139870
端点 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
}
关键字段说明:
city:地标最多的城市(可能为空)color:作品主色(用于地图展示)geo+zoom:Anitabi 地图打开该作品时的默认视角litePoints:前 10 个标志性地标(不是全部)pointsLength:全部地标总数imagesLength:有截图的地标数
端点 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:
?haveImage=true:只返回有截图的地标?bangumiId=xxx:配合地图 URL 直接打开
常见问题
Subject ID 传错了会怎样
返回空对象或 404——先确认 Bangumi 上真的有这个 Subject 条目。
怎么知道作品在 Anitabi 上有没有地标
调 /lite 端点,如果 pointsLength = 0 说明该作品在 Anitabi 上还没有地标贡献。
geo 数组的顺序
geo 是 [纬度, 经度],和 Google Maps 的坐标系一致。
快速验证
直接在浏览器地址栏输入:
https://api.anitabi.cn/bangumi/115908/litehttps://api.anitabi.cn/bangumi/115908/points/detail?haveImage=true
就能看到原始 JSON 返回。