まずは成果物。
https://suggestmovie.netlify.app
このアプリを作るに至った経緯
こんな経験ありませんか??
- ネットフリックスを開いたは良いものの、中々決められずに2時間半が経った。
- 製作国や公開年でも絞り込みたい。
- 観ようとした映画が自分の登録しているサブスクに無かった。
上記のような悩みから、次のようなアプリを作りたいと考えました。
- 映画選びをサポートするアプリ
- 配信サービスを絞り込める
- 単純に一覧表示するのではなく、映画が一つずつ出てきて気に入れば右スワイプ、興味なければ左スワイプ、みたいにしたら楽しそう
同じ悩みを持っている方は、ぜひ一度使ってみて下さい。↓↓
シネマピッカー
そして、些細なことでも構いませんので改善要望を頂けると幸いです!
仕様とプログラムの詳細
ここから先は、TMDB APIの使い方を知りたい人向けの内容です。
OR条件、AND条件を使用でき、高度な絞り込みができます。
そもそもなぜTMDB APIを選んだのか
次の条件を満たしているAPIがTMDBくらいしか無かったからです。(他にあればコメントで教えてください!)
- 配信サービスを指定できること。
- 対象地域も指定できること。
(日本とネトフリとアメリカのネトフリでは視聴可能な作品が異なるため) - 取得できる情報が日本語であること。
- 無料であること。
APIの仕様
今回はTMDB APIの中でも、「Discover」というAPIを使用します。
各パラメータの仕様
- include_adult
- 条件
成人向けコンテンツの取得可否 - 値
trueもしくはfalse
- 条件
- include_video
- 条件
TMDBに予告編が有るか - 値
trueもしくはfalse
- 条件
- language
- 条件
取得結果の言語 - 値
ISOの国名コード ※大文字
- 条件
- page
- 条件
取得結果のうち何ページ目を取得するか
※このAPIでは、一度のリクエストで最大20件取得できます。
つまり、pageでは検索結果のうち、「1」を指定すると1件目から20件目 - 値
数値(整数)
- 条件
- primary_release_year
- 条件
主要公開年
※日本での公開年とは別です。 - 値
数値(整数4ケタ)
- 条件
- primary_release_date.gte
- 条件
主要公開年(下限)
※日本での公開年とは別です。 - 値
数値(整数4ケタ)
- 条件
- primary_release_date.lte
- 条件
主要公開年(上限)
※日本での公開年とは別です。 - 値
数値(整数4ケタ)
- 条件
- region
- 条件
映画が公開されている地域
※取得結果のソートに関係してきます。
例えば、ソートを人気順に指定している場合、このパラメーターで指定した地域での人気順となります。
※取得結果の「公開日」に関係してきます。
指定しない場合:主要公開日
指定した場合:その地域での公開日 - 値
ISOの国名コード ※大文字
- 条件
- release_date.gte
- 条件
公開日(下限) - 値
yyyy-MM--dd
- 条件
- release_date.lte
- 条件
公開日(上限) - 値
yyyy-MM-dd
- 条件
- release_date.gte
- 条件
公開日(下限) - 値
数値(整数4ケタ)
- 条件
- sort_by
- 条件
ソート - 値
リファレンスのsort_byを参照
※regionと組み合わせることが可能
- 条件
- vote_average.gte
- 条件
平均投票スコア(下限)
※TMDBでのユーザースコア - 値
浮動小数
- 条件
- vote_average.lte
- 条件
平均投票スコア(上限) - 値
浮動小数
※TMDBでのユーザースコア
- 条件
- vote_count.gte
- 条件
ユーザースコアの投票数(下限) - 値
浮動小数
- 条件
- vote_count.lte
- 条件
ユーザースコアの投票数(上限) - 値
浮動小数
- 条件
- watch_region
- 条件
視聴可能地域
※with_watch_providers、with_watch_monetization_typesと組み合わせて使用可能 - 値
ISOの国名コード
- 条件