Last week, UGRC finished a substantial upgrade to the Utah statewide address locator (geocoding) web service. This service utilizes point and road-based address map reference data compiled into the State Geographic Information Database (SGID) from local sources, and published on a bi-monthly basis.
The publicly accessible geocoding service allows developers to include ‘best effort’ Utah address finding functionality into web applications at no cost.
Just as important, this service enables database administrators to build processes that allow any database containing information tied to an address to pick up geographic coordinates so that information can be easily integrated and viewed on mapping platforms.
The URI below demonstrates just one of the many ways RESTful requests can be used to get coordinates for Utah addresses via http:
https://api.mapserv.utah.gov/api/v1/Geocode/50 W Capitol St/fillmore
Documentation for the service is integrated into a test/demo interface at https://api.mapserv.utah.gov. Registration information and API key access for desktop and web application users, and, metric/tracking for registered API keys can be accessed from the same site.
The upgrades were funded by a partnership between the Department of Public Safety’s Division of Highway Safety and the UDOT Traffic and Safety Division. UGRC will assist these agencies in using the new API to enhance mapping of crashes, citations, and other safety-related events.
The updates are perhaps most easily described by the short series of Need/Solution statements below.
Need: Search Zones - Zip codes and Place Names
Solution: Street addresses, like
120 S Main St, are obviously not unique across the entire state without additional information describing place. This makes a search zone required to locate an address within the desired area. Search zones can be a city/community name or a zip code. Often, the zip code or city information associated with a street addresses is either incorrect or unknown. With the exception of one’s home and workplace, zip code and city boundaries are not well known and are not visible to data gatherers out in the physical world.
Address system boundaries are actually more readily understood and are the real ‘parent’ objects of all assigned street addresses. The new geocoding endpoint uses address system boundaries as the backend search zones and any zip code or community name within that address system can be used as a surrogate for that address system zone. In other words, if you are looking to find an address within the Salt Lake County-wide address area, you can supply any zip code or community name within the Salt Lake County grid and the returned match location will also provide the correct zip code information. The correct city information can be found by using the Boundaries.Municipalities as parameters within the Attribute Search endpoint.
Additionally, where County address assignment systems are used for unincorporated areas but addresses are supplied using the nearest city placename, the city address grid will be searched first and if no suitable match is found, the county address system will be searched as a secondary attempt to find a match location. This is especially useful in areas like northern Utah County where the addressing system changes on a block by block basis (for example from Lehi to Provo-based County grid and back) in some areas.
Need: Address Point or Street Centerline Match
Solution: The endpoint update allows a preference to be stated for a match from the address point or the road centerline-based address reference data. The default is to first try for an address match, then if none is found, to try against the road centerlines. Voter addresses (address pt) and crash addresses (road) are examples of where an application area is likely to have a strongly preferred match dataset.
Need: Numeric Street Name ‘Reversals’
Solution: With Utah’s somewhat unique distinct ‘numeric/directional’ street names (600 West), occasionally residents will provide a ‘coordinate pair’ address that does not properly order the house number and street name address components.
Where needed, the new geocoding endpoint will switch the address components in an input address like
800 E 1237 N to
1237 N 800 E before trying to find a match.
Need: Place Name Abbreviations
Solution: Placename abbreviations are often used and are not done so uniformly. The previous version of the endpoint required the use of a standardized placename (we were using the place names from the state highway map).
The new endpoint references a lookup table containing many common abbreviations like
SLC, SALT LAKE, S JORDAN, WVC, HEBER, HEBER CITY, ST GEORGE, SAINT GEORGE, ST. GEORGE, etc.
Need: Support for common coordinate systems
Solution: The new endpoint uses an optional input parameter to set the spatial reference system of the output geographic coordinates (lat/long, utm, state plane, web mercator, etc)
Need: Finding locations specified by highway route and milepost
Solution: A new, specific REST-based method has been added for finding Route and Milepost locations. It is described and testable within the Geocoding section of the API Explorer and includes the option to set the side for all sections of highway defined by UDOT as divided.
Other key upgrades
- Addresses with delivery point (“drop off”) zip codes (such as
84148) are supported.
- Requests can specify the minimum match score and the number of additional candidates locations to return.
- Requests can specify the structure/format of the returned locational information :
- Instantaneous and periodic usage statistics can be viewed by the services’ administrators.