[ Whereis® API Home ] [ JSON API Home ]
The purpose of EMS is to provide access to location-related services such as geocoding, address validation, routing, and the generation of maps. The EMS JSON API exposes the following services, listed here alphabetically but grouped within the documentation by function under Map Services (including viewports), Route Services (including rank), Geocoding Services, Get Detail Services, and Utilities.
Service name | Service Type | Description |
| Utilities | Returns suggested location names and IDs, based on a search term expressed as a fragment of text | |
| Get Detail | Returns details about one or more locations, based on postcode | |
| Get Detail | Returns details about one or more locations, based on region | |
| Get Detail | Returns details about one or more locations, based on state | |
| Get Detail | Returns details about one or more locations, based on suburb | |
| Get Detail | Returns details about a location, based on its ID | |
| Geocoding | Returns details, including ID, for each of one or more locations, based on submission of a structured address object | |
| Geocoding | Returns details, including ID, for each of one or more locations, based on submission of unstructured address string | |
| Map | Returns map as a binary stream, via a URL, or as base 64 data, based on the bounds implied by <mapData> submitted for inclusion | |
| Map | Returns map based on bounds | |
| Map | Returns map based on centre point and zoom | |
| Map | Returns map based on centre point and radius | |
| Route | Ranks points by distance from a centre point | |
| Geocoding | Returns a list of addresses based on their proximity to a specified longitude and latitude | |
| Route | Returns a route based on startpoint, endpoint, optionally passing through waypoints and/or avoiding avoidpoints | |
| Route | Five additional services using HTTP GET to return information based on an id retrieved from a previous route request | |
| Waypoints | Route | Optimise the order of route stops to get the shortest or fastest route |
| Alternate routes | Route | Return a list of alternatives for a given route |
| Points of interest | POIs | Get a list of points of interest for a given area |
| Utilities | Returns metadata in relation to our map offering, via HTTP GET | |
| Viewport by bounds | Map | Returns the viewport that corresponds to an equivalent Map by bounds request |
| Map | Returns the viewport that corresponds to an equivalent Map by centre request | |
| Map | Returns the viewport that corresponds to an equivalent Map request | |
| Map | Returns the viewport that corresponds to an equivalent Map by radius request |