Geodesk

Performance Improvements

- `gol build`: Building planet-size GOLs completes faster and consumes less storage for temporary files


Bug Fixes

- `gol build`: Fixed deadlock with invalid input files (clarisma/gol-tool92)

- `gol build`: Fixed potential race condition (clarisma/gol-tool96)

- `gol build`: Suppressed Analyzer log message

New Features

- `gol build`: Build settings are now accepted as command-line options

- `gol build`: Option `tag-duplicate-nodes` (clarisma/geodesk74)

- `gol build`: Option `tag-orphan-nodes` (clarisma/geodesk73)

- `gol info`: Now displays statistics for tiles (`-t`) and free pages (`-f`);
enhanced statistics for indexes (`-i`)

- `gol query`: Two new report types for Tag & Role Statistics (`-f=stats`): `keys` and `tags`


Breaking Changes

- Placeholder features are now tagged with `geodesk:missing=yes` instead of
`geodesk:error=missing` (clarisma/geodesk75)

Bug Fixes

- Fixed linker behavior for sparse-tile relations that reference missing features;
back-links now work correctly for this edge case.

==========================

New Features

- `gol query`: Tag & Role Statistics (`-f=stats`) -- *Preview*

Enhancements

- `gol query`: XML output now contains `upload=never` attribute to signal JOSM (and other editors that support this tag) that the data should not be uploaded to the OSM server (XML output can be viewed in JOSM, but is not suitable for submitting changes since untagged nodes are re-generated with synthetic IDs)

- `gol query` (`map` output format):

- Set base map and attribution (`-f:basemap` / `-f:attribution`)

- Customize color of map markers (Option `-f:color`)

- Clicking on a map marker now navigates to a URL. URL can be specified via option `-f:link`, defaults to main OSM website (clarisma/gol-tool74)

- `--precision` default is now 7 (previously 6) to match the standard OSM coordinate precision

Bug Fixes

- Fixed rounding error in the conversion of coordinates between WGS-84 and Mercator; conversion is now guaranteed to be lossless up to 100-nanodegree precision (`--precision=7`; excludes latitudes exceeding 85 degrees, which are clipped)

- Fixed bug that caused GOL files to be created non-sparse, which increased storage consumption

- `gol query`: Significantly increased the performance of output formatters (x 10 for certain formats) by fixing a buffering issue

Miscellaneous

- `ProgressReporter` is now part of the GeoDesk library

==========================

This maintenance release includes the following updates:

- Preview of fast spatial predicates

- GOQL: keys and values no longer need to be enclosed in quotes if they contain non-ASCII characters

- `Feature`: Implemented `doubleValue()` and `isPlaceholder()`

- `Relation.toGeometry()` now creates `MultiLineString` and `MultiPoint` for homogeneous geometry collections

- Enabled querying parent ways of anonymous nodes

- Query output in OSM-XML format now recursively adds child relations

We are pleased to release GeoDesk Version 0.1.0 EA.

Please note that as this is still an Early Access release, some documented features may not yet be available. Specifically, Version 0.1.0 has the following limitations:

- Querying relation members by role is not yet supported. As a workaround, you can programmatically check `role()` of each `Feature` object returned by a member query.

- The query predicates `of()` and `with()` are not yet supported. As a workaround, rephrase these queries using `members()` and `parentRelations()`.

- Queries whose bounding boxes straddle the Antimeridian must be executed as two separate queries with normalized bboxes. (Issue clarisma/geodesk40)

- Regular expressions in queries are not yet supported. Wildcards expressions can accomplish the same result in most cases: `k="prefix*"`, `k="*postfix"`, `k="*infix*"` (Can also be combined: `w[highway][name="A*"][name="*weg"]` finds all streets whose name starts with "A" and ends with "weg").

- Spatial predicates are currently limited to `intersects`, `crosses`, `within` and `metersFromLonLat`. We expect to implement support for a full range of predicates shortly.

- The `gol` command-line utility does not yet support the `copy`, `remove`, `retain` and `vacuum` commands. Some minor options of `query` are not yet implemented.

We plan to ship at least one maintenance release before year-end, and expect Version 0.2 in Q1 2023. Please submit comments or reactions on the issues that you care most about, so we can prioritize our tasks.

Happy querying!