Sobre el proyecto
# odp-stockholm
Un cliente asíncrono de Python para los conjuntos de datos abiertos de Estocolmo, Suecia. Se comunica con la API de la Plataforma de Datos Abiertos de la ciudad para que las aplicaciones de Python puedan extraer conjuntos de datos sin tener que escribir solicitudes HTTP manualmente.
## Qué hace
El paquete fue creado originalmente para obtener únicamente datos de estacionamiento, pero la base de código está organizada deliberadamente para que se puedan añadir otros conjuntos de datos de la misma plataforma más adelante. El README documenta actualmente un conjunto de datos:
- **Estacionamientos para personas con discapacidad** (rörelsehindrade förare med särskilt tillstånd) — aproximadamente 2045 ubicaciones.
## Requisitos y acceso
El uso de los datos requiere una clave API, que puede solicitarse en el sitio web de la plataforma. El proyecto está dirigido a Python 3.12 o posterior y se distribuye en PyPI como `odp-stockholm`.
## Instalación y uso
```bash
pip install odp-stockholm
```
El cliente se utiliza como un gestor de contexto asíncrono. El ejemplo documentado instancia `ParkingStockholm` con una clave API y llama a `disabled_parkings(limit=10)`, imprimiendo las ubicaciones devueltas.
## Campos del conjunto de datos
Las solicitudes aceptan un parámetro `limit` (por defecto 10). Los registros devueltos incluyen:
- `location_id`, `location_type`, `number` de plazas de estacionamiento
- `street`, `address`, `district`
- `parking_rate` y `parking_rules` (una URL a las regulaciones de estacionamiento de Estocolmo)
- `valid_from` y `valid_to` (este último puede ser `None`)
- `coordinates` como una lista de floats
## Configuración de desarrollo
El proyecto utiliza Poetry para la gestión de dependencias y puede abrirse en un Dev Container de VS Code o en un GitHub CodeSpace. Los commits se revisan y prueban a través del marco de hooks `prek` (`poetry run prek install`, `poetry run prek run --all-files`). Las pruebas utilizan pytest, incluyendo pruebas de snapshot de syrupy que pueden actualizarse con `poetry run pytest --snapshot-update`.
## Licencia
Publicado bajo la Licencia MIT, copyright Klaas Schoute (2023–2026).
## Notas para evaluadores
Esta es una biblioteca de acceso a datos enfocada en lugar de una aplicación completa: su valor reside en proporcionar acceso asíncrono y tipado a una fuente de datos abiertos municipal y una plantilla que puede extenderse a más conjuntos de datos de Estocolmo. No está afiliada ni respaldada por la Ciudad de Estocolmo; los usuarios proporcionan su propia clave API y están sujetos a los términos de la plataforma.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.