winterwell.jtwitter

Class Twitter_Geo

java.lang.Object

winterwell.jtwitter.Twitter_Geo

All Implemented Interfaces:

com.winterwell.jgeoplanet.IGeoCode

public class Twitter_Geo
extends java.lang.Object
implements com.winterwell.jgeoplanet.IGeoCode

Twitter's geolocation support. Use Twitter.geo() to get one of these objects.

Conceptually, this is an extension of Twitter. The methods are here because Twitter was getting crowded.

See Also:

Twitter.setMyLocation(double[]), Twitter.setSearchLocation(double, double, String), Status.getLocation()

Method Summary

Modifier and Type	Method and Description
java.util.List	geoSearch(double latitude, double longitude)
java.util.List<Place>	geoSearch(java.lang.String query)
java.util.List	geoSearchByIP(java.lang.String ipAddress)
java.util.Map<com.winterwell.jgeoplanet.IPlace,java.lang.Double>	getPlace(com.winterwell.jgeoplanet.GeoCodeQuery query)
Place	getPlace(java.lang.String locationDescription) Returns the best-guess IPlace whose name matches the query to some extent.
java.util.List<Place>	getTrendRegions()
java.lang.Boolean	matches(com.winterwell.jgeoplanet.GeoCodeQuery query, com.winterwell.jgeoplanet.IPlace place)
void	setAccuracy(double metres)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

geoSearch

public java.util.List geoSearch(double latitude,
                                double longitude)

geoSearch

public java.util.List<Place> geoSearch(java.lang.String query)

geoSearchByIP

public java.util.List geoSearchByIP(java.lang.String ipAddress)

getTrendRegions

public java.util.List<Place> getTrendRegions()

Parameters:

woeid -

Returns:

regions from which you can get trending info

See Also:

Twitter.getTrends(Number)

setAccuracy

public void setAccuracy(double metres)

getPlace

public Place getPlace(java.lang.String locationDescription)

Description copied from interface: com.winterwell.jgeoplanet.IGeoCode

Returns the best-guess IPlace whose name matches the query to some extent.

Specified by:

getPlace in interface com.winterwell.jgeoplanet.IGeoCode

Parameters:

locationDescription - Must not be null or empty *

Returns:

place for the description, or null

getPlace

public java.util.Map<com.winterwell.jgeoplanet.IPlace,java.lang.Double> getPlace(com.winterwell.jgeoplanet.GeoCodeQuery query)

Specified by:

getPlace in interface com.winterwell.jgeoplanet.IGeoCode

Returns:

Map of candidate results, with the relative confidence. Confidence is a score in the 0-1 range. It doesn't have any definite meaning (though we might informally think of it as like a probability).

E.g. a query for "Paris" might return {Paris-France: 0.98, Paris-Texas: 0.1, other: 0.1}

Can be empty, never null.

matches

public java.lang.Boolean matches(com.winterwell.jgeoplanet.GeoCodeQuery query,
                                 com.winterwell.jgeoplanet.IPlace place)

Specified by:

matches in interface com.winterwell.jgeoplanet.IGeoCode

Parameters:

query - Cannot be null.

place - Cannot be null.

Returns:

true if place fits this query, e.g. London is in the UK, false if it doesn't. null if we don't know