Access & Authentication

Ready to get started with Aeris Maps? You can test drive Aeris Maps with our free developer account!  

Access Tokens

Access to the Aeris APIs 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 Aeris Weather 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 Aeris Weather and Map APIs support cross-origin requests with no domain restrictions.  To make client-side requests to the Aeris APIs, use standard XMLHTTPRequests with CORS.