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
Please report 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
⚡ Arrow-first mobility parsing with automatic pandas fallback
📈 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},
}