Version 0.2

This release upgrades to GeoDesk for Java 0.2.

There are no functional changes.

Version 0.1.10

Bug Fixes

• Fixed Box.metersAroundLonLat() (#95, thanks @tobinam!)

• gol query: CSV output fills empty cells to maintain proper column structure (#108)

Deprecations

• We will introduce a simpler, streamlined API in Version 0.2. Specifically, methods from Node, Way and Relation will migrate to the Feature superclass, eliminating the need for casting and use of awkward generics (Features<?> becomes just Features). The most common filters will be accessible directly from Features (roads.select(crosses(river)) becomes roads.crosses(river)). These changes are part of our broader effort to align the Java and Python toolkits and make it easier for developers to transition between them.

Version 0.1.9

Bug Fixes

• OsmPbfReader now shuts down cleanly when reading a corrupt source file (#104) -- this bug caused gol build to hang on truncated .osm.pbf files.

• gol build: Fixed encoding bug that caused access to certain way-nodes to fail (#105)
  Note: We recommend re-building any GOL with more than 16K tiles

Other Changes

• MapMaker now uses the standard OSM Carto style by default (clarisma/geodesk-py#17)

Version 0.1.8

Bug Fixes

• query: Newlines in tag values are now properly escaped in GeoJSON output, as well as other output formats (#93; #101)

Other

• Upgraded JUnit from version 4.12 to 4.13.2

Version 0.1.7

Enhancements

• FeatureLibrary now supports AutoCloseable (clarisma/geodesk#85)

Bug Fixes

• Tags.toMap() returns an empty collection instead of null for features without tags (clarisma/geodesk#84)

• build: Fixed bug which caused analysis to fail if none of the strings in a batch meet the minimum string count (#99)

• build: Buildcontext.getTileCatalog() explicitly unmaps the metadata segment; an active mapping could prevent the created GOL from closing properly in cases where GC does not run (#100)

Version 0.1.6

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 (#92)

• gol build: Fixed potential race condition (#96)

• gol build: Suppressed Analyzer log message

Version 0.1.4

New Features

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

• gol build: Option tag-duplicate-nodes (clarisma/geodesk#74)

• gol build: Option tag-orphan-nodes (clarisma/geodesk#73)

• 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/geodesk#75)

Bug Fixes

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

Version 0.1.3

GeoDesk 0.1.3 Early Access

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 (#74)

• --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

Version 0.1.2

GeoDesk 0.1.2 Early Access

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

Version 0.1.1

GeoDesk 0.1.1 Early Access

This maintenance release enables support for OSM-XML output (-f=xml) and fixes the handling of geometry collections in GeoJSON output.

Please note that as this is still an Early Access release, some documented features may not yet be available. Specifically, Version 0.1.1 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/geodesk#40)

• 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!