GeoRocket 1.3.0

The new stable version of GeoRocket is out now!

Although the previous version was released only two months ago, the all new GeoRocket 1.3.0 comes with a large number of new features, fixes, and updates. We particularly focused on performance and scalability to make this the fastest version available. We also worked on usability a lot and performed extensive tests on Amazon Web Services AWS with huge datasets to further improve GeoRocket’s stability and use for real-world applications.


There are two features in this release that we want to highlight. A complete list of changes can be found below.

Performance: Low-latency optimistic merging

Besides many performance improvements (e.g. better scalability during import and indexing, faster queries, HTTP compression), we implemented a new feature called low-latency optimistic merging, which tremendously improves query performance.

In GeoRocket, the result of a query is a file consisting of the merged chunks matching the query. In order to create valid output files, GeoRocket has to look at all chunks before it can actually render them. The process of exporting a file is as follows:

  1. The client sends a query to GeoRocket.
  2. GeoRocket forwards the query to the index to identify matching chunks.
  3. It then loads the chunk metadata from the index and creates a valid header for the output file.
  4. GeoRocket loads the chunks from the storage back-end.
  5. Finally, it sends the rendered output file to the client.

If your data store contains heterogeneous XML data, GeoRocket has to load the XML namespaces of all matching chunks in step 3 to create an XML header containing all these namespaces. The time it takes to render the first chunk back to the client therefore directly depends on how many chunks match the query. While this is usually very fast, it does not scale arbitrarily and can take a few seconds for a multi-gigabyte dataset.

However, if you know that your data store contains homogeneous data or if your query matches homogeneous chunks—which is the case for most datasets and queries we’ve seen in production—you can enable low-latency optimistic merging to skip step 3 completely. GeoRocket will then render the first chunk to the client as soon as it has been loaded from the storage back-end, which usually happens within a few milliseconds.

Low-latency optimistic merging always works for GeoJSON data. So, if you only deal with GeoJSON, you can leave this feature enabled all the time. If you work with XML, you should make sure your data is homogeneous and all chunks use the same XML namespaces. If they don’t, the chunks that cannot be merged will be skipped.

Low-latency optimistic merging is available through the HTTP interface and as a command-line parameter. The number of skipped chunks (if there are any) will be returned through an HTTP trailer or written to the standard error stream, respectively.

Usability: Import progress

The command-line interface (CLI) now shows beautiful and detailed information on the progress while importing files into GeoRocket. Watch the following screencast to see the new feature in action:

Detailed list of changes

New features

Command-line application

  • Display progress while importing
  • Print metrics at the end of import process
  • Compress communication with the GeoRocket server
  • Add options to enable low-latency optimistic merging
  • Print number of unmerged chunks

Server API

  • Improve usability of server API

Client API

  • Add possibility to enable low-latency optimistic merging
  • Add API to get number of unmerged chunks

Bug fixes

  • Import a file only after it has been written/closed completely
  • Fix NOT queries with embedded EQ clause
  • Add missing documentation for scrolling

Internal changes

  • Update Vert.x to 3.5.3
  • Upgrade Elasticsearch to 6.3.2
  • Upgrade Gradle Wrapper to 4.10
  • Reduce log output

More information

The new version is recommended for all users. Try GeoRocket 1.3.0 while it’s still hot! 🔥


For a complete list of features visit our website. There you will also find the user documentation and other information.

If you have questions, ideas or comments regarding GeoRocket or any of our other services feel free to contact us.