com.bericotech.clavin.gazetteer.query

Class LuceneGazetteer

java.lang.Object

com.bericotech.clavin.gazetteer.query.LuceneGazetteer

All Implemented Interfaces:

Gazetteer

public class LuceneGazetteer
extends Object
implements Gazetteer

An implementation of Gazetteer that uses Lucene to rapidly search known locations.

Constructor Summary

Constructors

Constructor and Description
LuceneGazetteer(File indexDir) Builds a LuceneGazetteer by loading a pre-built Lucene index from disk and setting configuration parameters for resolving location names to GeoName objects.

Method Summary

Methods

Modifier and Type	Method and Description
List<ResolvedLocation>	getClosestLocations(GazetteerQuery query) Execute a query against the Lucene gazetteer index using the provided configuration, returning the top matches as ResolvedLocations.
GeoName	getGeoName(int geonameId) Retrieves the GeoName with the provided ID.

Methods inherited from class java.lang.Object

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

Constructor Detail

LuceneGazetteer

public LuceneGazetteer(File indexDir)
                throws ClavinException

Builds a LuceneGazetteer by loading a pre-built Lucene index from disk and setting configuration parameters for resolving location names to GeoName objects.

Parameters:

indexDir - Lucene index directory to be loaded

Throws:

ClavinException - if an error occurs opening the index

Method Detail

getClosestLocations

public List<ResolvedLocation> getClosestLocations(GazetteerQuery query)
                                           throws ClavinException

Execute a query against the Lucene gazetteer index using the provided configuration, returning the top matches as ResolvedLocations.

Specified by:

getClosestLocations in interface Gazetteer

Parameters:

query - the configuration parameters for the query

Returns:

the list of ResolvedLocations as potential matches

Throws:

ClavinException - if an error occurs

getGeoName

public GeoName getGeoName(int geonameId)
                   throws ClavinException

Retrieves the GeoName with the provided ID.

Specified by:

getGeoName in interface Gazetteer

Parameters:

geonameId - the ID of the requested GeoName

Returns:

the requested GeoName or null if not found

Throws:

ClavinException - if an error occurs