Package de.umass.lastfm
Class Tag
- java.lang.Object
-
- de.umass.lastfm.Tag
-
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description int
compareTo(Tag o)
static java.util.List<Tag>
filter(java.util.Collection<Tag> tags, double percentage)
Filters tags from the given list; retains only those tags with a count higher than the given percentage of the total sum as fromgetTagCountSum(Collection)
.int
getCount()
static Tag
getInfo(java.lang.String tag, java.lang.String apiKey)
Gets the metadata for a tag.static Tag
getInfo(java.lang.String tag, java.util.Locale locale, java.lang.String apiKey)
Gets the metadata for a tag.java.lang.String
getName()
int
getReach()
static java.util.Collection<Tag>
getSimilar(java.lang.String tag, java.lang.String apiKey)
Search for tags similar to this one.static long
getTagCountSum(java.util.Collection<Tag> tags)
Returns the sum of allcount
elements in the results.int
getTaggings()
Returns the number of taggings of this specific tag.static java.util.Collection<Album>
getTopAlbums(java.lang.String tag, java.lang.String apiKey)
static java.util.Collection<Artist>
getTopArtists(java.lang.String tag, java.lang.String apiKey)
static java.util.Collection<Tag>
getTopTags(java.lang.String apiKey)
static java.util.Collection<Track>
getTopTracks(java.lang.String tag, java.lang.String apiKey)
java.lang.String
getUrl()
static Chart<Artist>
getWeeklyArtistChart(java.lang.String tag, int limit, java.lang.String apiKey)
static Chart<Artist>
getWeeklyArtistChart(java.lang.String tag, java.lang.String apiKey)
static Chart<Artist>
getWeeklyArtistChart(java.lang.String tag, java.lang.String from, java.lang.String to, int limit, java.lang.String apiKey)
static java.util.LinkedHashMap<java.lang.String,java.lang.String>
getWeeklyChartList(java.lang.String tag, java.lang.String apiKey)
static java.util.Collection<Chart>
getWeeklyChartListAsCharts(java.lang.String tag, java.lang.String apiKey)
java.util.Date
getWikiLastChanged()
java.lang.String
getWikiSummary()
java.lang.String
getWikiText()
boolean
isStreamable()
static java.util.Collection<Tag>
search(java.lang.String tag, int limit, java.lang.String apiKey)
static java.util.Collection<Tag>
search(java.lang.String tag, java.lang.String apiKey)
-
-
-
Method Detail
-
getCount
public int getCount()
-
getTaggings
public int getTaggings()
Returns the number of taggings of this specific tag. Alias forgetCount()
.- Returns:
- Number of Taggings
- See Also:
getInfo(String, String)
-
getName
public java.lang.String getName()
-
getUrl
public java.lang.String getUrl()
-
isStreamable
public boolean isStreamable()
-
getReach
public int getReach()
-
getWikiLastChanged
public java.util.Date getWikiLastChanged()
-
getWikiSummary
public java.lang.String getWikiSummary()
-
getWikiText
public java.lang.String getWikiText()
-
getTagCountSum
public static long getTagCountSum(java.util.Collection<Tag> tags)
Returns the sum of allcount
elements in the results.- Parameters:
tags
- a list of tags- Returns:
- the total count of all tags
-
filter
public static java.util.List<Tag> filter(java.util.Collection<Tag> tags, double percentage)
Filters tags from the given list; retains only those tags with a count higher than the given percentage of the total sum as fromgetTagCountSum(Collection)
.- Parameters:
tags
- list of tagspercentage
- cut off percentage- Returns:
- the filtered list of tags
-
getSimilar
public static java.util.Collection<Tag> getSimilar(java.lang.String tag, java.lang.String apiKey)
Search for tags similar to this one. Returns tags ranked by similarity, based on listening data.- Parameters:
tag
- The tag nameapiKey
- A Last.fm API key- Returns:
- a List of
Tag
s
-
getTopTags
public static java.util.Collection<Tag> getTopTags(java.lang.String apiKey)
-
getTopAlbums
public static java.util.Collection<Album> getTopAlbums(java.lang.String tag, java.lang.String apiKey)
-
getTopTracks
public static java.util.Collection<Track> getTopTracks(java.lang.String tag, java.lang.String apiKey)
-
getTopArtists
public static java.util.Collection<Artist> getTopArtists(java.lang.String tag, java.lang.String apiKey)
-
search
public static java.util.Collection<Tag> search(java.lang.String tag, java.lang.String apiKey)
-
search
public static java.util.Collection<Tag> search(java.lang.String tag, int limit, java.lang.String apiKey)
-
getWeeklyArtistChart
public static Chart<Artist> getWeeklyArtistChart(java.lang.String tag, java.lang.String apiKey)
-
getWeeklyArtistChart
public static Chart<Artist> getWeeklyArtistChart(java.lang.String tag, int limit, java.lang.String apiKey)
-
getWeeklyArtistChart
public static Chart<Artist> getWeeklyArtistChart(java.lang.String tag, java.lang.String from, java.lang.String to, int limit, java.lang.String apiKey)
-
getWeeklyChartList
public static java.util.LinkedHashMap<java.lang.String,java.lang.String> getWeeklyChartList(java.lang.String tag, java.lang.String apiKey)
-
getWeeklyChartListAsCharts
public static java.util.Collection<Chart> getWeeklyChartListAsCharts(java.lang.String tag, java.lang.String apiKey)
-
getInfo
public static Tag getInfo(java.lang.String tag, java.lang.String apiKey)
Gets the metadata for a tag.- Parameters:
tag
- The tag nameapiKey
- A Last.fm API key- Returns:
- Tag metdata such as Wiki Text, reach and tag count
-
getInfo
public static Tag getInfo(java.lang.String tag, java.util.Locale locale, java.lang.String apiKey)
Gets the metadata for a tag.- Parameters:
tag
- The tag namelocale
- The language to fetch info in, ornull
apiKey
- A Last.fm API key- Returns:
- Tag metdata such as Wiki Text, reach and tag count
-
-