#osm-pbf #bounding-box #download

app what-osm-pbf

Get the necessary osm pbf files within a bounding box

2 releases

0.1.1 Sep 6, 2024
0.1.0 Sep 5, 2024

#68 in Geospatial

38 downloads per month

MIT/Apache

33KB
747 lines

what-osm-pbf [WOP]

Get the necessary osm.pbf files within a bounding box.

Installation

cargo install what-osm-pbf

Levels

The levels represent the granularity of the areas that will be returned. The levels are as follows:

  • level=0 -> the most granular. It will find the smallest areas possible. In some countries such as England this is likely be at county level.
  • level=1 -> likely to be regional areas within a country.
  • level=2 -> likely to be the at country level.
  • level=3 -> the least granular. Likely to be at continent level.

Example 1

Basic with level=2

wop --bbox=-7.382813,36.129002,-1.702881,38.410558 \
    --level=2

# Output:
#
# ✅ Found 3 osm.pbf files that intersect
# 
# Name: "Algeria", Link: "https://download.geofabrik.de/africa/algeria-latest.osm.pbf"
# Name: "Portugal", Link: "https://download.geofabrik.de/europe/portugal-latest.osm.pbf"
# Name: "Spain", Link: "https://download.geofabrik.de/europe/spain-latest.osm.pbf"

Example 2

Save results to JSON using level=3 for least granular.

wop --bbox=-7.382813,36.129002,-1.702881,38.410558 \
    --level=3 \
    --savejson

# Output:
#
# ✅ Found 2 osm.pbf files that intersect
# 
# Name: "Africa", Link: "https://download.geofabrik.de/africa-latest.osm.pbf"
# Name: "Europe", Link: "https://download.geofabrik.de/europe-latest.osm.pbf"
#
# 🎉 Results saved to what-osm-pbf.json

Example 3

Download the results using level=0 for most granular.

wop --bbox=-7.382813,36.129002,-1.702881,38.410558 \
    --level=0 \
    --download

# Output:
#
# ✅ Found 6 osm.pbf files that intersect
# 
# Name: "Algeria", Link: "https://download.geofabrik.de/africa/algeria-latest.osm.pbf"
# Name: "Portugal", Link: "https://download.geofabrik.de/europe/portugal-latest.osm.pbf"
# Name: "Andalucía", Link: "https://download.geofabrik.de/europe/spain/andalucia-latest.osm.pbf"
# Name: "Castilla-La Mancha", Link: "https://download.geofabrik.de/europe/spain/castilla-la-mancha-latest.osm.pbf"
# Name: "Extremadura", Link: "https://download.geofabrik.de/europe/spain/extremadura-latest.osm.pbf"
# Name: "Murcia", Link: "https://download.geofabrik.de/europe/spain/murcia-latest.osm.pbf"
# 
# Downloading: "https://download.geofabrik.de/africa/algeria-latest.osm.pbf"
# ✓ Downloaded: "/Users/frankjimenez/repositories/what-osm-pbf/target/release/algeria-latest.osm.pbf"
# 
# Downloading: "https://download.geofabrik.de/europe/portugal-latest.osm.pbf"
# ✓ Downloaded: "/Users/frankjimenez/repositories/what-osm-pbf/target/release/portugal-latest.osm.pbf"
# 
# Downloading: "https://download.geofabrik.de/europe/spain/andalucia-latest.osm.pbf"
# ✓ Downloaded: "/Users/frankjimenez/repositories/what-osm-pbf/target/release/andalucia-latest.osm.pbf"
# 
# Downloading: "https://download.geofabrik.de/europe/spain/castilla-la-mancha-latest.osm.pbf"
# ✓ Downloaded: "/Users/frankjimenez/repositories/what-osm-pbf/target/release/castilla-la-mancha-latest.osm.pbf"
# 
# Downloading: "https://download.geofabrik.de/europe/spain/extremadura-latest.osm.pbf"
# ✓ Downloaded: "/Users/frankjimenez/repositories/what-osm-pbf/target/release/extremadura-latest.osm.pbf"
# 
# Downloading: "https://download.geofabrik.de/europe/spain/murcia-latest.osm.pbf"
# ✓ Downloaded: "/Users/frankjimenez/repositories/what-osm-pbf/target/release/murcia-latest.osm.pbf"

License

See LICENSE

Dependencies

~14–27MB
~400K SLoC