de.monarchy.guideme.util
Interface POI

All Superinterfaces:
java.io.Serializable
All Known Subinterfaces:
WebPOI
All Known Implementing Classes:
PointOfInterest, RoutePoint, WikipediaArticle

public interface POI
extends java.io.Serializable

POI declares a general named location. Every location that needs to be described, should implement this interface.

Author:
dstuerze

Method Summary
 java.lang.String getDescription()
          Returns a description of the location in a String.
 double getLatitude()
          Returns the latitude of this location.
 GeoCoordinate getLocation()
          Returns the position of this location in form of a GeoCoordinate.
 double getLongitude()
          Returns the longitude of this location..
 View getView(Context c)
          Returns a graphic version of this point of interest.
 

Method Detail

getDescription

java.lang.String getDescription()
Returns a description of the location in a String.

Returns:
short description

getLatitude

double getLatitude()
Returns the latitude of this location. Values are supposed to range from -90. to +90. with positive values denoting locations on the northern hemisphere.

Returns:
latitude in degrees from -90 to 90

getLongitude

double getLongitude()
Returns the longitude of this location.. Values are supposed to range from -180. to +180. with positve values denoting a position east of Greenwich and negative ones positions in the west.

Returns:
longitude in degrees from -180 to 180

getLocation

GeoCoordinate getLocation()
Returns the position of this location in form of a GeoCoordinate. It contains information about latitude and longitude in an encoding matching this one's.

Returns:
GeoCoordinate with the location

getView

View getView(Context c)
Returns a graphic version of this point of interest. If the POI does not have a particular view, this method will return null. Calling components therefore need to check that.

Parameters:
c - application context
Returns:
view of this POI or null, if none exists