org.mapsforge.poi.storage

Interface PoiPersistenceManager

All Known Implementing Classes:

AbstractPoiPersistenceManager

public interface PoiPersistenceManager

Abstracts from an underlying Storage/DB by providing methods for inserting / deleting / searching PointOfInterest objects in named Storage/DB.

Remember to call the close() method as soon as you are done manipulating the Storage/DB via this PoiPersistenceManager.

Method Summary

Methods

Modifier and Type	Method and Description
void	close() Use this to free claimed resources.
Collection<PointOfInterest>	findInRect(BoundingBox bb, PoiCategoryFilter filter, String pattern, int limit) Find all PointOfInterest in a rectangle specified by the given BoundingBox.
Collection<PointOfInterest>	findNearPosition(LatLong point, int distance, PoiCategoryFilter filter, String pattern, int limit) Fetch PointOfInterest from underlying storage near a given position.
PointOfInterest	findPointByID(long poiID)
PoiCategoryManager	getCategoryManager()
PoiFileInfo	getPoiFileInfo()
void	insertPointOfInterest(PointOfInterest poi) Inserts a single PointOfInterest into storage.
void	insertPointsOfInterest(Collection<PointOfInterest> pois) Inserts PointOfInterest into storage.
boolean	isValidDataBase()
void	removePointOfInterest(PointOfInterest poi) Removes a point of interest from storage.
void	setCategoryManager(PoiCategoryManager categoryManager) Sets this manager's PoiCategoryManager for retrieving and editing POI categories.

Method Detail

close

void close()

Use this to free claimed resources. After that you might no longer be able to query for points of interest. This should always be called a soon as you are done querying.

findInRect

Collection<PointOfInterest> findInRect(BoundingBox bb,
                                     PoiCategoryFilter filter,
                                     String pattern,
                                     int limit)

Find all PointOfInterest in a rectangle specified by the given BoundingBox. Only the POIs that are allowed by the PoiCategoryFilter object and matching the data pattern will be returned.

Parameters:

bb - BoundingBox specifying the rectangle.

filter - POI category filter object that helps determining whether a POI should be added to the set or not (may be null).

pattern - the pattern to search in points of interest data (may be null).

limit - max number of PointOfInterest to be returned.

Returns:

Collection of PointOfInterest matching a given PoiCategoryFilter and data pattern contained in the rectangle specified by the given BoundingBox.

findNearPosition

Collection<PointOfInterest> findNearPosition(LatLong point,
                                           int distance,
                                           PoiCategoryFilter filter,
                                           String pattern,
                                           int limit)

Fetch PointOfInterest from underlying storage near a given position. Only the POIs that are allowed by the PoiCategoryFilter object and matching the data pattern will be returned.

Parameters:

point - LatLong center of the search.

distance - in meters

filter - POI category filter object that helps determining whether a POI should be added to the set or not (may be null).

pattern - the pattern to search in points of interest data (may be null).

limit - max number of PointOfInterest to be returned.

Returns:

Collection of PointOfInterest matching a given PoiCategoryFilter and data pattern near the given position.

findPointByID

PointOfInterest findPointByID(long poiID)

Parameters:

poiID - the id of the point of interest that shall be returned.

Returns:

a single PointOfInterest p where p.id == poiID.

getCategoryManager

PoiCategoryManager getCategoryManager()

Returns:

The persistence manager's category manager for retrieving and editing POI categories.

getPoiFileInfo

PoiFileInfo getPoiFileInfo()

Returns:

the metadata for the current POI file.

insertPointOfInterest

void insertPointOfInterest(PointOfInterest poi)

Inserts a single PointOfInterest into storage.

Parameters:

poi - PointOfInterest to insert into storage.

insertPointsOfInterest

void insertPointsOfInterest(Collection<PointOfInterest> pois)

Inserts PointOfInterest into storage.

Parameters:

pois - collection of PointOfInterest to insert into storage.

isValidDataBase

boolean isValidDataBase()

Returns:

true if the database is a valid POI database.

removePointOfInterest

void removePointOfInterest(PointOfInterest poi)

Removes a point of interest from storage.

Parameters:

poi - the PointOfInterest to be removed.

setCategoryManager

void setCategoryManager(PoiCategoryManager categoryManager)

Sets this manager's PoiCategoryManager for retrieving and editing POI categories.

Parameters:

categoryManager - The category manager to be set.