Getting Started

Getting started with Aeris WeatherBlox is as simple as signing up for a free developer account and adding a few lines of HTML / CSS to your website.  With the following steps you can quickly add WeatherBlox to your site today:

Step 1: Sign up for an AerisWeather API subscription service and setup your access keys as described in our Aeris Weather API's getting started guide. We offer a free developer account for you to give our weather API a test drive.

Step 2: Decide on your method of integration, either front-end using JavaScript, or backend using our PHP package.

Step 3: Review the library of available WeatherBlox views and layouts and their supported configuration/usage options.

Step 4: Integrate your selected blox into your application using the frontend or backend method.

Example View Integration

The following example demonstrates how you would add a 5-day weather forecast to your page using the frontend/JavaScript method:


<link href="" rel="stylesheet" />
<script src=""></script>

<!-- Designate the view's target element -->
<div id="local-forecast"></div>

<script type="text/javascript">

// Configure Aeris API access keys
Aeris.wxblox.setAccess('CLIENT_ID', 'CLIENT_SECRET');

// Set widget variable
var localForecast = new Aeris.wxblox.views.Forecast('#local-forecast');

// Set API request parameters to be used when requesting data
var params = { 
     p: ':auto',
     limit: 5

// Load and render the view


Client-Side vs Server-Side Integration

Aeris WeatherBlox supports both JavaScript and API (server-side) integrations. Each method has its benefits depending on your application's requirements and level of customization:

Javascript API

Quick and easy to impement.

Improved SEO, since weather content is injected into the web page prior to sending to the browser.

No developement experience required, just add a snippet of JavaScript to your web page.

Ability to implement caching and/or a Content Delivery Network (CDN) to lower API and AMP usage.
Perfect for low to medium volume websites Great for high volume websites.

Last modified: March 20, 2018