de.umass.lastfm
Class Venue

java.lang.Object
  de.umass.lastfm.ImageHolder
      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, boolean festivalsOnly, String apiKey) Get a list of upcoming events at this venue.
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, boolean festivalsOnly, int page, int limit, 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)

getEvents

public static Collection<Event> getEvents(String venueId,
                                          boolean festivalsOnly,
                                          String apiKey)

Get a list of upcoming events at this venue.

Parameters:

venueId - The venue id to fetch the events for

festivalsOnly - Whether only festivals should be returned, or all events

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,
                                                   boolean festivalsOnly,
                                                   int page,
                                                   int limit,
                                                   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

festivalsOnly - Whether only festivals should be returned, or all events.

page - The page of results to return

limit - The number of results to fetch per page.

apiKey - A Last.fm API key

Returns:

a paginated list of events