https://github.com/jake-low/overpass-cli

Command line tool for querying OpenStreetMap data using the Overpass API
https://github.com/jake-low/overpass-cli

Last synced: about 2 months ago
JSON representation

Command line tool for querying OpenStreetMap data using the Overpass API

• Host: GitHub
• URL: https://github.com/jake-low/overpass-cli
• Owner: jake-low
• License: isc
• Created: 2024-09-13T07:29:19.000Z (3 months ago)
• Default Branch: main
• Last Pushed: 2024-09-13T07:48:04.000Z (3 months ago)
• Last Synced: 2024-09-13T20:18:50.176Z (3 months ago)
• Language: Rust
• Homepage:
• Size: 12.7 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# overpass-cli

A command line tool for querying OpenStreetMap data using the Overpass API.

> [!IMPORTANT]

> By default, this tool makes requests to [overpass-api.de](https://overpass-api.de/), which is a public server generously offered to the OpenStreetMap community free of charge. It is intended primarily for running manual queries and other low-volume use. Please do not abuse this service by making excessive requests or downloading enormous amounts of data. [See the usage policy for more info](https://dev.overpass-api.de/overpass-doc/en/preface/commons.html).

## Example

This invocation finds nodes tagged `natural=arch` in a bounding box roughly covering Arches National Park in Utah, and returns them as JSON.

```

$ overpass --bbox -109.723 38.602 -109.469 38.856 --format json 'node[natural = arch]'

{

  "version": 0.6,

  "generator": "Overpass API 0.7.62.1 084b4234",

  "osm3s": {

    "timestamp_osm_base": "2024-09-13T07:18:29Z",

    "copyright": "The data included in this document is from www.openstreetmap.org. The data is made available under ODbL."

  },

  "elements": [

    {

      "type": "node",

      "id": 759250908,

      "lat": 38.7911745,

      "lon": -109.6089896,

      "tags": {

        "name": "Navajo Arch",

        "natural": "arch"

      }

    },

    ...

  ]

}

```

## Usage

```

Usage: overpass [OPTIONS] [QUERY]

Arguments:

  [QUERY]  OverpassQL query string (when omitted, query is read from STDIN)

Options:

  -f, --format 

          Output format [possible values: xml, json]

  -o, --out 

          Output type [possible values: ids, skel, body, tags, meta, center, geom]

      --bbox    

          Global bounding box (implicitly applies to all statements)

      --date 

          Return results for a time in the past (ISO 8601 format)

      --diff  

          Compare results at two different times (ISO 8601 format)

      --adiff  

          Like --diff, but returns augmented diff with extra information

      --server 

          Server URL [default: https://overpass-api.de]

      --dry-run

          Construct and print query but do not send to server

````

## Maturity

This tool is an early (v0.x) draft. Please feel free to report bugs or request missing features.

## License

Code for this tool is available under the terms of the ISC License. See the LICENSE file for details.