world-temperature-data

Monthly mean air temperature for 270 cities worldwide. Twelve monthly normals plus an annual mean, as a tiny zero-dependency package for both JavaScript and Python, with the raw CSV bundled.

Data by GeoRank.place — see the interactive temperature map. Licensed CC-BY-4.0.

Method

Mean monthly near-surface air temperature (°C) from CHELSA v2.1 climatological normals (1981–2010), warped to a 0.05° grid and sampled per city. annualC is the mean of the 12 months. Full sources in ATTRIBUTION.md.

Install

npm install world-temperature-data      # JavaScript / TypeScript
pip install world-temperature-data      # Python

Usage

JavaScript / TypeScript

import { byCity, byCountry, cities } from "world-temperature-data";

const lisbon = byCity("Lisbon", "PT");
lisbon.annualC;            // e.g. 16.3
lisbon.monthly.jul;        // July mean, °C
lisbon.warmestMonth;       // "aug"
cities().length;           // 270

Python

from world_temperature_data import by_city, by_country, cities

lisbon = by_city("Lisbon", "PT")
lisbon["annual_c"]         # e.g. 16.3
lisbon["monthly"]["jul"]   # July mean, °C
lisbon["warmest_month"]    # "aug"
len(cities())              # 270

Data schema

| Field | Type | Description | |-------|------|-------------| | city | string | City name | | countryIso2 / country_iso2 | string | ISO-3166 alpha-2 country code | | lat, lon | number | Coordinates (decimal degrees) | | monthly | object | { jan … dec } mean temperature in °C | | annualC / annual_c | number | Mean annual temperature, °C | | warmestMonth / coldestMonth | string | Extreme months (e.g. "aug", "jan") | | source | string | Methodology label |

The raw CSV ships in the package (world_temperature_data/world-temperature.csv).

Pairs well with

sunshine-hours-by-city, world-rainfall-data, and georank — rank cities by weighted climate criteria. See it live at georank.place.

License

Data: CC-BY-4.0 © GeoRank.place. Attribution required — see ATTRIBUTION.md. Package code: MIT.