EMS : Geocoding Services

[ Whereis® API Home ] [ JSON API Home ] [ Services ]

The geocoding services return a <geocode> object, which provide a complete location description, which - depending on the granularity - includes street address, centrePoint and, in most cases, an ID that can be used to reliably retrieve the same information in a subsequent search.

There are three geocoding services.

Service Name

Description

Reverse geocode

Returns a list of addresses based on their proximity to a specified longitude and latitude

Structured geocode

Returns details, including ID, for each of one or more locations, based on submission of a structured address object

Unstructured geocode

Returns details, including ID, for each of one or more locations, based on submission of unstructured address string

NOTES
Icon

Address granularity refers to the type of address that is geocoded. Granularities include STATE, REGION, POSTCODE, SUBURB, STREET, INTERSECTION and PROPERTY. An unsuccessful geocode for an address at one granularity will not "snap out" to the next granularity. For example, an unsuccessful geocode query for a property will not return a street or a suburb.