Atlas

Librería Python para FastAPI que publica tablas y vistas de PostGIS como capas geográficas vía WMS y WFS, con API de consulta, filtrado, descarga y exportación de mapas.

Sin GeoServer. Sin proceso aparte. Es una librería que vive dentro de tu aplicación.

Estado: v0.1.0 — MVP disponible como release en GitHub. Ver roadmap.

Instalación

pip install atlas-geo              # núcleo: WMS, WFS, API, GeoJSON, CSV
pip install atlas-geo[export]      # + GeoPackage y Shapefile

Requiere Python 3.11+ y PostgreSQL 14+ con PostGIS 3.

Uso

from fastapi import FastAPI
from atlas import Atlas

app = FastAPI()
geo = Atlas(database_url="postgresql://user:pass@localhost/gis")

@app.on_event("startup")
async def startup() -> None:
    await geo.startup()
    await geo.register_layer("geo.municipios", title="Municipios de Jalisco")

app.include_router(geo.router)

Eso publica, para cada capa registrada:

El esquema, la columna de geometría, el SRID, la llave primaria, los atributos y el extent se descubren solos por introspección: solo hace falta el nombre de la tabla.

Filtros

Misma sintaxis en WFS y en descargas:

/atlas/layers/municipios/download?format=csv&poblacion__gt=100000&estado=Jalisco

Operadores: eq ne gt gte lt lte in like, más bbox. Los nombres de columna se validan contra los atributos reales de la capa y los valores van parametrizados — nunca se concatena SQL. Ver security.md.

Documentación

Alcance

Atlas cubre lo que un geoportal usa de verdad, no el estándar OGC completo (ADR 0003):

Sí: PostGIS, datos vectoriales, WMS 1.3.0 (GetCapabilities, GetMap, GetFeatureInfo), WFS 2.0.0 de lectura (GetCapabilities, DescribeFeatureType, GetFeature), GeoJSON, CSV, GeoPackage, Shapefile, exportación PNG/JPEG.

No: WFS-T, SLD, GML completo, WPS, CSW, Oracle/MySQL/ArcSDE, Shapefile como datasource, motor propio de rendering o reproyección. WMTS, vector tiles y raster son fases posteriores.

Licencia

MIT