https://github.com/hyparam/geoparquet
Convert geoparquet to geojson in javascript
https://github.com/hyparam/geoparquet
geo geojson geoparquet geospatial gis hyparquet hyperparam javascript js parquet
Last synced: 11 months ago
JSON representation
Convert geoparquet to geojson in javascript
- Host: GitHub
- URL: https://github.com/hyparam/geoparquet
- Owner: hyparam
- License: mit
- Created: 2024-12-16T22:49:26.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2024-12-21T01:08:38.000Z (over 1 year ago)
- Last Synced: 2025-06-09T23:47:22.848Z (12 months ago)
- Topics: geo, geojson, geoparquet, geospatial, gis, hyparquet, hyperparam, javascript, js, parquet
- Language: JavaScript
- Homepage:
- Size: 664 KB
- Stars: 26
- Watchers: 2
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# GeoParquet
[](https://www.npmjs.com/package/geoparquet)
[](https://www.npmjs.com/package/geoparquet)
[](https://github.com/hyparam/geoparquet/actions)
[](https://opensource.org/licenses/MIT)
[](https://www.npmjs.com/package/geoparquet?activeTab=dependencies)
**GeoParquet** provides a pure JavaScript workflow to read and convert [GeoParquet](https://github.com/opengeospatial/geoparquet) files into [GeoJSON](https://datatracker.ietf.org/doc/html/rfc7946). Under the hood, it uses the [hyparquet](https://github.com/hyparam/hyparquet) library for efficient in-browser parquet parsing, enabling minimal overhead and fast loading.
## Why GeoParquet?
**GeoParquet** is an emerging standard for storing geospatial vector data in the columnar [Parquet](https://parquet.apache.org/) format. By leveraging Parquet’s columnar storage, GeoParquet files can be significantly more compact and faster to query than their GeoJSON equivalents, especially for large datasets. This can result in:
- **Smaller file sizes:** A GeoParquet file plus this lightweight library can often be much smaller than the equivalent GeoJSON, reducing bandwidth costs and improving load times.
- **Faster loading:** Pure JavaScript parsing of Parquet files in the browser, with tiny package size means fast page load times.
- **Seamless integration:** GeoParquet is based on well-established standards (GeoJSON, Parquet), ensuring broad compatibility and extensibility.
## Usage
Convert a GeoParquet file to GeoJSON:
```javascript
const { asyncBufferFromUrl, toGeoJson } = await import('geoparquet')
const file = asyncBufferFromUrl({ url: 'example.parquet' })
const geoJson = toGeoJson({ file })
```
## Demo
Check out the [live demo](https://hyparam.github.io/geoparquet/) to see GeoParquet in action.
## Parquet Compression Formats
By default, geoparquet.js supports the most common parquet compression formats: uncompressed and snappy compression.
To enable support for other compression codecs, such as gzip, brotli, zstd, etc you can use the `compressors` option.
The `hyparquet-compressors` package adds support for all parquet compression codecs:
```javascript
import { asyncBufferFromFile, toGeoJson } from 'geoparquet'
import { compressors } from 'hyparquet-compressors'
const file = asyncBufferFromFile('example.zstd.parquet')
const geoJson = toGeoJson({ file, compressors })
```
## References
- https://geoparquet.org/
- https://github.com/opengeospatial/geoparquet
- https://geojson.org/
- https://datatracker.ietf.org/doc/html/rfc7946
- https://github.com/hyparam/hyparquet
- https://github.com/hyparam/hyparquet-compressors
- https://en.wikipedia.org/wiki/Well-known_text_representation_of_geometry