TMDB 上的地区(regions)有两个方面需要解释。首先是新的 region 参数。
该 region 参数将作为过滤器,用于搜索和显示匹配的发行日期信息。此参数预期为 ISO 3166-1 代码。
例如,如果您正在搜索电影《爆裂鼓手》并希望显示德国发行日期(以配合德语翻译),您可以进行如下查询:
curl --request GET \
--url 'https://api.themoviedb.org/3/search/movie?query=Whiplash&language=de-DE®ion=DE' \
--header 'Authorization: Bearer ACCESS_TOKEN' \
--header 'accept: application/json'在此情况下,region 仅充当展示过滤器。如果我们没有您搜索国家的发行日期记录,我们将像往常一样默认返回主发行日期。这与不输入 region 参数的效果相同。
当 with_release_type 过滤器与 region 配合使用时,情况会变得非常精彩。假设您想查找本周在德国影院上映的电影。这很简单,我们现在可以构建如下查询:
curl --request GET \
--url 'https://api.themoviedb.org/3/discover/movie?language=de-DE®ion=DE&release_date.gte=2016-11-16&release_date.lte=2016-12-02&with_release_type=2|3' \
--header 'Authorization: Bearer ACCESS_TOKEN' \
--header 'accept: application/json'您当然可以在 我们的文档 中指定任何发行类型。如果在 discover 中使用 region 参数时未指定 with_release_type,则 region 仅充当过滤器,查找符合您筛选条件的任何电影,且这些电影至少有一个与您指定的国家匹配的发行日期。
发行类型
| Type | Release |
|---|---|
| 1 | Premiere |
| 2 | Theatrical (limited) |
| 3 | Theatrical |
| 4 | Digital |
| 5 | Physical |
| 6 | TV |