Class: LastFM::Geo

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

Class Method Summary collapse

Class Method Details

.get_events(params) ⇒ Object

Get all events in a specific location by country or city name.

Parameters:

  • params (Hash) —

    a customizable set of options

Options Hash (params):

  • :location (String, optional) —

    location to retrieve events for

  • :lat (String, optional) —

    latitude value to retrieve events for

  • :long (String, optional) —

    longitude value to retrieve events for

  • :distance (Fixnum, optional) —

    find events within a specified radius (in kilometres)

  • :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:



14
15
16
 
# File 'lib/lastfm/geo.rb', line 14

def get_events( params )
  LastFM.get( "geo.getEvents", !:secure, params )
end

.get_metro_artist_chart(params) ⇒ Object

Get a chart of artists for a metro.

Parameters:

  • params (Hash) —

    a customizable set of options

Options Hash (params):

  • :country (String, required) —

    a country name, as defined by ISO 3166-1

  • :metro (String, required) —

    the metro’s name

  • :start (Time, optional) —

    beginning timestamp of the weekly range requested (see: Geo.get_weekly_chart_list)

  • :end (Time, optional) —

    ending timestamp of the weekly range requested (see: Geo.get_weekly_chart_list)

See Also:



25
26
27
 
# File 'lib/lastfm/geo.rb', line 25

def get_metro_artist_chart( params )
  LastFM.get( "geo.getMetroArtistChart", params )
end

.get_metro_hype_artist_chart(params) ⇒ Object

Get a chart of hyped (up and coming) artists for a metro.

Parameters:

  • params (Hash) —

    a customizable set of options

Options Hash (params):

  • :country (String, required) —

    a country name, as defined by ISO 3166-1

  • :metro (String, required) —

    the metro’s name

  • :start (Time, optional) —

    beginning timestamp of the weekly range requested (see: Geo.get_weekly_chart_list)

  • :end (Time, optional) —

    ending timestamp of the weekly range requested (see: Geo.get_weekly_chart_list)

See Also:



36
37
38
 
# File 'lib/lastfm/geo.rb', line 36

def get_metro_hype_artist_chart( params )
  LastFM.get( "geo.getMetroHypeArtistChart", params )
end

.get_metro_hype_track_chart(params) ⇒ Object

Get a chart of hyped (up and coming) tracks for a metro.

Parameters:

  • params (Hash) —

    a customizable set of options

Options Hash (params):

  • :country (String, required) —

    a country name, as defined by ISO 3166-1

  • :metro (String, required) —

    the metro’s name

  • :start (Time, optional) —

    beginning timestamp of the weekly range requested (see: Geo.get_weekly_chart_list)

  • :end (Time, optional) —

    ending timestamp of the weekly range requested (see: Geo.get_weekly_chart_list)

See Also:



47
48
49
 
# File 'lib/lastfm/geo.rb', line 47

def get_metro_hype_track_chart( params )
  LastFM.get( "geo.getMetroHypeTrackChart", params )
end

.get_metro_track_chart(params) ⇒ Object

Get a chart of tracks for a metro.

Parameters:

  • params (Hash) —

    a customizable set of options

Options Hash (params):

  • :country (String, required) —

    a country name, as defined by ISO 3166-1

  • :metro (String, required) —

    the metro’s name

  • :start (Time, optional) —

    beginning timestamp of the weekly range requested (see: Geo.get_weekly_chart_list)

  • :end (Time, optional) —

    ending timestamp of the weekly range requested (see: Geo.get_weekly_chart_list)

See Also:



58
59
60
 
# File 'lib/lastfm/geo.rb', line 58

def get_metro_track_chart( params )
  LastFM.get( "geo.getMetroTrackChart", params )
end

.get_metro_unique_artist_chart(params) ⇒ Object

Get a chart of the artists which make that metro unique

Parameters:

  • params (Hash) —

    a customizable set of options

Options Hash (params):

  • :country (String, required) —

    a country name, as defined by ISO 3166-1

  • :metro (String, required) —

    the metro’s name

  • :start (Time, optional) —

    beginning timestamp of the weekly range requested (see: Geo.get_weekly_chart_list)

  • :end (Time, optional) —

    ending timestamp of the weekly range requested (see: Geo.get_weekly_chart_list)

See Also:



69
70
71
 
# File 'lib/lastfm/geo.rb', line 69

def get_metro_unique_artist_chart( params )
  LastFM.get( "geo.getMetroUniqueArtistChart", params )
end

.get_metro_unique_track_chart(params) ⇒ Object

Get a chart of the tracks which make that metro unique

Parameters:

  • params (Hash) —

    a customizable set of options

Options Hash (params):

  • :country (String, required) —

    a country name, as defined by ISO 3166-1

  • :metro (String, required) —

    the metro’s name

  • :start (Time, optional) —

    beginning timestamp of the weekly range requested (see: Geo.get_weekly_chart_list)

  • :end (Time, optional) —

    ending timestamp of the weekly range requested (see: Geo.get_weekly_chart_list)

See Also:



80
81
82
 
# File 'lib/lastfm/geo.rb', line 80

def get_metro_unique_track_chart( params )
  LastFM.get( "geo.getMetroUniqueTrackChart", params )
end

.get_metro_weekly_chartlist(params) ⇒ Object

Get a list of available chart periods for this metro, expressed as date ranges which can be sent to the chart services.

Parameters:

  • params (Hash) —

    a customizable set of options

Options Hash (params):

  • :metro (String, required) —

    metro name to fetch the charts list for

See Also:



88
89
90
 
# File 'lib/lastfm/geo.rb', line 88

def get_metro_weekly_chartlist( params )
  LastFM.get( "geo.getMetroWeeklyChartlist", params )
end

.get_metros(params) ⇒ Object

Get a list of valid countries and metros for use in the other webservices

Parameters:

  • params (Hash) —

    a customizable set of options

Options Hash (params):

  • :country (String, optional) —

    restrict results to metros from a particular country, as defined by ISO 3166-1

See Also:



96
97
98
 
# File 'lib/lastfm/geo.rb', line 96

def get_metros( params )
  LastFM.get( "geo.getMetros", params )
end

.get_top_artists(params) ⇒ Object

Get the most popular artists on Last.fm by country

Parameters:

  • params (Hash) —

    a customizable set of options

Options Hash (params):

  • :country (String, required) —

    a country name, 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:



106
107
108
 
# File 'lib/lastfm/geo.rb', line 106

def get_top_artists( params )
  LastFM.get( "geo.getTopArtists", params )
end

.get_top_tracks(params) ⇒ Object

Get the most popular tracks on Last.fm by country

Parameters:

  • params (Hash) —

    a customizable set of options

Options Hash (params):

  • :country (String, required) —

    a country name, as defined by ISO 3166-1

  • :location (String, optional) —

    location to fetch the charts for

  • :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:



117
118
119
 
# File 'lib/lastfm/geo.rb', line 117

def get_top_tracks( params )
  LastFM.get( "geo.getTopTracks", params )
end