OpenStreetMap local mailing list directory

Discover local OpenStreetMap mailing lists: search | API | GitHub | contact


API

The API is accessed via an HTTP GET request. Location can be specified either with a search string, OSM element, or location coordinates.

Parameters:

Callers should supply a single group of parameters, either q OR osm_type & osm_id OR lat & lon.

The endpoint is https://local.openstreetmap.directory/api/1/lookup

The response is in JSON format, it includes the lookup parameters and the suggested mailing list. For search string queries it also includes the coordinates of the matching object.

If the lookup triggers an error then the response consist of the calling parameters and an error message. For testing a simulated error can be generated using the error parameter.

Examples

Query by search: /api/1/lookup?q=Rome

Response:

{
  'local_match': true,
  'list': 'Talk-it-lazio',
  'lat': 41.893,
  'lon': 12.483,
  'q': 'Rome'
}

Non-existent place: /api/1/lookup?q=Zerzura

Response:

{
  'local_match': false,
  'list': 'talk',
  'q': 'Zerzura'
}

Search with coordinates parameters: /api/1/lookup?lat=47.6&lon=-122.3

Response:

{
  'local_match': true,
  'list': 'Talk-us-pugetsound',
  'lat': 47.6,
  'lon': -122.3
}

Search with osm parameters: /api/1/lookup?osm_type=R&osm_id=295355

Response:

{
  "local_match": true,
  "list": "Talk-gb-midanglia",
  "osm_type": "R",
  "osm_id": 295355
}

Search with coordinates in query: /api/1/lookup?q=47.6,-122.3

Response:

{
  'local_match': true,
  'list': 'Talk-us-pugetsound',
  'lat': 47.6,
  'lon': -122.3,
  'q': '47.6,-122.3'
}

Simulated error: /api/1/lookup?q=England&error=sample+error

Response:

{
  'error': 'sample error',
  'q': 'England'
}