Access & Authentication

Ready to get started with AerisWeather's Mapping Platform? You can test drive it with our free developer account!  

Access Tokens

Access to the AerisWeather API requires an access token, which connects API requests with your account. Access tokens are client id/key combinations and are created by registering your application package name, web site domain name or IP address within your account area.  To create a token follow these steps:

Step 1: Log in to your AerisWeather Account.

Step 2: Select “Apps” from the menu

Step 3: Click the “New Application” button and complete the form to register your namespace and obtain a client id/key.

You can provide a comma-separated list of different namespaces for a single app, or if you are unsure of the final namespace you can use an asterisk (*) as a wild card. If using an asterisk during development, it is recommended to edit to the proper allowed namespaces before going to production to prevent unauthorized accesses from any namespace.

Provide your client id and key within the map/tile URL:

https://maps.aerisapi.com/{client_id}_{key}/radar/500x500/minneapolis,mn,5/current.png

HTTPS

All API endpoints support the HTTPS protocol and using it is strongly recommended. Some development environments, such as iOS, require the use of HTTPS. To utilize the HTTPS protocol, use https at the beginning of the API query, in place of http.  For example

https://maps.aerisapi.com/{client_id}_{key}/radar/500x500/minneapolis,mn,5/current.png

CORS

The AerisWeather Mapping Platform and API support cross-origin requests with no domain restrictions.  To make client-side requests to the API, use standard XMLHTTPRequests with CORS.

Last modified: July 29, 2020