TMDB 上的地区(regions)有两个方面需要解释。首先是新的 region 参数。

该 region 参数将作为过滤器,用于搜索和显示匹配的发行日期信息。此参数预期为 ISO 3166-1 代码。

例如,如果您正在搜索电影《爆裂鼓手》并希望显示德国发行日期(以配合德语翻译),您可以进行如下查询:

curl --request GET \
     --url 'https://api.themoviedb.org/3/search/movie?query=Whiplash&language=de-DE&region=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&region=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 仅充当过滤器,查找符合您筛选条件的任何电影,且这些电影至少有一个与您指定的国家匹配的发行日期。

发行类型

TypeRelease
1Premiere
2Theatrical (limited)
3Theatrical
4Digital
5Physical
6TV