Package 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
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description 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
getPhonenumber()
java.lang.String
getPostal()
java.lang.String
getStreet()
java.lang.String
getTimezone()
java.lang.String
getUrl()
Returns a last.fm URL to this venue, e.g.: http://www.last.fm/venue/<id>-<venue name>java.lang.String
getWebsite()
Returns an URL to the actual venue's website.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 de.umass.lastfm.ImageHolder
availableSizes, getImageURL, loadImages
-
-
-
-
Method Detail
-
getId
public java.lang.String getId()
-
getUrl
public java.lang.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 java.lang.String getWebsite()
Returns an URL to the actual venue's website.- Returns:
- website url
-
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()
-
getPhonenumber
public java.lang.String getPhonenumber()
-
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 forapiKey
- 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 forcountry
- Filter your results by country. Expressed as an ISO 3166-2 codeapiKey
- 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 forapiKey
- 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 forapiKey
- 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 forpage
- The page of results to returnapiKey
- A Last.fm API key- Returns:
- a paginated list of events
-
-