twitter4j.api

Interface TrendsResources

All Known Subinterfaces:

Twitter

public interface TrendsResources

Since:

Twitter4J 2.1.3

Author:

Yusuke Yamamoto - yusuke at mac.com

Method Summary

Methods

Modifier and Type	Method and Description
ResponseList<Location>	getAvailableTrends() Returns the locations that Twitter has trending topic information for.
ResponseList<Location>	getAvailableTrends(GeoLocation location) Deprecated. use getClosestTrends(twitter4j.GeoLocation) instead
ResponseList<Location>	getClosestTrends(GeoLocation location) Returns the locations that Twitter has trending topic information for, closest to a specified location. The response is an array of "locations" that encode the location's WOEID and some other human-readable information such as a canonical name and country the location belongs in. A WOEID is a Yahoo! Where On Earth ID.
Trends	getLocationTrends(int woeid) Deprecated. use getPlaceTrends(int) instead
Trends	getPlaceTrends(int woeid) Returns the top 10 trending topics for a specific WOEID, if trending information is available for it. The response is an array of "trend" objects that encode the name of the trending topic, the query parameter that can be used to search for the topic on Twitter Search, and the Twitter Search URL. This information is cached for 5 minutes.

Method Detail

getLocationTrends

Trends getLocationTrends(int woeid)
                         throws TwitterException

Deprecated. use getPlaceTrends(int) instead

Returns the top 10 trending topics for a specific WOEID, if trending information is available for it.
The response is an array of "trend" objects that encode the name of the trending topic, the query parameter that can be used to search for the topic on Twitter Search, and the Twitter Search URL.
This information is cached for 5 minutes. Requesting more frequently than that will not return any more data, and will count against your rate limit usage.

This method calls http://api.twitter.com/1.1/trends/place.json

Parameters:

woeid - The Yahoo! Where On Earth ID of the location to return trending information for. Global information is available by using 1 as the WOEID.

Returns:

trends

Throws:

TwitterException - when Twitter service or network is unavailable

Since:

Twitter4J 2.1.1

See Also:

GET trends/place | Twitter Developers

getPlaceTrends

Trends getPlaceTrends(int woeid)
                      throws TwitterException

Returns the top 10 trending topics for a specific WOEID, if trending information is available for it.
The response is an array of "trend" objects that encode the name of the trending topic, the query parameter that can be used to search for the topic on Twitter Search, and the Twitter Search URL.
This information is cached for 5 minutes. Requesting more frequently than that will not return any more data, and will count against your rate limit usage.

This method calls http://api.twitter.com/1.1/trends/place.json

Parameters:

woeid - The Yahoo! Where On Earth ID of the location to return trending information for. Global information is available by using 1 as the WOEID.

Returns:

trends

Throws:

TwitterException - when Twitter service or network is unavailable

Since:

Twitter4J 3.0.2

See Also:

GET trends/place | Twitter Developers

getAvailableTrends

ResponseList<Location> getAvailableTrends()
                                          throws TwitterException

Returns the locations that Twitter has trending topic information for. The response is an array of "locations" that encode the location's WOEID (a Yahoo! Where On Earth ID) and some other human-readable information such as a canonical name and country the location belongs in.
This method calls http://api.twitter.com/1.1/trends/available.json

Returns:

the locations

Throws:

TwitterException - when Twitter service or network is unavailable

Since:

Twitter4J 2.1.1

See Also:

GET trends/available | Twitter Developers

getAvailableTrends

ResponseList<Location> getAvailableTrends(GeoLocation location)
                                          throws TwitterException

Deprecated. use getClosestTrends(twitter4j.GeoLocation) instead

Returns the sorted locations that Twitter has trending topic information for. The response is an array of "locations" that encode the location's WOEID (a Yahoo! Where On Earth ID) and some other human-readable information such as a canonical name and country the location belongs in.
This method calls http://api.twitter.com/1/trends/available.json

Parameters:

location - the available trend locations will be sorted by distance to the lat and long passed in. The sort is nearest to furthest.

Returns:

the locations

Throws:

TwitterException - when Twitter service or network is unavailable

Since:

Twitter4J 2.1.1

See Also:

GET trends/available | Twitter Developers

getClosestTrends

ResponseList<Location> getClosestTrends(GeoLocation location)
                                        throws TwitterException

Returns the locations that Twitter has trending topic information for, closest to a specified location.
The response is an array of "locations" that encode the location's WOEID and some other human-readable information such as a canonical name and country the location belongs in.
A WOEID is a Yahoo! Where On Earth ID.
This method calls http://api.twitter.com/1.1/trends/closest.json

Parameters:

location - the available trend locations will be sorted by distance to the lat and long passed in. The sort is nearest to furthest.

Returns:

the locations

Throws:

TwitterException - when Twitter service or network is unavailable

Since:

Twitter4J 3.0.2

See Also:

GET trends/closest | Twitter Developers