GuidesAPI ReferenceDiscussions
Guides

Geolocation

Suggest Edits

You can search for properties near a specific location by using latitude and longitude coordinates in your query. The Business Data API supports geo-based searches using the geoLocation field, allowing you to find properties within a specified distance from a point. Simply provide the longitude, latitude, distance, and unit (e.g., miles, kilometers, meters) in your query. This is especially useful for identifying properties near a landmark, neighborhoods, or point of interest.

To use the API to do queries based around latitude and longitude values. For example, if you would like to find all properties within 10 miles of a specific point in Austin, Texas you could use the following query.

The format for a geolocation filter is: [Longitude,Latitude,Distance,Distance Unit].

  • longitude - longitude of the point where you want your radial search to start from.
  • latitude - latitude of the point where you want your radial search to start from.
  • Distance - integer value of the radius of the search.
  • Distance Unit - unit of measurement the distance value represents.

Here's an example:

{
    "query":"geoLocation:[-97.7430600,30.2671500,10,mi]",
    "num_records": 3,
    "format":"json",
    "view":[
        {"name": "address"},
        {"name": "city"},
        {"name": "country"},
        {"name": "latitude"},
        {"name": "longitude"},
        {"name": "geoLocation"},
        {"name": "postalCode"}
    ]
}

An example from the response:

{
    "num_found": 164941,
    "total_cost": 3,
    "people_cost": 0,
    "property_cost": 0,
    "business_cost": 3,
    "product_cost": 0,
    "records": [
        {
            "address": "2900 W Anderson Ln",
            "city": "Austin",
            "country": "US",
            "latitude": "30.35950300",
            "longitude": "-97.73740400",
            "geoLocation": "POINT (-97.73740400 30.35950300)",
            "postalCode": "78757",
            "id": "AV1Ts0NS3D1zeR_xFHt-"
        },
        {
            "address": "614 E Oltorf St",
            "city": "Austin",
            "country": "US",
            "latitude": "30.237040",
            "longitude": "-97.749010",
            "geoLocation": "POINT (-97.749010 30.237040)",
            "postalCode": "78704",
            "id": "AWFfRuEs3-Khe5l_guaN"
        },
        {
            "address": "404 W 26th St",
            "city": "Austin",
            "country": "US",
            "latitude": "30.290628",
            "longitude": "-97.742004",
            "geoLocation": "POINT (-97.742004 30.290628)",
            "postalCode": "78705",
            "id": "4AYBDnUBodemSykC1fSK"
        }
    ]
}

As you plot your result on a map you will see that the records returned are within a radius generated by the geolocation search.


Units of measurement

You can also use the following units for measuring distance:

m - meters
mi - miles
ft - feet
in - yards
mm - millimeters
km - kilometers
NM - nautical miles
cm - centimeters

Use cases

Check out some of our use cases that use geoLocation:

Updated 11 days ago