Class: LastFM::Api::Venue

Inherits:
Object
  • Object
show all
Defined in:
lib/lastfm/api/venue.rb

Class Method Summary collapse

Class Method Details

.get_events(params) ⇒ Object

Get a list of upcoming events for a venue.

Parameters:

  • params (Hash) —

    a customizable set of options

Options Hash (params):

  • :venue (Fixnum, required) —

    the id for the venue to fetch event listings for

  • :festivalsonly (Boolean, optional) —

    whether only festivals should be returned, or all events

See Also:



11
12
13
 
# File 'lib/lastfm/api/venue.rb', line 11

def get_events( params )
  LastFM.get( "venue.getEvents", params )
end

.get_past_events(params) ⇒ Object

Get a paginated list of all the events held at this venue in the past.

Parameters:

  • params (Hash) —

    a customizable set of options

Options Hash (params):

  • :venue (Fixnum, required) —

    the id for the venue to fetch event listings for

  • :festivalsonly (Boolean, optional) —

    whether only festivals should be returned, or all events

  • :page (Fixnum, optional) —

    the page number to fetch. defaults to first page

  • :limit (Fixnum, optional) —

    the number of results to fetch per page. defaults to 50

See Also:



22
23
24
 
# File 'lib/lastfm/api/venue.rb', line 22

def get_past_events( params )
  LastFM.get( "venue.getPastEvents", params )
end

.search(params) ⇒ Object

Search for a venue by venue name.

Parameters:

  • params (Hash) —

    a customizable set of options

Options Hash (params):

  • :venue (String, required) —

    the venue name to search for

  • :country (String, optional) —

    a country name used to limit results, as defined by ISO 3166-1

  • :page (Fixnum, optional) —

    the page number to fetch. defaults to first page

  • :limit (Fixnum, optional) —

    the number of results to fetch per page. defaults to 50

See Also:



33
34
35
 
# File 'lib/lastfm/api/venue.rb', line 33

def search( params )
  LastFM.get( "venue.search", params )
end