Skip to content
/ airly Public

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

License

Notifications You must be signed in to change notification settings

xxczaki/airly

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

56 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Airly ☁️

Simple wrapper for Airly API

Build Status XO code style Install size

Czytaj po polsku 🇵🇱

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 🚀

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