net.roarsoftware.lastfm
Class Venue

java.lang.Object
  extended by net.roarsoftware.lastfm.Venue

public class Venue
extends java.lang.Object

Venue information bean.

Author:
Janni Kovacs

Method Summary
 java.lang.String getCity()
           
 java.lang.String getCountry()
           
static java.util.Collection<Event> getEvents(java.lang.String venueId, java.lang.String apiKey)
          Get a list of upcoming events at this venue.
 java.lang.String getId()
           
 float getLatitude()
           
 float getLongitude()
           
 java.lang.String getName()
           
static PaginatedResult<Event> getPastEvents(java.lang.String venueId, int page, java.lang.String apiKey)
          Get a paginated list of all the events held at this venue in the past.
static PaginatedResult<Event> getPastEvents(java.lang.String venueId, java.lang.String apiKey)
          Get a paginated list of all the events held at this venue in the past.
 java.lang.String getPostal()
           
 java.lang.String getStreet()
           
 java.lang.String getTimezone()
           
 java.lang.String getUrl()
           
static java.util.Collection<Venue> search(java.lang.String venue, java.lang.String apiKey)
          Search for a venue by venue name.
static java.util.Collection<Venue> search(java.lang.String venue, java.lang.String country, java.lang.String apiKey)
          Search for a venue by venue name.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Method Detail

getId

public java.lang.String getId()

getUrl

public java.lang.String getUrl()

getCity

public java.lang.String getCity()

getCountry

public java.lang.String getCountry()

getLatitude

public float getLatitude()

getLongitude

public float getLongitude()

getName

public java.lang.String getName()

getPostal

public java.lang.String getPostal()

getStreet

public java.lang.String getStreet()

getTimezone

public java.lang.String getTimezone()

search

public static java.util.Collection<Venue> search(java.lang.String venue,
                                                 java.lang.String apiKey)
Search for a venue by venue name.

Parameters:
venue - The venue name you would like to search for
apiKey - A Last.fm API key
Returns:
a list of venues

search

public static java.util.Collection<Venue> search(java.lang.String venue,
                                                 java.lang.String country,
                                                 java.lang.String apiKey)
Search for a venue by venue name.

Parameters:
venue - The venue name you would like to search for
country - Filter your results by country. Expressed as an ISO 3166-2 code
apiKey - A Last.fm API key
Returns:
a list of venues

getEvents

public static java.util.Collection<Event> getEvents(java.lang.String venueId,
                                                    java.lang.String apiKey)
Get a list of upcoming events at this venue.

Parameters:
venueId - The venue id to fetch the events for
apiKey - A Last.fm API key
Returns:
a list of events
See Also:
getPastEvents(java.lang.String, java.lang.String)

getPastEvents

public static PaginatedResult<Event> getPastEvents(java.lang.String venueId,
                                                   java.lang.String apiKey)
Get a paginated list of all the events held at this venue in the past.

Parameters:
venueId - The id for the venue you would like to fetch event listings for
apiKey - A Last.fm API key
Returns:
a paginated list of events

getPastEvents

public static PaginatedResult<Event> getPastEvents(java.lang.String venueId,
                                                   int page,
                                                   java.lang.String apiKey)
Get a paginated list of all the events held at this venue in the past.

Parameters:
venueId - The id for the venue you would like to fetch event listings for
page - The page of results to return
apiKey - A Last.fm API key
Returns:
a paginated list of events