Package de.umass.lastfm
Class Geo
- java.lang.Object
-
- de.umass.lastfm.Geo
-
public class Geo extends java.lang.Object
Provides nothing more than a namespace for the API methods starting with geo.- Author:
- Janni Kovacs
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static class
Geo.Metro
This inner class represents a Metro, which is composed of its name and the name of its country.
-
Method Summary
All Methods Static Methods Concrete Methods Modifier and Type Method Description static java.util.Collection<Event>
getAllEvents(java.lang.String location, java.lang.String distance, java.lang.String apiKey)
Get all events in a specific location by country or city name.
This method returns all events by subsequently callinggetEvents(String, String, int, String)
and concatenating the single results into one list.
Pay attention if you use this method as it may produce a lot of network traffic and therefore may consume a long time.static PaginatedResult<Event>
getEvents(double latitude, double longitude, int page, java.lang.String apiKey)
Get all events in a specific location by country or city name.
This method only returns the specified page of a paginated result.static PaginatedResult<Event>
getEvents(java.lang.String location, java.lang.String distance, int page, java.lang.String apiKey)
Get all events in a specific location by country or city name.
This method only returns the specified page of a paginated result.static PaginatedResult<Event>
getEvents(java.lang.String location, java.lang.String distance, java.lang.String apiKey)
Get all events in a specific location by country or city name.
This method only returns the first page of a possibly paginated result.static Chart<Artist>
getMetroArtistChart(Geo.Metro metro, java.lang.String start, java.lang.String end, java.lang.String apiKey)
static Chart<Artist>
getMetroArtistChart(java.lang.String country, java.lang.String metro, java.lang.String apiKey)
static Chart<Artist>
getMetroArtistChart(java.lang.String country, java.lang.String metro, java.lang.String start, java.lang.String end, java.lang.String apiKey)
static Chart<Artist>
getMetroHypeArtistChart(Geo.Metro metro, java.lang.String start, java.lang.String end, java.lang.String apiKey)
static Chart<Artist>
getMetroHypeArtistChart(java.lang.String country, java.lang.String metro, java.lang.String apiKey)
static Chart<Artist>
getMetroHypeArtistChart(java.lang.String country, java.lang.String metro, java.lang.String start, java.lang.String end, java.lang.String apiKey)
static Chart<Track>
getMetroHypeTrackChart(Geo.Metro metro, java.lang.String start, java.lang.String end, java.lang.String apiKey)
static Chart<Track>
getMetroHypeTrackChart(java.lang.String country, java.lang.String metro, java.lang.String apiKey)
static Chart<Track>
getMetroHypeTrackChart(java.lang.String country, java.lang.String metro, java.lang.String start, java.lang.String end, java.lang.String apiKey)
static java.util.Collection<Geo.Metro>
getMetros(java.lang.String apiKey)
Get a list of valid countries andGeo.Metro
s for use in the other webservices.static java.util.Collection<Geo.Metro>
getMetros(java.lang.String country, java.lang.String apiKey)
Get a list of valid countries andGeo.Metro
s for use in the other webservices.static Chart<Track>
getMetroTrackChart(Geo.Metro metro, java.lang.String start, java.lang.String end, java.lang.String apiKey)
static Chart<Track>
getMetroTrackChart(java.lang.String country, java.lang.String metro, java.lang.String apiKey)
static Chart<Track>
getMetroTrackChart(java.lang.String country, java.lang.String metro, java.lang.String start, java.lang.String end, java.lang.String apiKey)
static Chart<Artist>
getMetroUniqueArtistChart(Geo.Metro metro, java.lang.String start, java.lang.String end, java.lang.String apiKey)
static Chart<Artist>
getMetroUniqueArtistChart(java.lang.String country, java.lang.String metro, java.lang.String apiKey)
static Chart<Artist>
getMetroUniqueArtistChart(java.lang.String country, java.lang.String metro, java.lang.String start, java.lang.String end, java.lang.String apiKey)
static Chart<Track>
getMetroUniqueTrackChart(Geo.Metro metro, java.lang.String start, java.lang.String end, java.lang.String apiKey)
static Chart<Track>
getMetroUniqueTrackChart(java.lang.String country, java.lang.String metro, java.lang.String apiKey)
static Chart<Track>
getMetroUniqueTrackChart(java.lang.String country, java.lang.String metro, java.lang.String start, java.lang.String end, java.lang.String apiKey)
static java.util.LinkedHashMap<java.lang.String,java.lang.String>
getMetroWeeklyChartList(java.lang.String metro, java.lang.String apiKey)
Get a list of available chart periods for this metro, expressed as date ranges which can be sent to the chart services.static java.util.Collection<Artist>
getTopArtists(java.lang.String country, java.lang.String apiKey)
Get the most popular artists on Last.fm by countrystatic java.util.Collection<Track>
getTopTracks(java.lang.String country, java.lang.String apiKey)
Get the most popular tracks on Last.fm by country
-
-
-
Method Detail
-
getAllEvents
public static java.util.Collection<Event> getAllEvents(java.lang.String location, java.lang.String distance, java.lang.String apiKey)
Get all events in a specific location by country or city name.
This method returns all events by subsequently callinggetEvents(String, String, int, String)
and concatenating the single results into one list.
Pay attention if you use this method as it may produce a lot of network traffic and therefore may consume a long time.- Parameters:
location
- Specifies a location to retrieve events fordistance
- Find events within a specified distanceapiKey
- A Last.fm API key.- Returns:
- a list containing all events
-
getEvents
public static PaginatedResult<Event> getEvents(java.lang.String location, java.lang.String distance, java.lang.String apiKey)
Get all events in a specific location by country or city name.
This method only returns the first page of a possibly paginated result. To retrieve all pages get the total number of pages viaPaginatedResult.getTotalPages()
and subsequently callgetEvents(String, String, int, String)
with the successive page numbers.- Parameters:
location
- Specifies a location to retrieve events fordistance
- Find events within a specified distanceapiKey
- A Last.fm API key.- Returns:
- a
PaginatedResult
containing a list of events
-
getEvents
public static PaginatedResult<Event> getEvents(java.lang.String location, java.lang.String distance, int page, java.lang.String apiKey)
Get all events in a specific location by country or city name.
This method only returns the specified page of a paginated result.- Parameters:
location
- Specifies a location to retrieve events fordistance
- Find events within a specified distancepage
- A page number for paginationapiKey
- A Last.fm API key.- Returns:
- a
PaginatedResult
containing a list of events
-
getEvents
public static PaginatedResult<Event> getEvents(double latitude, double longitude, int page, java.lang.String apiKey)
Get all events in a specific location by country or city name.
This method only returns the specified page of a paginated result.- Parameters:
latitude
- Latitudelongitude
- Longitudepage
- A page number for paginationapiKey
- A Last.fm API key.- Returns:
- a
PaginatedResult
containing a list of events
-
getTopArtists
public static java.util.Collection<Artist> getTopArtists(java.lang.String country, java.lang.String apiKey)
Get the most popular artists on Last.fm by country- Parameters:
country
- A country name, as defined by the ISO 3166-1 country names standardapiKey
- A Last.fm API key.- Returns:
- list of Artists
-
getTopTracks
public static java.util.Collection<Track> getTopTracks(java.lang.String country, java.lang.String apiKey)
Get the most popular tracks on Last.fm by country- Parameters:
country
- A country name, as defined by the ISO 3166-1 country names standardapiKey
- A Last.fm API key.- Returns:
- a list of Tracks
-
getMetros
public static java.util.Collection<Geo.Metro> getMetros(java.lang.String apiKey)
Get a list of valid countries andGeo.Metro
s for use in the other webservices.- Parameters:
apiKey
- A Last.fm API key- Returns:
- a List of
Geo.Metro
s
-
getMetros
public static java.util.Collection<Geo.Metro> getMetros(java.lang.String country, java.lang.String apiKey)
Get a list of valid countries andGeo.Metro
s for use in the other webservices.- Parameters:
country
- Optionally restrict the results to those Metros from a particular country, as defined by the ISO 3166-1 country names standardapiKey
- A Last.fm API key- Returns:
- a List of
Geo.Metro
s
-
getMetroWeeklyChartList
public static java.util.LinkedHashMap<java.lang.String,java.lang.String> getMetroWeeklyChartList(java.lang.String metro, java.lang.String apiKey)
Get a list of available chart periods for this metro, expressed as date ranges which can be sent to the chart services.- Parameters:
metro
- The name of the metro, ornull
apiKey
- A Last.fm API key- Returns:
- a list of available charts as a Map
-
getMetroArtistChart
public static Chart<Artist> getMetroArtistChart(java.lang.String country, java.lang.String metro, java.lang.String apiKey)
-
getMetroArtistChart
public static Chart<Artist> getMetroArtistChart(Geo.Metro metro, java.lang.String start, java.lang.String end, java.lang.String apiKey)
-
getMetroArtistChart
public static Chart<Artist> getMetroArtistChart(java.lang.String country, java.lang.String metro, java.lang.String start, java.lang.String end, java.lang.String apiKey)
-
getMetroTrackChart
public static Chart<Track> getMetroTrackChart(java.lang.String country, java.lang.String metro, java.lang.String apiKey)
-
getMetroTrackChart
public static Chart<Track> getMetroTrackChart(Geo.Metro metro, java.lang.String start, java.lang.String end, java.lang.String apiKey)
-
getMetroTrackChart
public static Chart<Track> getMetroTrackChart(java.lang.String country, java.lang.String metro, java.lang.String start, java.lang.String end, java.lang.String apiKey)
-
getMetroHypeArtistChart
public static Chart<Artist> getMetroHypeArtistChart(java.lang.String country, java.lang.String metro, java.lang.String apiKey)
-
getMetroHypeArtistChart
public static Chart<Artist> getMetroHypeArtistChart(Geo.Metro metro, java.lang.String start, java.lang.String end, java.lang.String apiKey)
-
getMetroHypeArtistChart
public static Chart<Artist> getMetroHypeArtistChart(java.lang.String country, java.lang.String metro, java.lang.String start, java.lang.String end, java.lang.String apiKey)
-
getMetroHypeTrackChart
public static Chart<Track> getMetroHypeTrackChart(java.lang.String country, java.lang.String metro, java.lang.String apiKey)
-
getMetroHypeTrackChart
public static Chart<Track> getMetroHypeTrackChart(Geo.Metro metro, java.lang.String start, java.lang.String end, java.lang.String apiKey)
-
getMetroHypeTrackChart
public static Chart<Track> getMetroHypeTrackChart(java.lang.String country, java.lang.String metro, java.lang.String start, java.lang.String end, java.lang.String apiKey)
-
getMetroUniqueArtistChart
public static Chart<Artist> getMetroUniqueArtistChart(java.lang.String country, java.lang.String metro, java.lang.String apiKey)
-
getMetroUniqueArtistChart
public static Chart<Artist> getMetroUniqueArtistChart(Geo.Metro metro, java.lang.String start, java.lang.String end, java.lang.String apiKey)
-
getMetroUniqueArtistChart
public static Chart<Artist> getMetroUniqueArtistChart(java.lang.String country, java.lang.String metro, java.lang.String start, java.lang.String end, java.lang.String apiKey)
-
getMetroUniqueTrackChart
public static Chart<Track> getMetroUniqueTrackChart(java.lang.String country, java.lang.String metro, java.lang.String apiKey)
-
getMetroUniqueTrackChart
public static Chart<Track> getMetroUniqueTrackChart(Geo.Metro metro, java.lang.String start, java.lang.String end, java.lang.String apiKey)
-
-