fn_registry/python/functions/infra/osm2pgsql_ingest.md

name, kind, lang, domain, version, purity, signature, description, tags, uses_functions, uses_types, returns, returns_optional, error_type, imports, params, output, tested, tests, test_file_path, file_path, source_repo, source_license, source_file

name	kind	lang	domain	version	purity	signature	description	tags	uses_functions	uses_types	returns	returns_optional	error_type	imports	params	output	tested	tests	test_file_path	file_path	source_repo	source_license	source_file
osm2pgsql_ingest	function	py	infra	1.0.0	impure	osm2pgsql_ingest(osm_pbf_path: str | Path, host: str = 'localhost', port: int = 5432, dbname: str = 'gis', user: str = 'geoserver', password: str = 'geoserver', style: str | None = None, ensure_hstore: bool = True) -> dict	Ingesta un archivo .osm.pbf en PostGIS usando osm2pgsql con --create --slim --hstore --multi-geometry. Verifica osm2pgsql en PATH, opcionalmente crea extensión hstore. Retorna dict {ok, rows_loaded, stderr}.	osm postgis gis osm2pgsql infra pendiente-usar				false	error_go_core	os shutil subprocess pathlib	name desc osm_pbf_path Ruta al archivo .osm.pbf a ingestar. name desc host Host de PostGIS (default: localhost). name desc port Puerto de PostGIS (default: 5432). name desc dbname Nombre de la base de datos PostGIS (default: gis). name desc user Usuario de la base de datos (default: geoserver). name desc password Contraseña de la base de datos (default: geoserver). name desc style Ruta opcional a archivo .style de osm2pgsql. Si None usa el estilo por defecto. name desc ensure_hstore Si True, ejecuta psql para crear la extensión hstore antes de la ingesta.	dict con ok (bool), rows_loaded (int|None, siempre None porque osm2pgsql no reporta conteos), stderr (str con salida combinada stdout+stderr).	true	lanza FileNotFoundError con path inexistente lanza RuntimeError si osm2pgsql no esta en PATH	python/functions/infra/tests/test_osm2pgsql_ingest.py	python/functions/infra/osm2pgsql_ingest.py	internal:footprint_aurgi	internal-aurgi	better_maps/ingest_osm.py

Ejemplo

result = osm2pgsql_ingest(
    "data/spain-latest.osm.pbf",
    host="localhost",
    dbname="gis",
    user="geoserver",
    password="secret",
)
if result["ok"]:
    print("Ingesta completada")
else:
    print(result["stderr"])

Notas

Requiere osm2pgsql en el PATH. Lanza RuntimeError si no está disponible. El campo rows_loaded siempre es None: osm2pgsql no reporta conteos de filas en su salida estándar. Para obtener conteos, consultar directamente las tablas planet_osm_* en PostGIS. La contraseña se pasa via PGPASSWORD en el entorno del subproceso.