Get Suggested Radius
Take the guesswork out of working out a suitable radius around your business when searching for events.
The Suggested Radius API returns a radius that can be used to find attended events around a given location. When looking for events around a business location (such as a store, a hotel, or another business location) a key question is how far should you look for events. For example, should you look at events in a 0.5-mile radius, a 2-mile radius, or a 10-mile radius from your location? The Suggested Radius API answers this question by returning a radius based on a number of factors that can be used to retrieve events around a location. This radius returned by the API is commonly used as follows:
- For retrieving events in a data lake by setting the radius around a store or location to the suggested radius.
- In-demand forecasting when building event-based features for a location, use this radius when calculating features for a location.
- For use with our Beam product when performing a correlation analysis
The Suggested Radius API is powered by a machine learning model that looks at factors like population density, the events around a location, the customer’s industry, and many other factors to determine the ideal radius.
curl -X GET https://api.predicthq.com/v1/suggested-radius/?location.origin=37.747767,-122.455320&industry=parking&radius_unit=km \
-H "Accept: application/json" \
-H "Authorization: Bearer $ACCESS_TOKEN"
response = requests.get(
"Authorization": "Bearer $ACCESS_TOKEN",
Below are some guides relevant to this API: