README.md

japandata

japandata is a python library that provides easy access to detailed geographic data about Japan.

• japandata.maps: Maps of Japan, its prefectures, and municipalities
• japandata.population: Demographic data
• japandata.indices: Fiscal health indicators
• japandata.readings: Kana and romaji readings of place names

Check out my blog post for some of the motivation behind this package.

japandata.maps

National, prefectural, and municipal topojson maps from 1920 to today.

from japandata.maps import load_map

prefecture_map = load_map(date=2022, scale='jp_pref', quality='coarse')

See notebooks/maps.ipynb to understand the different types of maps that can be loaded.

• Source: Asanobu Kitamoto, ROIS-DS Center for Open Data in the Humanities
• License: CC BY-SA 4.0

japandata.population

National, prefectural, and municipal demographic data annually from 1967.

from japandata.population.data import japan_pop, pref_pop, city_pop,
                                      japan_age, pref_age, city_age

• japan_pop, pref_pop, city_pop: Contain data on total population, gender split, number of households, births, deaths, and migrations, for Japanese and non-Japanese residents.
• japan_age, pref_age, city_age: Contain age distributions split by gender for Japanese and non-Japanese residents.

See notebooks/population.ipynb for example uses of this dataset.

• Source: Basic Register of Residents via Official Statistics Portal Site
• License: CC BY 4.0 International

japandata.indices

Fiscal health indices for municipal and prefectural governments annually from 2005. These indices are used to e.g. determine fiscal transfers between municipalities.

from japandata.indices import city, pref, prefmean

city covers municipal governments, pref covers prefectural governments, and prefmean provides weighted means of municipal indices grouped by prefecture.

See notebooks/indices.ipynb for example uses of this dataset.

• Source: Ministry of Internal Affairs
• License: CC BY 4.0 International

japandata.readings

Kana and romaji pronunciation information for Japanese place names.

from japandata.readings import city_names, pref_names

See notebooks/readings.ipynb for code to integrate this information with the maps.

Installation

$ pip install japandata

Licenses

• Code: MIT
• Data: Noted above