45 lines
2.6 KiB
Plaintext
45 lines
2.6 KiB
Plaintext
//tag::ref-doc[]
|
|
= Twitter Trend and Trend Locations Processor
|
|
|
|
Processor that can return either trending topic or the Locations of the trending topics.
|
|
The `twitter.trend.trend-query-type` property allow to select the query type.
|
|
|
|
== Retrieve trending topic in a location (optionally)
|
|
|
|
For this mode set `twitter.trend.trend-query-type` to `trend`.
|
|
|
|
Processor based on https://developer.twitter.com/en/docs/trends/trends-for-location/api-reference/get-trends-place[Trends API].
|
|
Returns the https://help.twitter.com/en/using-twitter/twitter-trending-faqs[trending topics] near a specific latitude, longitude location.
|
|
|
|
== Retrieve trend Locations
|
|
|
|
For this mode set `twitter.trend.trend-query-type` to `trendLocation`.
|
|
|
|
Retrieve a full or nearby locations list of trending topics by location.
|
|
|
|
If the `latitude`, `longitude` parameters are NOT provided the processor performs the https://developer.twitter.com/en/docs/trends/locations-with-trending-topics/api-reference/get-trends-available[Trends Available API] and returns the locations that Twitter has trending topic information for.
|
|
|
|
If the `latitude`, `longitude` parameters are provided the processor performs the https://developer.twitter.com/en/docs/trends/locations-with-trending-topics/api-reference/get-trends-closest[Trends Closest API] and returns the locations that Twitter has trending topic information for, closest to a specified location.
|
|
|
|
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.
|
|
|
|
== Options
|
|
|
|
//tag::configuration-properties[]
|
|
Properties grouped by prefix:
|
|
|
|
|
|
=== twitter.trend.closest
|
|
|
|
$$lat$$:: $$If provided with a long parameter the available trend locations will be sorted by distance, nearest to furthest, to the co-ordinate pair. The valid ranges for longitude is -180.0 to +180.0 (West is negative, East is positive) inclusive.$$ *($$Expression$$, default: `$$<none>$$`)*
|
|
$$lon$$:: $$If provided with a lat parameter the available trend locations will be sorted by distance, nearest to furthest, to the co-ordinate pair. The valid ranges for longitude is -180.0 to +180.0 (West is negative, East is positive) inclusive.$$ *($$Expression$$, default: `$$<none>$$`)*
|
|
|
|
=== twitter.trend
|
|
|
|
$$location-id$$:: $$The Yahoo! Where On Earth ID of the location to return trending information for. Global information is available by using 1 as the WOEID.$$ *($$Expression$$, default: `$$payload$$`)*
|
|
$$trend-query-type$$:: $$<documentation missing>$$ *($$TrendQueryType$$, default: `$$<none>$$`, possible values: `trend`,`trendLocation`)*
|
|
//end::configuration-properties[]
|
|
|
|
//end::ref-doc[]
|
|
|