de.umass.lastfm
Class Venue

java.lang.Object
  extended by de.umass.lastfm.ImageHolder
      extended by de.umass.lastfm.Venue

public class Venue
extends ImageHolder

Venue information bean.

Author:
Janni Kovacs

Field Summary
 
Fields inherited from class de.umass.lastfm.ImageHolder
imageUrls
 
Method Summary
 String getCity()
           
 String getCountry()
           
static Collection<Event> getEvents(String venueId, String apiKey)
          Get a list of upcoming events at this venue.
 String getId()
           
 float getLatitude()
           
 float getLongitude()
           
 String getName()
           
static PaginatedResult<Event> getPastEvents(String venueId, int page, String apiKey)
          Get a paginated list of all the events held at this venue in the past.
static PaginatedResult<Event> getPastEvents(String venueId, String apiKey)
          Get a paginated list of all the events held at this venue in the past.
 String getPhonenumber()
           
 String getPostal()
           
 String getStreet()
           
 String getTimezone()
           
 String getUrl()
          Returns a last.fm URL to this venue, e.g.: http://www.last.fm/venue/<id>-<venue name>
 String getWebsite()
          Returns an URL to the actual venue's website.
static Collection<Venue> search(String venue, String apiKey)
          Search for a venue by venue name.
static Collection<Venue> search(String venue, String country, String apiKey)
          Search for a venue by venue name.
 
Methods inherited from class de.umass.lastfm.ImageHolder
availableSizes, getImageURL, loadImages
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Method Detail

getId

public String getId()

getUrl

public String getUrl()
Returns a last.fm URL to this venue, e.g.: http://www.last.fm/venue/<id>-<venue name>

Returns:
last.fm url
See Also:
getWebsite()

getWebsite

public String getWebsite()
Returns an URL to the actual venue's website.

Returns:
website url

getCity

public String getCity()

getCountry

public String getCountry()

getLatitude

public float getLatitude()

getLongitude

public float getLongitude()

getName

public String getName()

getPostal

public String getPostal()

getStreet

public String getStreet()

getTimezone

public String getTimezone()

getPhonenumber

public String getPhonenumber()

search

public static Collection<Venue> search(String venue,
                                       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 Collection<Venue> search(String venue,
                                       String country,
                                       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 Collection<Event> getEvents(String venueId,
                                          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(String venueId,
                                                   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(String venueId,
                                                   int page,
                                                   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