#api #api-client #energy #national-grid

bin+lib carbonintensity-api

Provides a client for the UK National Grid Carbon Intensity API

3 releases (breaking)

0.3.0 Oct 15, 2024
0.2.0 Dec 4, 2023
0.1.0 Nov 21, 2023

#713 in Web programming

Download history 2/week @ 2024-09-17 13/week @ 2024-09-24 1/week @ 2024-10-01 1/week @ 2024-10-08 208/week @ 2024-10-15 1/week @ 2024-10-22

211 downloads per month

Apache-2.0

38KB
694 lines

carbonintensity-api

crates.io crates.io API

A simple Rust library to help retrieve data from the Carbon Intensity API, not all functionalities of the CarbonIntensity API might be exposed.

Please read the API's terms of use.

CLI

An executable is provided to try the library. With Rust and Cargo installed

cargo install --locked --path .

then

carbonintensity-api -h

should display the list of available commands and options.

Provides a client for the UK National Grid Carbon Intensity API

Usage: carbonintensity-api [OPTIONS] <VALUE>

Arguments:
  <VALUE>  numerical value for a region (1-17) or first part of a UK postcode

Options:
  -s, --start-date <START_DATE>  
  -e, --end-date <END_DATE>
  -h, --help                     Print help
  -V, --version                  Print version

To display the current carbon intensity for a given postcode

carbonintensity-api bs7

To do the same for a region

carbonintensity-api 11

The region id is a number between 1 and 17

  1. North Scotland
  2. South Scotland
  3. North West England
  4. North East England
  5. South Yorkshire
  6. North Wales, Merseyside and Cheshire
  7. South Wales
  8. West Midlands
  9. East Midlands
  10. East England
  11. South West England
  12. South England
  13. London
  14. South East England
  15. England
  16. Scotland
  17. Wales

Specifying dates will return a list of intensities for a region or postcode. If no end date is provided, the current day and time will be used.

The dates are expected to be at the %Y-%m-%dT%H:%MZ format or simply %Y-%m-%d, for instance

carbonintensity-api -s 2023-11-11 -e 2023-11-11T12:00Z postcode bs7

Intensities are returned by 30 mins windows.

Library

You can use the library in your Rust project by adding it to cargo with

cargo add carbonintensity-api

then declaring it in your code

use carbonintensity::{get_intensity, Target, Region};

...

  let scotland = Region::Scotland;
  let result = get_intensity(&Target::Region(scotland)).await;

License

This project is provided under Apache License.

Dependencies

~9–20MB
~271K SLoC