[Geocoding] Nominatim Release 3.2.0

[Sarah Hoffmann]

Hi,

we are proud to announce a new Nominatim release 3.2.0.

This release brings two new output formats and a complete rewrite of
the reverse geocoding algorithms.

We have added two new output formats for all API endpoints: geojson and
geocodejson. The latter also exports for the first time address details
by OSM admin level, which may be a help for all that want to process
specific address parts further. Refer to the new documentation on output
formats[1] for details.

The reverse algorithm has been largely rewritten to deliver better results
in sparsely populated areas and when looking for administrative entities
(town, country etc.). For details refer to the original outline of the
algorithm[2]. The new algorithm will also ensure that reverse geocoding
coordinates on a road only return results that reference that road.
Previously it was possible to end up on a nearby building that belonged
to another road.

Next to these two major changes, there are a number of bug fixes and code
cleanup. For a more complete list of changes, see the ChangeLog file.

If you want to update from 3.x.x, there is a database migration path
described in the migration guide[3]. Migrating from 3.1.0 can be done
without problems. When updating from 3.0.x, a full database reimport
is strongly recommended. Updating from older releases is only possible
with a database reimport.

As always, the release can be downloaded from https://nominatim.org.
Starting with this release, this is now also the place to find
the authoritative API documentation. We will retire the old documentation
on the OSM wiki in the next couple of days.

Kind regards

Sarah

[1] https://nominatim.org/release-docs/latest/api/Output/
[2] https://github.com/openstreetmap/Nominatim/issues/512#issuecomment-250012997
[3] https://nominatim.org/release-docs/latest/admin/Migration/