Class Venue


  • public class Venue
    extends ImageHolder
    Venue information bean.
    Author:
    Janni Kovacs
    • 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 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()
        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 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