Just released: GeoDesk 2.0

General talk
,
1

Hi everyone,

GeoDesk 2.0 is finally out! It makes working with OSM data faster and easier than ever, with a brand-new GOL Tool and streamlined workflows.

GeoDesk is an open-source toolkit for OpenStreetMap data. Turn any .osm.pbf file into a compact Geo-Object Library (less than 100 GB for the whole planet) and perform ultra-fast queries, via the command line or Java, Python or C++.

What’s new:

  • The GOL Tool is now a stand-alone executable (< 1 MB), no JVM required (supports Windows, Linux and Intel/ARM macOS)

  • 2x to 10x faster operations: build a planet-scale GOL in 15 minutes (on a reasonably modern workstation); extract all the world’s rivers as GeoJSON in a few seconds

  • Simplified command options, progress bars, and colorized output

  • gol query now includes an interactive mode for complex queries

  • Visualize query results instantly with the new gol map command (Example below: all sushi restaurants in France)

gol-tool-in-action
gol-tool-in-action1128×827 120 KB

See the full list in the release notes.

We’ve redesigned the GOL format to be even more compact and efficient, and to enable incremental updates. Full update support will ship later this year.

The new format requires GeoDesk SDK 2.0 or later. While the query API remains unchanged, you should see performance gains from the upgrades.

To ease the transition, we’ll continue maintaining the 1.x line. Documentation for 1.x remains available at docs1.geodesk.com.

GOL Tool: download • repo • documentation

GeoDesk for Python: pip install geodesk -U • repo • documentation

GeoDesk for Java: repo • documentation • JavaDoc

GeoDesk for C++: repo • documentation • API docs

We’d love to hear your feedback, ideas, and use cases. Thanks for all of your support in getting us this far!

3 Likes
2

Build of germany.gol was successful, but the process took all of my 16 GB mem, so machine was swapping… :wink:

1 Like
3

There’s a small typo in the URL: Release Version 2.0.0 · clarisma/geodesk-gol · GitHub.

Congratulations on the release!

1 Like
4

Help command does not work:

Use gol help <command> for detailed documentation.

I tried: gol help map
→ Unknown command: help

1 Like
5

That sounds about right, the indexes alone will take up about 12 GB. How long did it take to finish?

6

Thanks!! (Link is now fixed)

1 Like
7

Good catch, thanks. I haven’t decided yet whether gol help should open up the doc website (like GOL 1.x), or whether to keep help text-based and self-contained (so it always matches the version you’re actually running).
For now, you can also run the command itself, without any parameters, and it will display help on the various options (e.g. gol map)

8

If I remember correctly: 7 minutes.

1 Like