A Node.js CLI tool and library to query OpenStreetMap's Overpass API and output results as GeoJSON.
query-overpass is a Node.js tool that queries OpenStreetMap's Overpass API and returns the results as GeoJSON. It solves the problem of accessing and converting OpenStreetMap data into a standard geospatial format usable by mapping libraries and GIS tools.
Developers and data analysts working with OpenStreetMap data who need to extract geospatial information programmatically or via command-line scripts.
It simplifies Overpass API interactions by handling query execution and GeoJSON conversion in one step, eliminating the need for manual parsing and formatting of Overpass responses.
Make queries to OpenStreetMap's overpass API and output as GeoJSON
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.
Automatically converts Overpass API responses to standardized GeoJSON, making data immediately usable with libraries like Mapbox and Leaflet, as demonstrated in the CLI example with geojsonio.
Provides a command-line interface that enables piping results to other tools, facilitating seamless integration into shell scripts and data pipelines, as shown with the geojsonio-cli example.
Supports specifying alternative Overpass URLs via the --overpass-url option, useful for self-hosted instances or avoiding rate limits on public endpoints.
Offers an optional --flat-properties flag to flatten GeoJSON feature properties, simplifying downstream data processing, though it defaults to false for backward compatibility.
Users must write raw Overpass QL queries manually, which can be complex and error-prone for those new to the syntax, with no built-in helper functions or query builder.
Error callback only provides a message and statusCode, lacking advanced features like automatic retries, detailed network diagnostics, or caching for failed queries.
Limited to Node.js environments, making it unsuitable for browser-based projects or platforms without Node.js, as indicated by its npm installation requirement.