Forward Geocoder on AWS Marketplace Developer's Guide

Find Address within a Geospatial Area

Additional context in form of geospatial area information can replace precise address information in the input. This is especially important for queries without city, district or postal code information. Geospatial context can be added to a request in three ways:
  • mapview: Matches from within the set map view plus an extended area are ranked highest. Relevant global results are also returned.
  • bbox: The bbox search is currently similar to mapview but it is not extended.
  • prox: Position plus radius. Search is similar to mapview. Matches from inside set area are ranked higher. Relevant global results are also returned.

Addressline-only Example

Providing additional context is especially important for queries without city, district or postal code information. The following example is a search for Market St and a map view over San Francisco:

http://{YOUR_AWS_INSTANCE}/search/6.2/geocode.xml
?searchtext=Market+St
&mapview=37.7983366,-122.4006509;37.7904096,-122.3916387

Depending on the map view center and size the results will be different. The results are sorted by distance from the map view center.

<Distance>191.8</Distance>
...
<DisplayPosition>
  <Latitude>37.7927742</Latitude>
  <Longitude>-122.396965</Longitude>
</DisplayPosition>
...
<Label>Market St, San Francisco, CA 94111, United States</Label>
...
<Distance>719.7</Distance>
...
<DisplayPosition>
  <Latitude>37.7893333</Latitude>
  <Longitude>-122.4012833</Longitude>
</DisplayPosition>
...
<Label>Market St, San Francisco, CA 94104, United States</Label>