Skip to content
UGRC API Documentation

Reverse 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 street address from a geographic location.

URI Format

Parameters

Required path parameters

x

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

  • Type: number
  • Example: 374165.98

y

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

  • Type: number
  • Example: 4187089.19

Optional query string parameters

distance

The distance, in meters, from the input coordinate to search for a street address.

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

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": {
    "inputLocation": {
      "x": 374165.5184732021,
      "y": 4187102.574632359
    },
    "address": {
      "street": "298 E Center St"
    }
  },
  "status": 200
}