
Product
Introducing Socket MCP for Claude Desktop
Add secure dependency scanning to Claude Desktop with Socket MCP, a one-click extension that keeps your coding conversations safe from malicious packages.
js-climacell-api
Advanced tools
A wrapper for ClimaCell available to be used in both browser and node js environments
js-climacell-api
is a JavaScript wrapper around the ClimaCell API (v4)
that can be used in both NodeJS and Browser environments
This package is Typescript ready
npm i js-climacell-api
The library is a default export.
To use it browser, you need to use the code from browser.js
file.
<script src="path-to-local-library/browser.js"></script>
or via CDN
<script src="https://unpkg.com/js-climacell-api@X.Y.Z/browser.js"></script>
Where X.Y.Z
represents the library version.
In this scenario, the library will be bound to the global window object with the property ClimaCellAPI.
window.ClimaCellAPI
or simple ClimaCellAPI
can be used to access the library.
If you have a toolchain available you can use an import
statement.
import ClimaCellAPI from 'js-climacell-api/browser';
const ClimaCellWrapper = require('js-climacell-api/browser');
Because is a default export, here you can import it with what name you want
For NodeJS
environment, just replace browser
with node
import ClimaCellAPI from 'js-climacell-api/node';
The object imported is a class that will expose the following methods:
static async requestData(options: QueryBuilderOptions):Promise<any> {}
Where options
is an object of form:
interface QueryBuilderOptions {
[param: string]: string | number | string[] | number[];
}
This static method can be used to compute an URL and send a GET request to https://data.climacell.co/v4/timelines
.
The values from options
object will be transformed into query parameters.
Example
await ClimaCellAPI.requestData({
apikey: '23',
location: `1.2%2C2.2`,
fields: ['temperature', 'humidity'],
});
will result in a request to the following URL:
https://data.climacell.co/v4/timelines?apikey=23&location=1.2%2C2.2&fields=temperature&fields=humidity
The result will be exactly the raw response from the API.
The purpose of this method is to give you full controll over the request URL and help you easily compute it and acquire timeline data from the API.
Don't forget to add your apikey
!
For the following methods the class must be instantiated with the following constructor.
constructor(apiKey: string, coordinates: GeoCoordinates) {}
Where coordinates
has the following format:
export type GeoCoordinates = [string | number, string | number]; //latitude & longitude
Example
import ClimaCellApi from 'js-climacell-api/dist/node';
const API_KEY = '';
const LAT = '';
const LON = '';
const hometownMonitor = new ClimaCellApi(API_KEY, [LAT, LON]);
The available methods are the following:
async current(options: TimelinesOptions): Promise<any> {}
async perMinute(options: TimelinesOptions): Promise<any> {}
async per5Minutes(options: TimelinesOptions): Promise<any> {}
async per15Minutes(options: TimelinesOptions): Promise<any> {}
async per30Minutes(options: TimelinesOptions): Promise<any> {}
async perDay(options: TimelinesOptions): Promise<any> {}
Each method will return the raw response from the API.
The types:
export enum UnitType {
metric = 'metric', // International System of Units
imperial = 'imperial', // Imperial and US customary measurement systems
}
export interface Availability {
start?: string | number;
end?: string | number;
}
export interface TimelinesOptions {
fields: string[];
availability?: Availability;
units?: UnitType;
timezone?: string;
}
availability?: Availability
matches the availability mentioned in the documentation and represents the interval of the data requested
timezone?: string
- Timezone names follow the IANA Time Zone Database format
fields
represents an array with the fields you are intersted in (Core-Air Quality-Pollen-Fire-Precipitation)
(async () => {
const hometownMonitor = new ClimaCellAPI('api_key', [45.6427, 25.5887]);
await hometownMonitor.perMinute({
fields: ['temperature', 'particulateMatter25'],
units: 'imperial',
});
})();
Will result in a request to the following URL.
https://data.climacell.co/v4/timelines?timesteps=1m&fields=temperature&fields=particulateMatter25&units=imperial&apikey=api_key&location=45.6427,25.5887
availability
await hometownMonitor.perMinute({
fields: ['humidity'],
availability: {
start: '-1h',
end: '2h',
},
});
The above call will request data with a time interval of 1m, but starting with 1 hour behind the current time and up to 2 hours in front.
The accepted values for availability.start
and availability.end
are
the time formats accepted by ms module.
The next call will request data starting 5 minutes in the future from the current time.
await hometownMonitor.perMinute({
fields: ['humidity'],
availability: {
start: 1000 * 60 * 5,
},
});
If you want to use an exact date, then you can implement it as in the following example:
const specificDate = '2021-01-30T12:07:01.939Z';
await hometownMonitor.perMinute({
fields: ['humidity'],
availability: {
start: new Date(specificDate).getTime() - Date.now(),
},
});
FAQs
A wrapper for ClimaCell available to be used in both browser and node js environments
The npm package js-climacell-api receives a total of 4 weekly downloads. As such, js-climacell-api popularity was classified as not popular.
We found that js-climacell-api demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Product
Add secure dependency scanning to Claude Desktop with Socket MCP, a one-click extension that keeps your coding conversations safe from malicious packages.
Product
Socket now supports Scala and Kotlin, bringing AI-powered threat detection to JVM projects with easy manifest generation and fast, accurate scans.
Application Security
/Security News
Socket CEO Feross Aboukhadijeh and a16z partner Joel de la Garza discuss vibe coding, AI-driven software development, and how the rise of LLMs, despite their risks, still points toward a more secure and innovative future.