airly

Simple wrapper for Airly API, works in Node.js & the browser.

Usage no npm install needed!

<script type="module">
  import airly from 'https://cdn.skypack.dev/airly';
</script>

README

Airly :cloud:

Simple wrapper for Airly API

Build Status XO code style Install size

Czytaj po polsku :poland:

Highlights

  • Simple, asynchronous API
  • Works in Node.js & the browser
  • Uses the 2.0 version of Airly API
  • Full API coverage
  • Actively maintained
  • Lightweight
  • Written in TypeScript

Install

$ npm install airly

Usage

const Airly = require('airly');

const airly = new Airly('API_KEY');

(async () => {
    try {
        const data = await airly.installationInfo(240);
        console.log(data);
    } catch (error) {
        console.log(error);
    }
})();

API

Check out the examples folder :rocket:

new Airly(key, language)

Constructor for other operations

key

Type: string

Your Airly API key. You can obtain one here.

language

Type: string

Default: en

Get air quality descriptions in specified language. Currently supported languages are English ('en' - default) and Polish ('pl').

For more information check out Airly's documentation

airly.installationMeasurements(id)

Returns detailed measurements (current, historical and future) for an installation

id

Type: number

Unique number of the installation

airly.installationInfo(id)

Returns information about specified installation

id

Type: number

Unique number of the installation

airly.nearestInstallations(lat, lng, maxDistanceKM, maxResults)

Returns information about the nearest installations (including their ID's)

lat

Type: number

Latitude

lng

Type: number

Longitude

maxDistanceKM

Type: number

Default: 3

All the returned installations must be located within this limit from the given point (in km); negative value means no limit.

maxResults

Type: number

Default: -1

Maximum number of installations to return; negative value means no limit.

airly.nearestMeasurements(lat, lng, maxDistanceKM)

Returns detailed measurements (current, historical and future) from the installation which is closest to a given point

lat

Type: number

Latitude

lng

Type: number

Longitude

maxDistanceKM

Type: number

Default: 3

All the returned installations must be located within this limit from the given point (in km); negative value means no limit.

airly.pointMeasurements(lat, lng)

Returns detailed measurements (current, historical and future) for a map point, which can be interpolated from nearby installations

lat

Type: number

Latitude

lng

Type: number

Longitude

airly.metaIndexes()

Returns a list of IndexTypes supported by the platform

airly.metaMeasurements()

Returns a list of MeasurementTypes supported by the platform

License

MIT © Antoni Kepinski