HAZARD API SUPPORT

1. How do I use the Revolutio Hazard API?

The Hazard API sandbox contains the list of available design APIs as both GET and POST requests. You must include your Revolutio Hazard API key in the request string (for GET requests) or the header (for POST requests) for the request to be successful.

2. How is the Revolutio Hazard API licenced?

The Revolutio Hazard API is licenced via monthly and yearly subscriptions. You pay for a specific number of request credits per month which are used each time to make a request. Only successful requests are counted towards your usage quota.

3. What elevation data do you source?

The availability of specific, accurate, and portable topographic data is an extremely complex issue. We have to attempted to simplify matters by referencing multiple datasets and also providing users with alternative options to best serve their needs.

When Google API key is not included in the request, the Hazard API samples multiple high resolution topography datasets from GPXZ based on the site coordinates to find the best available data for that location. This is the recommended option for vast majority of users.

When a Google API key is included in the request, the Hazard API uses Google’s Elevation API.

4. What are the requirements for the Google API key?

After creating a Google API key (it’s free), you must enable the Maps Elevation API and Geocoding API within the Google Cloud Console API Library.

You must ensure billing is enabled within your Google Cloud Console account. Each account gets 40,000 free requests per month (that’s a lot). Only users exceeding that will be billed as per Google’s pricing, however a payment method must still be on file to make requests.

5. How do I know if I have correctly enabled APIs within Google Cloud Console?

Enabled APIs will be listed at the bottom of the Google Cloud Console API Dashboard along with the current request totals. If you do not see the relevant API listed here, then it has not been enabled.

You can check that API key has not been restricted by clicking Credentials > [API Key Name]. If you do wish to restrict the API key, make sure that the Geocoding API and Maps Elevation API are selected.

6. My request is taking too long to complete or is returning an error.

Requests for very tall structures such as towers exceeding 50 m can take over 60 seconds to complete. Please make sure you set the timeout of your request to maximum of 230 seconds so the connection does not close before the request completes.

If you are still having trouble, you can make the request without the height (h) parameter, which will ignore terrain, shielding and exposure detection and focus solely on wind speed and topography. As such a request is independent of height, it should return within 10 seconds.

7. Why is the terrain/exposure category detection not always totally accurate?

We use Google Maps satellite data as the input for our machine learning terrain/exposure detection. From time to time you may encounter sites where the available image data has not been updated for some time, thus not accurately reflecting the extent of nearby infrastructure, meaning a manual review may be required. At this time, it is not possible to change the image source.