Reverse Geocoding

Reverse Geocoding on the /locations/reverse resource allows you to retrieve the nearest address for given longitude and latitude coordinates.

The response from the reverse geocode method is a JSON formatted object that contains the longitude and latitude coordinates for the address, if the address could be geocoded.



URL Parameters

Required parameters are highlighted in yellow.



Reverse Geocode Response (Similar to Geocode Response table)

Data ElementDescriptionData TypeValue/Example
AddressEncapsulates the details about the locationComplex
CoordsEncapsulates the details about the longitude/latitudeComplex
RegionIndicates the region of the locationEnum0 - Unknown
1 - AF
2 - AS
3 - EU
4 - NA(default)
5 - OC
6 - SA
7 - ME
LabelThe label to be displayed on maps and reports in association with a stopstring
PlaceNameThe place name which corresponds to custom place.string
ErrorsEncapsulated the details about the errors associated with the geocode locationList of Complex Objects
ConfidenceLevelThe confidence level of the match.stringExact, Good, Uncertain, Failed
DistanceFromRoadThe distance from coordinate to nearest road.double
SpeedLimitInfoEncapsulated information related to posted speed limit.Complex
TimeZoneTime zone where the geocoded result is situated within.string
SpeedLimitHeadingHeading used for reverse geocoding to properly snap to the right link.double


Data ElementDescriptionData TypeValue/Example
StreetAddressThe house number and street namestringOne Independence Way
CityThe name of the citystringPrinceton
StateThe two letter state abbreviationstringNJ
ZipThe postal code or zipstring08540
CountyThe county or jurisdiction.stringMercer
CountryThe name of the countrystring
SPLCThe Standard Point Location code to use in place of street/city/state/zipstring
CountryPostalFilterThe postal code filter; use this to filter zip codes by countryEnum0 - US
1- Mexico
2 - Both
AbbreviationFormatThe abbreviation format for the country code. This is not applicable for NA dataset. See Lookup table in Glossary.Enum0 - FIPS
1 - ISO2
2 - ISO3
3 - GENC2
4 - GENC3
CountryAbbreviationAbbreviated country code corresponding to requested format.string0 - FIPS (default)
1 - ISO2
2 - ISO3
3 - GENC2
4 - GENC3


Data ElementDescriptionData TypeValue/Example


Data ElementDescriptionData TypeValue/Example
Speedthe posted Speed Limit of the roadinteger
SpeedTypeSpeed Limit TypeEnum0 (Default road speed based on road classification)
1 (Historic road data)
2 (Premium speed data)
3 (Navteq data outside of NA)
4 (LinkBased)
LinkIdsUnique link identifiers when includeLinkInfo supplied true in request.integer
RoadClassThe class of the Road.stringClosed, Interstate, InterstateNoRamps, Divided, Primary, Ferry, Secondary, Ramp, Local
UnitsThe speed unit.stringKPH, MPH


Data ElementDescriptionData TypeValue/Example
TypeIndicates whether the error is an exception or warningEnumWarning Exception
CodeError codeEnumPlease refer to Appendix for complete list
LegacyErrorCodeThe legacy error code with is an integer valued code that would have been returned in PC*MILER Web Services v25 and earlier.Int
DescriptionThe detailed error description.string
Last updated November 5, 2019.