Meteogram API

Live Preview

The preview above will auto-update as each option is changed. Bear in mind that the preview is resized to fit into the container, so it will not be the actual size you requested.

Meteogram API Token

Obtain an API token to allow you to embed your own custom meteogram in your web page or on your iOS device's home screen (via a suitable widget like this).

If you are a user of the related Android app then signing up to a token here will unlock all features of the app too!

Conversely, if you are already a platinum user of the Android app then you can use the API key generated from within the app as the API token on this page, without having to sign up separately here.

Customise the meteogram using the options editor on this page, using the live preview to guide you, and grab the resulting link to use in your own application.

The Starter Plan has a simple pay-as-you-go monthly pricing structure (choose your preferred currency in the Currency section below):

free trial period (3 days)
one-off --.-- at end of trial (unless cancelled)
thereafter 1500 free API calls per month (no flat fee)
then only --.---- per API call (+ flat fee of --.-- p/m)

There is a fixed API call charge for each request. In addition, an API call charge is added for each data source used in a meteogram request. However, if the data for a particular source can be served from our cache (rather than fetching it directly from the original data source) then there is no API call charge added for that source. The current API call charges for each data source can be viewed here, and the call charges specific to the current set of options is found in the "Per-call Cost" section. After signing up, you can monitor actual usage and costs in detail via the Subscription Management section.

Subscribe Now

Enter your email address and click on the button below to subscribe to the Starter Plan and obtain a token for immediate use. Payment information is required even if you do not expect to use more than the free quota.

To manage your subscription, including adding or removing payment cards, please refer to the Subscription Management section.

Currency

Choose your preferred currency:

Per-call Cost

Based on the current set of options, the following is the expected maximum "cost" per call, noting that the actual cost would often be less if cached data is available for one or more sources (this does not yet apply when using an API key generated from within the Android app). Further explanation of call charges can be found here.

Subscription Management

The customer portal allows you to review or cancel your subscription, view your billing history, and update your card details.

Note: the customer portal does not apply in respect of an API key (starting with "app_") obtained via the Android app, only to an API token (starting with "sub_") obtained via this page.

Enter your API token below and click the button to open the customer portal:

You can also check on your current and recent usage via the following button.

Android Import/Export

In the related Android app there is a feature which allows you to back up your meteogram settings to the server (in the Backup and Restore section of the settings). Now you can easily load those settings into this page, and even save them back to the server for use in the Android app!

Enter your API key from the app (look in the API Key section of the settings) and slot number (from the Backup and Restore section of the settings), then hit the Load Settings button.

Note that you can also just copy and paste your meteogram settings into the Direct Import section of this page.

api key:

slot number (0 to 15):

tag (used only for Save Settings):

Direct Import

To import options from the related Android app, you can also paste them below and hit the Load Settings button.

Or you can paste in the direct URL that you've been using to generate the meteogram (from the Direct Link section).

After editing your options on this page, you can use the options in the Generated Options section to import back into the Android app... or, even easier, save them to one of the server slots via the Android Import/Export section!

Upgrade Schema

The settings you have loaded (via the hashkey in the URL) are based on an older schema version, which does not have the full set of available options available in the Options Editor.

Migrate your settings to use the latest schema by clicking on the button below.

Save Settings

Use the direct link to re-open this page, preserving the schema, value, and options.

Click on the following button to save your settings for future use.

Direct Link

Use the direct link to see the full-size meteogram, and also use that as a basis for your own use in other contexts!

Or click on the following button to generate a shorter direct link, with the full set of options stored on a server and referred to using a unique hash key.

Options Editor

All available options are presented below (click on the arrow icon to expand). As you make changes, this will be reflected in the preview meteogram.

If you require an API token, see the separate panel on this page to obtain one. The demo API token only works for the default location.

Click here to open this page with a few settings changed from their default values, as an example of just how customisable the meteogram is... almost any design is achievable!

Generated Options

These options can be copied and pasted into the "custom options" field at meteograms.com to use the design there.

Or you can copy and paste the options into the related Android app so that you can have a meteogram with the same design as a widget directly on your home screen!

Encoded Options

The encoded version of the options can be used directly in a URL without causing problems.

Raw Options

Rather than using the hierarchical editor, you can also make changes to the options by editing the values directly in the text editor below.

Or you can paste raw options here, for example as exported from the related Android app.

After making changes in the editor below, click on the following button to confirm the changes.

Editor Options

CSS Framework

Icon Library

Object Layout

Show Errors

Boolean options

Validation

This will update whenever the form changes to show validation errors if there are any.

DWD API

You might also be interested in the DWD API for fetching raw forecast data from the German Weather Service (Deutscher Wetterdienst or DWD).

Donations

Donations of any amount are gratefully received and help to support and encourage further development and improvement of the meteogram app and associated resources.

The preferred way of making a donation is to send the money directly to my account, because it involves the lowest bank charges, and there is also a wide choice of payment currencies.

Alternatively, you can donate using the form below, or via my buymeacoffee page. Change the currency (if required) in the separate Currency section further above. Thanks!

Choose amount

Choose payment method

Pay with PayPal

Your payment is processed by Stripe (for credit/debit cards) or PayPal. To use PayPal you must first have a PayPal account. Both payment processors use secure encryption to keep your details safe: none of your payment information goes through my server. If you donate I can access your email address but will only use it to send you a one-off personal email of thanks.

Schema

You can change the schema by pasting a new version below and then clicking

Code

// Set default options
JSONEditor.defaults.options.theme = 'bootstrap2';

// Initialize the editor
const editor = new JSONEditor(document.getElementById('editor_holder'),{
  schema: {
      type: 'object',
      properties: {
          name: { 'type': 'string' }
      }
  }
});

// Set the value
editor.setValue({
    name: 'John Smith'
});

// Get the value
const data = editor.getValue();
console.log(data.name); // 'John Smith'

// Validate
const errors = editor.validate();
if(errors.length) {
  // Not valid
}

// Listen for changes
editor.on('change',  function() {
  // Do something...
});