Access & Authentication

Ready to get started with AerisWeather Maps? 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, website 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

AerisWeather Maps 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 26, 2021