com.askgeo.dbl.naturalearth
Class CountryMap

java.lang.Object
  com.askgeo.dbl.base.GeneralMap<CountryResult>
      com.askgeo.dbl.naturalearth.CountryMap

public final class CountryMap
extends GeneralMap<CountryResult>

The CountryMap is a map of the world that returns the country or equivalent for any given latitude and longitude.

Nested Class Summary

static class

CountryMap.DataField Enumerates the metadata associated with each shape in the map.

Method Summary

static CountryMap	create(java.io.InputStream dataFileStream) Static factory method used to construct an instance of this class.
static CountryMap	create(java.io.InputStream dataFileStream, double cellsPerDeg, double snapRadiusKm) Static factory method used to construct an instance of this class.
CountryResult	findResult(double latDeg, double lonDeg) Returns a results map query result.
java.lang.String	getOracleName() A unique identifier for this map, used in the license file and in the AskGeo Web API.
static java.lang.String	getOracleNameStatic() A unique identifier for this map, used in the license file and in the AskGeo Web API.

Methods inherited from class com.askgeo.dbl.base.GeneralMap

authorize, authorize, authorize, conusBbox, getAllResults, getBbox, getDataField, getNumDataFields, worldBbox

Methods inherited from class java.lang.Object

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

Method Detail

findResult

public CountryResult findResult(double latDeg,
                                double lonDeg)

Description copied from class: GeneralMap

Returns a results map query result. All result classes extend ResultBase but the specific subclass returned depends on what map class is being used. Each map class has a companion result class. If no shape is found at or near the query point, null is returned.

Specified by:

findResult in class GeneralMap<CountryResult>

Parameters:

latDeg - the latitude of the query point, expressed in degrees.

lonDeg - the longitude of the query point, expressed in degrees.

Returns:

the result for the given latitude and longitude, or null if none is found.

create

public static CountryMap create(java.io.InputStream dataFileStream)
                         throws java.lang.Exception

Static factory method used to construct an instance of this class.

Parameters:

dataFileStream - an input stream of the companion data file for this class.

Returns:

a instance of this class with default parameters.

Throws:

java.lang.Exception - e if the wrong data file is provided.

create

public static CountryMap create(java.io.InputStream dataFileStream,
                                double cellsPerDeg,
                                double snapRadiusKm)
                         throws java.lang.Exception

Static factory method used to construct an instance of this class.

Parameters:

dataFileStream - an input stream of the companion data file for this class.

cellsPerDeg - is the resolution of the spatial index. Testing has show that a suitable value for this parameter is 1.0, which is the default value.

snapRadiusKm - is the maximum snap-to distance for query points not inside any shape on the map.

Returns:

an instance of this class with given parameters.

Throws:

java.lang.Exception - e if the wrong data file is provided.

getOracleNameStatic

public static java.lang.String getOracleNameStatic()

A unique identifier for this map, used in the license file and in the AskGeo Web API.

Returns:

the unique identifier for this map.

getOracleName

public java.lang.String getOracleName()

Description copied from class: GeneralMap

A unique identifier for this map, used in the license file and in the AskGeo Web API.

Specified by:

getOracleName in class GeneralMap<CountryResult>

Returns:

the unique identifier for this map.