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.

Be aware

This endpoint returns an address along a road segment, however, there may be no structure or mail delivery at the address.

URI Format

HTTP GET

https://api.mapserv.utah.gov/api/v1/geocode/reverse/{x}/{y}?apikey={key}

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

Popular Spatial Reference Ids

WKID	NAME	REASON
26912	UTM Zone 12 N	This is the State standard for all Utah spatial data. It has the least distortion for the state of Utah and the most accurate length and area calculations.
3857	Web Mercator	This is the standard for all data displayed on a web map. Most base map services use a web mercator projection.
4326	Latitude/Longitude (WGS84)	This is the ubiquitous standard for spatial data. Many systems understand this format which makes it good for interoperability.

Reference Information

• What are map projections?
• What are projected coordinate systems?
• What are geographic coordinate systems?

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

Successful Example

{
  "result": {
    "inputLocation": {
      "x": 374165.5184732021,
      "y": 4187102.574632359
    },
    "address": {
      "street": "298 E Center St"
    }
  },
  "status": 200
}

Error Example

Tip

Be sure to inspect the failed requests as they contain useful information. 401 status codes equates to your API key having problems. 404 equates to no address not being found. 200 is successful.

{
  "status": 401,
  "message": ""
}

JSON Schema

{
  "type": "object",
  "properties": {
    "result": {
      "type": "object",
      "properties": {
        "inputLocation": {
          "type": "object",
          "properties": {
            "x": {
              "type": "number"
            },
            "y": {
              "type": "number"
            }
          }
        },
        "address": {
          "type": "object",
          "properties": {
            "street": {
              "type": "string"
            }
          }
        }
      },
      "status": {
        "type": "integer"
      }
    }
  }
}