prajna.geo

Class EsriGeoFilter

java.lang.Object

prajna.geo.GeoFilter

prajna.geo.EsriGeoFilter

public class EsriGeoFilter
extends GeoFilter

Utility class to determine if a given latitude/longitude is within or near a particular geographic entity. This class builds its geographic shape from an ESRI shape file.

Author:

Edward Swing

Constructor Summary

Constructors

Constructor and Description
EsriGeoFilter(java.lang.String shapeFileName, DataFilter filter) Initialize the geographic filter with a particular shape file and data filter.
EsriGeoFilter(java.lang.String shapeFileName, java.lang.String geoName) Initialize the geographic filter with a particular shape file and geographic entity.
EsriGeoFilter(java.lang.String shapeFileName, java.lang.String fieldName, java.lang.String fieldValue) Initialize the geographic filter with a particular shape file and shapes matching a specified value for a particular field.
EsriGeoFilter(java.net.URL shapeUrl) Initialize the ESRI geographic filter with a particular shape file and geographic entity.
EsriGeoFilter(java.net.URL shapeUrl, java.lang.String geoName) Initialize the ESRI geographic filter with a particular shape file and geographic entity.

Method Summary

Methods inherited from class prajna.geo.GeoFilter

checkPoint, getFilterShape, getRadius, setFilterShape, setRadius

Methods inherited from class java.lang.Object

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

Constructor Detail

EsriGeoFilter

public EsriGeoFilter(java.lang.String shapeFileName,
             DataFilter filter)

Initialize the geographic filter with a particular shape file and data filter. All shapes which match the data filter are included in the data filter. The shape file argument should be a full path to the shape file, but should exclude any extensions. If the filter is null, all shapes in the shape file are included in the GeoFilter.

Parameters:

shapeFileName - The full path to the shape file, without any extensions

filter - the data filter which is used to select the shapes to be included in the GeoFilter.

EsriGeoFilter

public EsriGeoFilter(java.lang.String shapeFileName,
             java.lang.String geoName)

Initialize the geographic filter with a particular shape file and geographic entity. The entity should be within the shape file. The shape file argument should be a full path to the shape file, but should exclude any extensions.

Parameters:

shapeFileName - The full path to the shape file, without any extensions

geoName - The name of the geographic region to filter

EsriGeoFilter

public EsriGeoFilter(java.lang.String shapeFileName,
             java.lang.String fieldName,
             java.lang.String fieldValue)

Initialize the geographic filter with a particular shape file and shapes matching a specified value for a particular field. The shape file argument should be a full path to the shape file, but should exclude any extensions.

Parameters:

shapeFileName - The full path to the shape file, without any extensions

fieldName - name of the field, to match against DBF file data

fieldValue - value of the field, to match against DBF file data

EsriGeoFilter

public EsriGeoFilter(java.net.URL shapeUrl)

Initialize the ESRI geographic filter with a particular shape file and geographic entity. The entity should be within the shape file. The URL argument should specify the full path to the shape file, and use the geographic entity name as the reference in the URL. An example URL might be http://www.esri.com/shapeFiles/world/countries.shp#Iraq

Parameters:

shapeUrl - The full path to the shapefile, including a reference

EsriGeoFilter

public EsriGeoFilter(java.net.URL shapeUrl,
             java.lang.String geoName)

Initialize the ESRI geographic filter with a particular shape file and geographic entity. The entity should be within the shape file. The URL argument should specify the full path to the shape file. The geographic entity is specified by the geoName parameter.

Parameters:

shapeUrl - The full path to the shapefile

geoName - The name of the geographic region to filter