Open Reviews Association

From OpenStreetMap Wiki
Jump to navigation Jump to search

The Open Reviews Association aims to build a free and open-source, decentralized platform to host free-licensed[1] reviews. Reviews can be about geographical features (shops, ...) or non-geo things, like books. The standard can potentially link the OSM metadata, as described below.

The association produces a standard that defines a "review", and one demo app that implements the standard. Both are named Mangrove Reviews at the moment (January 2024). In the future, the name will only belong to the demo client application.[2]

Mangrove Review Standard

Mangrove Review Standard
Author: open-reviews
Website: https://mangrove.reviews/standard
Source code: open-reviews/mangrove GitHub

Defines a "review" based on open standards.

Relationship with OSM

OSM identifiers are not persistent, so the identifier for a review is a Geo URI.

It is possible to include the OSM identifier in the metadata field of a review, and it is possible to add this to the relevant section of the standard.




Mangrove Reviews

Mangrove Reviews
Author: open-reviews
Website: https://mangrove.reviews/
Source code: open-reviews/mangrove GitHub

a demo client application for an open reviews server

Mangrove Reviews is the name of a demo client application, and the name of a server application, that implement the Mangrove Reviews Standard. The README from the repo describes how to self-host the components.

Data status

Most restaurants do not have a review yet.

A plot of the monthly added reviews as of March 2024[3] shows 25 - 75 reviews depending on the month.

To list the restaurants that do not have a review, you can use MapComplete, as described below.

To list the restaurants that have reviews, use this URL and change the limit=20 if you want to see more reviews.

There is an API endpoint to query for reviews given the coordinates. The doc is here. At the moment (March 2024), this API is not frozen and some details are subject to change based on user feedback (for example, it has not yet been decided whether the client should supply the coordinates or the bounding box in the query).

Ecosystem

The known clients are listed here.

Known OSM-related clients are MapComplete and OpenCampingMap.

Funding for third-party app plugin development

The association wants to fund the development of a plugin to integrate Mangrove Reviews into geographical apps, for example OsmAnd & Organic Maps.

MapComplete

Open the food category (click here). Choose a restaurant. You can rate it in the panel at the right. This rating is saved into Mangrove Reviews.

Not yet implemented

  • OsmAnd: potential integration is being discussed here.
  • Organic Maps: potential integration is being discussed here.

Notes

  1. https://mangrove.reviews/terms#8-licensing-of-content
  2. [1]
  3. Plot image, posted here in chat. This is the permanent link, viewable via Matrix.

External links