Skip to content
UGRC API Documentation

Reverse route and milepost geocoding

Reverse geocoding is the process of converting a geographic location (i.e., the geographical coordinates) to a human-readable address. This UGRC API endpoint allows you to get the nearest route and milepost from a geographic location for UDOT highways and state routes.

URI Format

Parameters

Required path parameters

x

A number representing the longitude, easting, or horizontal value of a coordinate.

  • Type: number
  • Example: 442300.87

y

A number representing the latitude, northing, or vertical value of a coordinate.

  • Type: number
  • Example: 4491927.25

Optional query string parameters

buffer

The buffer radius, in meters, from the input coordinate to search for a route and milepost.

  • Type: number
  • Default: 100
  • Can be one of: 0-200

includeRampSystem

To include ramps, collectors, and federal aide routes features in a reverse route and milepost query set this to true.

  • Type: boolean
  • Default: false
  • Can be one of: true, false

suggest

The default value of 0 will only return the closest match. To include more route and milepost candidates, set this value between 1-5. The candidates will all be within the buffer radius.

  • Type: number
  • Default: 0
  • Can be one of: 0-5

spatialReference

The spatial reference defines how the coordinates will represent a location on the earth defined by how the round earth was made flat. The well known id’s (WKID) of different coordinate systems define if the coordinates will be stored as degrees of longitude and latitude, meters, feet, etc. This endpoint supports the WKIDs from the Geographic Coordinate System reference and the Projected Coordinate System reference. UTM Zone 12 N, with the WKID of 26912, is the default. This coordinate system is the most accurate reflection of Utah. It is recommended to use this coordinate system if length and area calculations are important as other coordinate systems will skew the truth.

  • Type: number
  • Default: 26912
Reference Information

callback

The callback function to execute for cross domain javascript calls (jsonp). This API supports CORS and does not recommend the use of callback and jsonp.

  • Type: string

Response Shapes

{
"result": {
  "route": "15P",
  "offsetMeters": 13.09,
  "milepost": 299.312,
  "side": "decreasing",
  "dominant": true,
  "candidates": [{
    "route": "15N",
    "offsetMeters": 14.07,
    "milepost": 299.196,
    "side": "decreasing",
    "dominant": true
  }]
},
"status": 200
}