Sample Response: JSON

GET Request
The following is an example of a GET request for the Reverse Geocode Basic, Advanced, and Premium service.
Note: A value that is associated with more than one key query parameter can be assigned to the parameters by using the following syntax: parameter1&parameter2=value.

BASIC:

Request

https://api.precisely.com/geocode/v1/basic/reverseGeocode?x=-105.240976&y=40.018301&coordSysName=EPSG%3A4326&distance=150&distanceUnits=METERS

Response

{
    "totalPossibleCandidates": 1,
    "totalMatches": 1,
    "candidates": [
        {
            "precisionLevel": 0,
            "precisionCode": "RG4",
            "sourceDictionary": "0",
            "geometry": {
                "type": "Point",
                "coordinates": [
                    -105.240976,
                    40.018301
                ],
                "crs": {
                    "type": "name",
                    "properties": {
                        "name": "epsg:4326"
                    }
                }
            },
            "address": {
                "areaName1": "Colorado",
                "areaName2": "Boulder",
                "areaName3": "Boulder",
                "areaName4": "Boulder",
                "country": "USA",
                "customFields": {
                    "REVERSE_GEOCODE_DISTANCE": "0.0",
                    "REVERSE_GEOCODE_DISTANCE_UNIT": "METERS",
                    "GENERIC_FIELD_1": "88400001001299"
                }
            },
            "ranges": []
        }
    ]
}

ADVANCED:

Request

https://api.precisely.com/geocode/v1/advanced/reverseGeocode?x=-105.240976&y=40.018301&coordSysName=EPSG%3A4326&distance=150&distanceUnits=METERS

Response

{
    "totalPossibleCandidates": 1,
    "totalMatches": 1,
    "candidates": [
        {
            "precisionLevel": 0,
            "formattedStreetAddress": "4750 WALNUT ST",
            "formattedLocationAddress": "BOULDER, CO  80303",
            "identifier": "274381",
            "precisionCode": "RS8A",
            "sourceDictionary": "0",
            "geometry": {
                "type": "Point",
                "coordinates": [
                    -105.240976,
                    40.018301
                ],
                "crs": {
                    "type": "name",
                    "properties": {
                        "name": "epsg:4326"
                    }
                }
            },
            "address": {
                "mainAddressLine": "4750 WALNUT ST",
                "addressLastLine": "BOULDER, CO  80303",
                "areaName1": "CO",
                "areaName2": "BOULDER COUNTY",
                "areaName3": "BOULDER",
                "postCode1": "80303",
                "country": "USA",
                "addressNumber": "4750",
                "streetName": "WALNUT",
                "customFields": {
                    "REVERSE_GEOCODE_DISTANCE": "0.0",
                    "REVERSE_GEOCODE_DISTANCE_UNIT": "METERS"
                }
            },
            "ranges": [
                {
                    "side": "LEFT",
                    "oddEvenIndicator": "UNKNOWN",
                    "units": [
                        {}
                    ]
                }
            ]
        }
    ]
}

PREMIUM:

Request

https://api.precisely.com/geocode/v1/premium/reverseGeocode?x=-105.240976&y=40.018301&coordSysName=EPSG%3A4326&distance=150&distanceUnits=METERS

Response

{
    "totalPossibleCandidates": 1,
    "totalMatches": 1,
    "candidates": [
        {
            "precisionLevel": 0,
            "formattedStreetAddress": "4750 WALNUT ST",
            "formattedLocationAddress": "BOULDER, CO  80303",
            "identifier": "947855759",
            "precisionCode": "RS8A",
            "sourceDictionary": "1",
            "geometry": {
                "type": "Point",
                "coordinates": [
                    -105.240976,
                    40.018301
                ],
                "crs": {
                    "type": "name",
                    "properties": {
                        "name": "epsg:4326"
                    }
                }
            },
            "address": {
                "mainAddressLine": "4750 WALNUT ST",
                "addressLastLine": "BOULDER, CO  80303",
                "areaName1": "CO",
                "areaName2": "BOULDER COUNTY",
                "areaName3": "BOULDER",
                "postCode1": "80303",
                "country": "USA",
                "addressNumber": "4750",
                "streetName": "WALNUT",
                "customFields": {
                    "REVERSE_GEOCODE_DISTANCE": "0.0",
                    "REVERSE_GEOCODE_DISTANCE_UNIT": "METERS"
                }
            },
            "ranges": [
                {
                    "side": "LEFT",
                    "oddEvenIndicator": "UNKNOWN",
                    "units": [
                        {}
                    ]
                }
            ]
        }
    ]
}