REVERSE GEOCODER INTERFACE SPECIFICATIONS


The geocoder interface supports inverse address translations: given
coordinates it can find the nearest streets and interpolate the
nearest house number.  The syntax of the command is:

http://stree.cs.fiu.edu/street?x1=-80.1225&y1=25.8139

Where x1 is the longitude of the point and y1 is the latitude of the point.

The output will contain a TAB delimited table. The table's metadata
(fields' description) is in:

http://stree.cs.fiu.edu/street?x1=-80.1225&y1=25.8139&header=1

Each row of the table is an interpolated house number on a nearby
street segment.  The table is sorted by distance to the point. 

The table contains all streets within approximately 550 meters from the
input point.

For example, if a point falls in the middle of a rectangular city block
bounded by four street segments, the system will return four
interpolated addresses representing the projections of the point onto
the four segments.  The nearest projected address will be in the first
raw.

Fields in the table:

FIELD-1	 -- address -- interpolated full street address (house number and full street
name).

FIELD-2	-- house number -- the interpolated house
number based on the position of the nearest street point within the
address range interval of the street segment.  Note that in most
cases the interpolated house number is close, but may not match an
actual building house number, which is assigned by the local
government and is not stored in the database.  The database stores
only the ranges of addresses (e.g. 2100-2198,2101-2199) and the
service interpolates the house number within that range.

FIELD-3	-- range_from -- the house number of the beginning of the street
segment  as stored in the database.

FIELD-4	range_to -- the "to" house number of the address range interval
in the database.

FIELD-5	-- street -- the full street name, including a prefix and a suffix if applicable.

FIELD-6	--  city -- the largest of the cities where the street segment's zip code belongs to.

FIELD-7 -- state -- the state where the street segment's zip code belongs to.

FIELD-8	-- zip --  the zip code of the street range.

FIELD-9	-- latitude -- decimal latitude of the nearest point of the
street segment. (NAD83 projection)

FIELD-10 -- longitude -- the decimal longitude of the nearest point of the street range.

FIELD-11 -- distance -- the distance in meters from the original input point
to the nearest point in the street segment. (spherical distance)

FIELD-12 -- compass_direction --  N S W E NW SW SE NE -- the direction
from the original input point to the nearest point in the street segment.

FIELD-13 -- offset -- decimal (positive or negative) number of degrees
that is to be added clockwise to the compass_direction in order to
precisely connect the original input point to the nearest point of the
street segment.

FIELD-14 -- constant "street"

The geocoder can perform more than 300 inverse lookup queries per second.