com.omertron.themoviedbapi.model

Class Discover

java.lang.Object

com.omertron.themoviedbapi.model.Discover

public class Discover
extends Object

Generate a discover object for use in the MovieDbApi

This allows you to just add the search components you are concerned with

Author:

stuart.boston

Constructor Summary

Constructors

Constructor and Description
Discover()

Method Summary

Methods

Modifier and Type	Method and Description
Discover	certificationCountry(String certificationCountry) Only include movies with certifications for a specific country.
Discover	certificationLte(String certificationLte) Only include movies with this certification and lower.
TmdbParameters	getParams() Get the parameters This will be used to construct the URL in the API
Discover	includeAdult(boolean includeAdult) Toggle the inclusion of adult titles
Discover	language(String language) ISO 639-1 code
Discover	page(int page) Minimum value is 1 if included.
Discover	primaryReleaseYear(int primaryReleaseYear) Filter the results so that only the primary release date year has this value
Discover	releaseDateGte(String releaseDateGte) The minimum release to include.
Discover	releaseDateLte(String releaseDateLte) The maximum release to include.
Discover	sortBy(String sortBy) Available options are vote_average.desc vote_average.asc release_date.desc release_date.asc popularity.desc popularity.asc
Discover	voteAverageGte(float voteAverageGte) Only include movies that are equal to, or have a higher average rating than this value
Discover	voteCountGte(int voteCountGte) Only include movies that are equal to, or have a vote count higher than this value
Discover	withCompanies(String withCompanies) Filter movies to include a specific company.
Discover	withGenres(String withGenres) Only include movies with the specified genres.
Discover	year(int year) Filter the results release dates to matches that include this value.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Discover

public Discover()

Method Detail

getParams

public TmdbParameters getParams()

Get the parameters

This will be used to construct the URL in the API

Returns:

page

public Discover page(int page)

Minimum value is 1 if included.

Parameters:

page -

Returns:

language

public Discover language(String language)

ISO 639-1 code

Parameters:

language -

Returns:

sortBy

public Discover sortBy(String sortBy)

Available options are
vote_average.desc
vote_average.asc
release_date.desc
release_date.asc
popularity.desc
popularity.asc

Parameters:

sortBy -

Returns:

includeAdult

public Discover includeAdult(boolean includeAdult)

Toggle the inclusion of adult titles

Parameters:

includeAdult -

Returns:

year

public Discover year(int year)

Filter the results release dates to matches that include this value.

Parameters:

year -

Returns:

primaryReleaseYear

public Discover primaryReleaseYear(int primaryReleaseYear)

Filter the results so that only the primary release date year has this value

Parameters:

primaryReleaseYear -

Returns:

voteCountGte

public Discover voteCountGte(int voteCountGte)

Only include movies that are equal to, or have a vote count higher than this value

Parameters:

voteCountGte -

Returns:

voteAverageGte

public Discover voteAverageGte(float voteAverageGte)

Only include movies that are equal to, or have a higher average rating than this value

Parameters:

voteAverageGte -

Returns:

withGenres

public Discover withGenres(String withGenres)

Only include movies with the specified genres.

Expected value is an integer (the id of a genre).

Multiple values can be specified.

Comma separated indicates an 'AND' query, while a pipe (|) separated value indicates an 'OR'

Parameters:

withGenres -

Returns:

releaseDateGte

public Discover releaseDateGte(String releaseDateGte)

The minimum release to include.

Expected format is YYYY-MM-DD.

Parameters:

releaseDateGte -

Returns:

releaseDateLte

public Discover releaseDateLte(String releaseDateLte)

The maximum release to include.

Expected format is YYYY-MM-DD.

Parameters:

releaseDateLte -

Returns:

certificationCountry

public Discover certificationCountry(String certificationCountry)

Only include movies with certifications for a specific country.

When this value is specified, 'certificationLte' is required.

A ISO 3166-1 is expected

Parameters:

certificationCountry -

Returns:

certificationLte

public Discover certificationLte(String certificationLte)

Only include movies with this certification and lower.

Expected value is a valid certification for the specified 'certificationCountry'.

Parameters:

certificationLte -

Returns:

withCompanies

public Discover withCompanies(String withCompanies)

Filter movies to include a specific company.

Expected value is an integer (the id of a company).

They can be comma separated to indicate an 'AND' query

Parameters:

withCompanies -

Returns: