pySpainMobility Documentation¶
Standardized access to Spain’s official mobility datasets
Welcome to the documentation for pySpainMobility - an open-source Python package developed by the research community to access, download, and standardize mobility data published by the Spanish Ministry of Transportation and Sustainable Mobility.
Note
This is a FIRST release (both library and documentation). Please report any issues or suggestions via our GitHub repository.
Key Features¶
- 🔍 Access daily mobility datasets (versions 1 & 2) covering:
Municipalities and districts
Greater urban areas
Time periods from February 2020 to 2021 and from 2022 to present
📦 Standardized data structures for consistent analysis
🌐 Built-in spatial tessellation handling
📈 Designed for research reproducibility and policy applications
Getting Started¶
Installation¶
# Using conda
conda install -c conda-forge pyspainmobility
# pip installation
pip install pyspainmobility
Citing pySpainMobility¶
If you use this package in your research, please cite:
Beneduce, C., et al. (2025). pySpainMobility: A Python Package to Access and
Manage Spanish Open Mobility Data.
BibTeX entry:
@misc{beneduce2025pyspainmobility,
title={pySpainMobility: a Python Package to Access and Manage Spanish Open Mobility Data},
author={Ciro Beneduce and Tania Gullón Muñoz-Repiso and Bruno Lepri and Massimiliano Luca},
year={2025},
eprint={2506.13385},
archivePrefix={arXiv},
primaryClass={cs.CY},
url={https://arxiv.org/abs/2506.13385},
}