|
|||||||||
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. |
static PaginatedResult<Event> |
getEvents(double latitude,
double longitude,
int page,
int limit,
String apiKey)
|
static PaginatedResult<Event> |
getEvents(double latitude,
double longitude,
int page,
String apiKey)
Get all events in a specific location by latitude/longitude. |
static PaginatedResult<Event> |
getEvents(double latitude,
double longitude,
String distance,
int page,
int limit,
String apiKey)
Get all events within the specified distance of the location specified by latitude/longitude. |
static PaginatedResult<Event> |
getEvents(double latitude,
double longitude,
String distance,
String apiKey)
|
static PaginatedResult<Event> |
getEvents(String location,
String distance,
int page,
int limit,
String apiKey)
|
static PaginatedResult<Event> |
getEvents(String location,
String distance,
int page,
String apiKey)
Get all events in a specific location by country or city name. |
static PaginatedResult<Event> |
getEvents(String location,
String distance,
String apiKey)
Get all events in a specific location by country or city name. |
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(String location, String distance, int page, int limit, String apiKey)
public 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 PaginatedResult<Event> getEvents(double latitude, double longitude, int page, int limit, String apiKey)
public static PaginatedResult<Event> getEvents(double latitude, double longitude, String distance, String apiKey)
public static PaginatedResult<Event> getEvents(double latitude, double longitude, String distance, int page, int limit, String apiKey)
latitude
- Latitudelongitude
- Longitudedistance
- Distance from the specified locationpage
- A page number for paginationlimit
- The maximum number of items returned per pageapiKey
- 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 |