|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectde.umass.lastfm.Geo
public class Geo
Provides nothing more than a namespace for the API methods starting with geo.
Nested Class Summary | |
---|---|
static class |
Geo.Metro
This inner class represents a Metro, which is composed of its name and the name of its country. |
Method Summary | |
---|---|
static Collection<Event> |
getAllEvents(String location,
String distance,
String apiKey)
Get all events in a specific location by country or city name. This method returns all events by subsequently calling getEvents(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,
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(String location,
String distance,
int page,
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(String location,
String distance,
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,
String start,
String end,
String apiKey)
|
static Chart<Artist> |
getMetroArtistChart(String country,
String metro,
String apiKey)
|
static Chart<Artist> |
getMetroArtistChart(String country,
String metro,
String start,
String end,
String apiKey)
|
static Chart<Artist> |
getMetroHypeArtistChart(Geo.Metro metro,
String start,
String end,
String apiKey)
|
static Chart<Artist> |
getMetroHypeArtistChart(String country,
String metro,
String apiKey)
|
static Chart<Artist> |
getMetroHypeArtistChart(String country,
String metro,
String start,
String end,
String apiKey)
|
static Chart<Track> |
getMetroHypeTrackChart(Geo.Metro metro,
String start,
String end,
String apiKey)
|
static Chart<Track> |
getMetroHypeTrackChart(String country,
String metro,
String apiKey)
|
static Chart<Track> |
getMetroHypeTrackChart(String country,
String metro,
String start,
String end,
String apiKey)
|
static Collection<Geo.Metro> |
getMetros(String apiKey)
Get a list of valid countries and Geo.Metro s for use in the other webservices. |
static Collection<Geo.Metro> |
getMetros(String country,
String apiKey)
Get a list of valid countries and Geo.Metro s for use in the other webservices. |
static Chart<Track> |
getMetroTrackChart(Geo.Metro metro,
String start,
String end,
String apiKey)
|
static Chart<Track> |
getMetroTrackChart(String country,
String metro,
String apiKey)
|
static Chart<Track> |
getMetroTrackChart(String country,
String metro,
String start,
String end,
String apiKey)
|
static Chart<Artist> |
getMetroUniqueArtistChart(Geo.Metro metro,
String start,
String end,
String apiKey)
|
static Chart<Artist> |
getMetroUniqueArtistChart(String country,
String metro,
String apiKey)
|
static Chart<Artist> |
getMetroUniqueArtistChart(String country,
String metro,
String start,
String end,
String apiKey)
|
static Chart<Track> |
getMetroUniqueTrackChart(Geo.Metro metro,
String start,
String end,
String apiKey)
|
static Chart<Track> |
getMetroUniqueTrackChart(String country,
String metro,
String apiKey)
|
static Chart<Track> |
getMetroUniqueTrackChart(String country,
String metro,
String start,
String end,
String apiKey)
|
static LinkedHashMap<String,String> |
getMetroWeeklyChartList(String metro,
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 Collection<Artist> |
getTopArtists(String country,
String apiKey)
Get the most popular artists on Last.fm by country |
static Collection<Track> |
getTopTracks(String country,
String apiKey)
Get the most popular tracks on Last.fm by country |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Method Detail |
---|
public static Collection<Event> getAllEvents(String location, String distance, String apiKey)
getEvents(String, String, int, String)
and concatenating the single results into one list.
location
- Specifies a location to retrieve events fordistance
- Find events within a specified distanceapiKey
- A Last.fm API key.
public static PaginatedResult<Event> getEvents(String location, String distance, String apiKey)
PaginatedResult.getTotalPages()
and subsequently
call getEvents(String, String, int, String)
with the successive page numbers.
location
- Specifies a location to retrieve events fordistance
- Find events within a specified distanceapiKey
- A Last.fm API key.
PaginatedResult
containing a list of eventspublic static PaginatedResult<Event> getEvents(String location, String distance, int page, String apiKey)
location
- Specifies a location to retrieve events fordistance
- Find events within a specified distancepage
- A page number for paginationapiKey
- A Last.fm API key.
PaginatedResult
containing a list of eventspublic static PaginatedResult<Event> getEvents(double latitude, double longitude, int page, String apiKey)
latitude
- Latitudelongitude
- Longitudepage
- A page number for paginationapiKey
- A Last.fm API key.
PaginatedResult
containing a list of eventspublic static Collection<Artist> getTopArtists(String country, String apiKey)
country
- A country name, as defined by the ISO 3166-1 country names standardapiKey
- A Last.fm API key.
public static Collection<Track> getTopTracks(String country, String apiKey)
country
- A country name, as defined by the ISO 3166-1 country names standardapiKey
- A Last.fm API key.
public static Collection<Geo.Metro> getMetros(String apiKey)
Geo.Metro
s for use in the other webservices.
apiKey
- A Last.fm API key
Geo.Metro
spublic static Collection<Geo.Metro> getMetros(String country, String apiKey)
Geo.Metro
s for use in the other webservices.
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
Geo.Metro
spublic static LinkedHashMap<String,String> getMetroWeeklyChartList(String metro, String apiKey)
metro
- The name of the metro, or null
apiKey
- A Last.fm API key
public static Chart<Artist> getMetroArtistChart(String country, String metro, String apiKey)
public static Chart<Artist> getMetroArtistChart(Geo.Metro metro, String start, String end, String apiKey)
public static Chart<Artist> getMetroArtistChart(String country, String metro, String start, String end, String apiKey)
public static Chart<Track> getMetroTrackChart(String country, String metro, String apiKey)
public static Chart<Track> getMetroTrackChart(Geo.Metro metro, String start, String end, String apiKey)
public static Chart<Track> getMetroTrackChart(String country, String metro, String start, String end, String apiKey)
public static Chart<Artist> getMetroHypeArtistChart(String country, String metro, String apiKey)
public static Chart<Artist> getMetroHypeArtistChart(Geo.Metro metro, String start, String end, String apiKey)
public static Chart<Artist> getMetroHypeArtistChart(String country, String metro, String start, String end, String apiKey)
public static Chart<Track> getMetroHypeTrackChart(String country, String metro, String apiKey)
public static Chart<Track> getMetroHypeTrackChart(Geo.Metro metro, String start, String end, String apiKey)
public static Chart<Track> getMetroHypeTrackChart(String country, String metro, String start, String end, String apiKey)
public static Chart<Artist> getMetroUniqueArtistChart(String country, String metro, String apiKey)
public static Chart<Artist> getMetroUniqueArtistChart(Geo.Metro metro, String start, String end, String apiKey)
public static Chart<Artist> getMetroUniqueArtistChart(String country, String metro, String start, String end, String apiKey)
public static Chart<Track> getMetroUniqueTrackChart(String country, String metro, String apiKey)
public static Chart<Track> getMetroUniqueTrackChart(Geo.Metro metro, String start, String end, String apiKey)
public static Chart<Track> getMetroUniqueTrackChart(String country, String metro, String start, String end, String apiKey)
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |