1\name{getTrends}
2\alias{getTrends}
3\alias{availableTrendLocations}
4\alias{closestTrendLocations}
5\title{
6Functions to view Twitter trends
7}
8\description{
9  These functions will allow you to interact with the trend portion of
10  the Twitter API
11}
12\usage{
13  availableTrendLocations(...)
14  closestTrendLocations(lat, long, ...)
15  getTrends(woeid, exclude=NULL, ...)
16}
17\arguments{
18  \item{woeid}{A numerical identification code describing a location, a  Yahoo! Where On Earth ID}
19  \item{lat}{A numerical latitude value, between -180 and 180 inclusive. West is negative, East is positive}
20  \item{long}{A numerical longitude value, between -180 and 180 inclusive. South is negative, North is positive}
21  \item{exclude}{If set to \code{hashtags}, will exclude hashtags}
22  \item{...}{Additional arguments to be passed to RCurl}
23}
24\details{
25  The \code{availableTrendLocations} and \code{closestTrendLocations} functions will return a
26  data.frame with three columns - \code{name}, \code{country} and \code{woeid}. The \code{closestTrendLocations}
27  function will return the locations closest to the specified latitude and longitude.
28
29  The \code{getTrends} function takes a specified woeid and returns the trending topics associated
30  with that woeid. It returns a data.frame with the columns being \code{name}, \code{url},
31  \code{promoted_content}, \code{query} and \code{woeid} - one row per trend.
32}
33\value{
34A data.frame with the columns specified in \code{Details} above
35}
36\author{
37Jeff Gentry
38}
39\examples{
40  \dontrun{
41    woeid = availableTrendLocations[1, "woeid"]
42    t1 <- getTrends(woeid)
43  }
44}
45\keyword{interface}
46