How to add address resolved by OSM reverse geocoding into the message?

Using plugins to resolve position coordinates into address using Nominatim OSM reverse geocoding API and add it into the device messages.

The "nominatim-reverse-geocoding" plugin type is used to apply Nominatim OSM reverse geocoding functionality to resolve position coordinates into the specific address.

Click on the "+" button in the Telematics Hub -> Plugins section to create a new plugin:

flespi panel telematics hub plugins

Let's define a new plugin to resolve coordinates into addresses:

Use extratags to request specific features from your Nominatim server. For example you may receive the maxspeed value to retrieve posted speed limit according to the device position, compare it with the speed reported by the device (position.speed parameter) and trigger the over-speeding alert either with calculator or plugin

In case authorization is required, you can configure a custom HTTP headers array. For example Authorization: Basic XXX.

Note: here are the instructions to install and run Nominatim on your server.

Then we need to assign this plugin to the right devices. Go to the Plugins tab for the required device and click the "+" button:

assign osm nominatim reverse geocoding plugin

And then you should be able to see the address fields in the new device messages. Go to the Logs & Messages tab for the given device to check:

check address added by osm nominatim reverse geocoding plugin

Done.

Performance and stability considerations

  • The use of plugins may result in slower messages registration in the flespi platform since it is preceded by requests to the third-party system.
  • We cannot guarantee the performance or stability of the third-party systems involved in the process — in case of their service interruptions flespi will not be able to save messages to devices and will respond with negative ACK and will also terminate the connection if the required flag is set.

Change log

Subscribe to the OSM Nominatim plugin change log to stay in sync with any updates.

More plugin types

Find a comprehensive list of available plugins types here.


See also
Using plugins to resolve the coordinates of GSM base stations and Wi-Fi networks into position coordinates using Unwired Labs API.