pySpainMobility: a Python Package to Access and Manage Spanish Open Mobility Data

TL;DR

pySpainMobility is a Python package that simplifies access to Spanish mobility datasets, enabling researchers and policymakers to perform reproducible analyses on large-scale mobility data for societal challenges.

Contribution

The paper introduces pySpainMobility, a Python library that provides standardized, easy-to-use access to Spanish mobility datasets, facilitating research and policy applications.

Findings

Enables easy access to large-scale mobility data

Supports reproducible research and analysis

Facilitates societal challenge solutions

Abstract

Mobility patterns play a critical role in a wide range of societal challenges, from epidemic modeling and emergency response to transportation planning and regional development. Yet, access to high-quality, timely, and openly available mobility data remains limited. In response, the Spanish Ministry of Transportation and Sustainable Mobility has released daily mobility datasets based on anonymized mobile phone data, covering districts, municipalities, and greater urban areas from February 2020 to June 2021 and again from January 2022 onward. This paper presents pySpainMobility, a Python package that simplifies access to these datasets and their associated study areas through a standardized, well-documented interface. By lowering the technical barrier to working with large-scale mobility data, the package enables reproducible analysis and supports applications across research, policy, and operational domains. The library is available at https://github.com/pySpainMobility.