Sample Response: JSON

Request

The following is an example of a GET request for the Geocode service 'Basic', 'Advanced' and 'Premium' service.

Note: Query parameters are separated by an ampersand.

BASIC: 

https://api.precisely.com/geocode/v1/basic/geocode?country=USA&mainAddress=4750%20Walnut%20St.%2C%20Boulder%20CO%2C%2080301&matchMode=Standard&fallbackGeo=true&fallbackPostal=true&maxCands=1&streetOffset=7&streetOffsetUnits=METERS&cornerOffset=7&cornerOffsetUnits=METERS

JSON GET Response

The following shows the JSON response returned by the above request:

{
    "totalPossibleCandidates": 1,
    "totalMatches": 1,
    "candidates": [
        {
            "precisionLevel": 10,
            "formattedLocationAddress": "BOULDER, BOULDER COUNTY, CO, USA",
            "precisionCode": "G3",
            "sourceDictionary": "0",
            "geometry": {
                "type": "Point",
                "coordinates": [
                    -105.27055,
                    40.01499
                ],
                "crs": {
                    "type": "name",
                    "properties": {
                        "name": "epsg:4326"
                    }
                }
            },
            "address": {
                "addressLastLine": "BOULDER, BOULDER COUNTY, CO, USA",
                "areaName1": "CO",
                "areaName2": "BOULDER COUNTY",
                "areaName3": "BOULDER",
                "country": "USA"
            },
            "ranges": []
        }
    ]
}

ADVANCED: 

https://api.precisely.com/geocode/v1/advanced/geocode?country=USA&mainAddress=4750%20Walnut%20St.%2C%20Boulder%20CO%2C%2080301&matchMode=Standard&fallbackGeo=true&fallbackPostal=true&maxCands=1&streetOffset=7&streetOffsetUnits=METERS&cornerOffset=7&cornerOffsetUnits=METE

JSON GET Response

The following shows the JSON response returned by the above request:

{
    "totalPossibleCandidates": 1,
    "totalMatches": 1,
    "candidates": [
        {
            "precisionLevel": 16,
            "formattedStreetAddress": "4750 WALNUT ST",
            "formattedLocationAddress": "BOULDER, CO  80301-2532",
            "identifier": "274381",
            "precisionCode": "S8HPNTSCZA",
            "sourceDictionary": "2",
            "geometry": {
                "type": "Point",
                "coordinates": [
                    -105.240976,
                    40.018301
                ],
                "crs": {
                    "type": "name",
                    "properties": {
                        "name": "epsg:4326"
                    }
                }
            },
            "address": {
                "mainAddressLine": "4750 WALNUT ST",
                "addressLastLine": "BOULDER, CO  80301-2532",
                "areaName1": "CO",
                "areaName2": "BOULDER COUNTY",
                "areaName3": "BOULDER",
                "postCode1": "80301",
                "postCode2": "2532",
                "country": "USA",
                "addressNumber": "4750",
                "streetName": "WALNUT"
            },
            "ranges": [
                {
                    "lowHouse": "4714",
                    "highHouse": "4797",
                    "side": "LEFT",
                    "oddEvenIndicator": "EVEN",
                    "units": [
                        {}
                    ]
                }
            ]
        }
    ]
}

PREMIUM: 

https://api.precisely.com/geocode/v1/premium/geocode?country=USA&mainAddress=4750%20Walnut%20St.%2C%20Boulder%20CO%2C%2080301&matchMode=Standard&fallbackGeo=true&fallbackPostal=true&maxCands=1&streetOffset=7&streetOffsetUnits=METERS&cornerOffset=7&cornerOffsetUnits=METERS

JSON GET Response

The following shows the JSON response returned by the above request:

{
    "totalPossibleCandidates": 1,
    "totalMatches": 1,
    "candidates": [
        {
            "precisionLevel": 16,
            "formattedStreetAddress": "4750 WALNUT ST",
            "formattedLocationAddress": "BOULDER, CO  80301",
            "identifier": "947855759",
            "precisionCode": "S8HPNTSCZA",
            "sourceDictionary": "1",
            "geometry": {
                "type": "Point",
                "coordinates": [
                    -105.24071,
                    40.01819
                ],
                "crs": {
                    "type": "name",
                    "properties": {
                        "name": "epsg:4326"
                    }
                }
            },
            "address": {
                "mainAddressLine": "4750 WALNUT ST",
                "addressLastLine": "BOULDER, CO  80301",
                "areaName1": "CO",
                "areaName2": "BOULDER COUNTY",
                "areaName3": "BOULDER",
                "postCode1": "80301",
                "country": "USA",
                "addressNumber": "4750",
                "streetName": "WALNUT"
            },
            "ranges": [
                {
                    "lowHouse": "4750",
                    "highHouse": "4750",
                    "side": "LEFT",
                    "oddEvenIndicator": "EVEN",
                    "units": [
                        {}
                    ]
                }
            ]
        }
    ]
}