Package slash.navigation.geonames

Class GeoNamesService

java.lang.Object

slash.navigation.geocoding.BaseGeocodingService

slash.navigation.geonames.GeoNamesService

All Implemented Interfaces:

ElevationService, GeocodingService

public class GeoNamesService
extends BaseGeocodingService
implements ElevationService

Encapsulates REST access to the geonames.org service.

Author:

Christian Pesch

Constructor Summary

Constructors

Constructor	Description
GeoNamesService()

Method Summary

Modifier and Type	Method	Description
long	calculateRemainingDownloadSize(List<MapDescriptor> mapDescriptors)
void	downloadElevationData(List<MapDescriptor> mapDescriptors)
void	downloadElevationDataFor(List<LongitudeAndLatitude> longitudeAndLatitudes, boolean waitForDownload)
String	getAddressFor(NavigationPosition position)	Retrieves an address for a given NavigationPosition.
Map<BoundingBox,Boolean>	getCoverageTiles(BoundingBox area)
File	getDirectory()
Double	getElevationFor(double longitude, double latitude)
String	getName()
String	getPath()
List<GeocodingResult>	getPositionsFor(String address)	Retrieves a list of GeocodingResults for a given address.
boolean	isDownload()
boolean	isOverQueryLimit()
void	setPath(String path)

Methods inherited from class slash.navigation.geocoding.BaseGeocodingService

asGeocodingResults, asGeocodingResults

Methods inherited from class java.lang.Object

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

Constructor Details

GeoNamesService

public GeoNamesService()

Method Details

getName

public String getName()

Specified by:

getName in interface ElevationService

Specified by:

getName in interface GeocodingService

isOverQueryLimit

public boolean isOverQueryLimit()

Specified by:

isOverQueryLimit in interface ElevationService

Specified by:

isOverQueryLimit in interface GeocodingService

getElevationFor

public Double getElevationFor(double longitude,
 double latitude)
                       throws IOException

Specified by:

getElevationFor in interface ElevationService

Throws:

IOException

getPositionsFor

public List<GeocodingResult> getPositionsFor(String address)

Description copied from interface: GeocodingService

Retrieves a list of GeocodingResults for a given address.

Specified by:

getPositionsFor in interface GeocodingService

Parameters:

address - the address to geocode

Returns:

a list of GeocodingResults for the given address

getAddressFor

public String getAddressFor(NavigationPosition position)
                     throws IOException

Description copied from interface: GeocodingService

Retrieves an address for a given NavigationPosition.

Specified by:

getAddressFor in interface GeocodingService

Parameters:

position - the NavigationPosition to reverse geocode the address

Returns:

an address for the given NavigationPosition

Throws:

IOException - if the request fails

isDownload

public boolean isDownload()

Specified by:

isDownload in interface ElevationService

Specified by:

isDownload in interface GeocodingService

getPath

public String getPath()

Specified by:

getPath in interface ElevationService

setPath

public void setPath(String path)

Specified by:

setPath in interface ElevationService

getDirectory

public File getDirectory()

Specified by:

getDirectory in interface ElevationService

downloadElevationDataFor

public void downloadElevationDataFor(List<LongitudeAndLatitude> longitudeAndLatitudes,
 boolean waitForDownload)

Specified by:

downloadElevationDataFor in interface ElevationService

calculateRemainingDownloadSize

public long calculateRemainingDownloadSize(List<MapDescriptor> mapDescriptors)

Specified by:

calculateRemainingDownloadSize in interface ElevationService

downloadElevationData

public void downloadElevationData(List<MapDescriptor> mapDescriptors)

Specified by:

downloadElevationData in interface ElevationService

getCoverageTiles

public Map<BoundingBox,Boolean> getCoverageTiles(BoundingBox area)

Specified by:

getCoverageTiles in interface ElevationService