Nominatim/docs/api/Overview.md
2023-08-28 10:31:58 +02:00

1.1 KiB

Nominatim API

!!! Attention The current version of Nominatim implements two different search frontends: the old PHP frontend and the new Python frontend. They have a very similar API but differ in some implementation details. These are marked in the documentation as [Python-only] or [PHP-only].

`https://nominatim.openstreetmap.org` implements the **Python frontend**.
So users should refer to the **`[Python-only]`** comments.

This section describes the API V1 of the Nominatim web service. The service offers the following endpoints:

  • /search - search OSM objects by name or type
  • /reverse - search OSM object by their location
  • /lookup - look up address details for OSM objects by their ID
  • /status - query the status of the server
  • /deletable - list objects that have been deleted in OSM but are held back in Nominatim in case the deletion was accidental
  • /polygons - list of broken polygons detected by Nominatim
  • /details - show internal details for an object (for debugging only)