The AerisWeather JavaScript SDK is an easy-to-use library that allows developers to quickly integrate weather data and imagery from their Aeris subscription into their web applications. You can perform basic Aeris Weather API and/or Aeris Maps Platform (AMP) requests, or display a fully-interactive weather map using one of the many third-party mapping libraries currently supported.

Follow our Getting Started guide to quickly add weather data and imagery to your web applications.

Heads Up! The AerisWeather JavaScript SDK is still in beta, so there may be breaking changes with each beta release until an official 1.0 is released.

Requirements + Compatibility

  • Requires an active AerisWeather subscription to the AerisWeather API and/or Aeris Maps Platform (AMP)
  • Compatible with modern browsers and IE 11

Basic Example

The following is a basic example demonstration how easy it is to start using the AerisWeather JavaScript SDK for requesting AerisWeather API data and AMP imagery once you’re setup:

// load the latest observation for Seattle, WA
aeris.api().endpoint('observations').place('seattle,wa').get().then((result) => {
     var data =;
     document.getElementById('obs').innerHTML = `The current weather is ${data.weatherPrimary.toLowerCase()} and ${data.tempF} degrees.`;

// load the latest radar image for Seattle, WA at 500x300 pixels'flat,radar,counties,admin').center('seattle,wa').zoom(9).size(500, 300).get().then((result) => {
     // append result image to a DOM target
     // output image valid time to a DOM target
     document.getElementById('map-metadata').innerHTML = `Valid: ${result.metadata.validDate}`;

Implementation Methods

The AerisWeather JavaScript SDK can be implemented either in the browser by loading the compiled library from our CDN, or by installing and importing the SDK as an NPM module and importing it into your NodeJS or JavaScript project. Review the Getting Started guide for more information about each implementation and and to setup and start using the SDK.