Geobuf (Protobuf-encoded GeoJSON)
Open BetaGeobuf es un empaquetado binario compacto de GeoJSON sobre Protocol Buffers, creado en Mapbox (Vladimir Agafonkin, 2015). Codifica los mismos objetos que GeoJSON, pero normalmente entre 6 y 8 veces más pequeño gracias a los varint, la codificación delta de las coordenadas y un diccionario de claves; al decodificar se recupera un GeoJSON equivalente, sin pérdidas. Es una capa de transporte para mapas móviles, cachés CDN en el borde y almacenamiento en IndexedDB, no un formato analítico. Nuestro exportador arma una FeatureCollection a partir de las capas OSM y la codifica en protobuf .pbf real con 6 decimales de precisión (~0,1 m). Importante: el formato es honesto — si la codificación falla, la exportación termina con error; NO sustituimos el resultado por un GeoJSON comprimido con gzip bajo el nombre .pbf.
Características principales
Acerca del formato Geobuf
Geobuf resuelve una sola tarea: el mismo GeoJSON, pero varias veces más pequeño. En lugar de texto, Protocol Buffers; en lugar de nombres de propiedades repetidos, un diccionario de claves; en lugar de coordenadas completas, las diferencias entre puntos vecinos escritas con números de longitud variable. El significado de los datos no cambia; solo cambia el empaquetado.
Es un formato de transporte. Se elige cuando hay que entregar los datos: a una aplicación móvil con mala red, a un nodo de CDN, al almacenamiento offline del navegador. Calcular estadísticas o editar objetos directamente en él es incómodo: para eso primero se decodifica de vuelta a GeoJSON.
En el archivo hay una única FeatureCollection con todas las capas seleccionadas, codificada en protobuf real. Las coordenadas se redondean a seis decimales, unos diez centímetros sobre el terreno, de sobra para el detalle urbano. Los atributos de OpenStreetMap se conservan.
No hay sustituciones: si la codificación falla, la exportación termina con error. Entregar un archivo GeoJSON comprimido con gzip bajo la extensión .pbf sería más fácil, pero la biblioteca geobuf no podría decodificarlo, así que sería inútil.
Programas para abrir archivos Geobuf
Los siguientes programas y aplicaciones pueden abrir, editar y procesar archivos Geobuf (Protobuf-encoded GeoJSON) (.pbf) exportados desde OSM2CDR:
Format specifications
- Open standard
- 2D only
- Lossless (no quality loss)
- Stores feature attributes
- Output: 1 file
- Real protobuf .pbf encoding a GeoJSON FeatureCollection at 6-digit precision (~0.1 m); honest guarantee — real Geobuf or an error, never a gzipped-GeoJSON substitution.
Quién usa los mapas Geobuf
Cómo exportar a Geobuf
Cómo abrir tras la exportación
- JavaScript — npm install geobuf pbf y luego geobuf.decode(new Pbf(buffer)) devolverá un GeoJSON listo que puede pasar directamente a Leaflet o Mapbox GL.
- Python — pip install geobuf y luego geobuf.decode(open("map.pbf", "rb").read()); a partir de ahí, trabajo normal con GeoJSON o carga en GeoPandas.
- Aplicación móvil — el archivo se incluye en los recursos o se descarga del servidor: decodificarlo lleva fracciones de segundo y consume varias veces menos tráfico.
- Sin conexión en el navegador — el resultado decodificado se guarda cómodamente en IndexedDB y permite redibujar el mapa sin red.
- Solo para verlo — decodifíquelo a GeoJSON y arrástrelo a geojson.io: el .pbf en sí no lo muestra ningún visor.
Mapas populares en Geobuf
Exportar mapas a Geobuf (Protobuf-encoded GeoJSON)
Descarga mapas Geobuf profesionales desde OpenStreetMap. Generación instantánea, cualquier área.