Difference between revisions of "Global stores taxonomy"

From Open Food Facts wiki
Jump to navigation Jump to search
(adapted)
Line 17: Line 17:
  
 
== Open Street Map integration ==
 
== Open Street Map integration ==
Several of the fields are pulled from Open Street Map (name, postcode, city, country, lat, lon). These need to be regularly updated, so that OSM is followed. Any deleted location should be kept.
+
All locations are linked to [https://www.openstreetmap.org/ Open Street Map] (OSM) through the unique OSM id. The link refers to a basic object in SOM:
 +
* Node - is used to refer to a single location, like [https://www.openstreetmap.org/node/25213337 BP Service];
 +
* Way - is used to refer to a building, like [https://www.openstreetmap.org/way/31348922 IKEA];
 +
* Relation - is used to refer multiple ways used by the shop, like [https://www.openstreetmap.org/relation/1235874 Carrefour];
 +
 
 +
Using a Way to designate a shopping location might lead to inconsistencies, like [https://www.openstreetmap.org/way/4447066 this] actual location. Which shop on the street is meant?
 +
Using a relation might lead to inconsistencies as well, like [https://www.openstreetmap.org/relation/7868535 this] actual location;
 +
 
 +
Several of the fields are pulled from OSM (name, postcode, city, country, lat, lon). These need to be regularly updated, so that OSM is followed. Any deleted location should be kept.
  
 
== Maintenance ==
 
== Maintenance ==

Revision as of 09:25, 29 February 2024

See Global taxonomies for instructions.

Introduction

The stores taxonomy contains a list of locations where products (food products, beauty products, etc.) can be obtained.

Store entries

An entry in the taxonomy describes a single location. The fields used follow the data structure used by OFF Prices and describes a single location:

  • id - a unique identifier (as defined by OFF Prices)
  • osm_id - the corresponding node(only?) in OpenStreetMap
  • name - a long name
  • postcode - the postcode
  • city - the city
  • country - the country tag
  • lat - the latitude
  • lon - the longitude

Open Street Map integration

All locations are linked to Open Street Map (OSM) through the unique OSM id. The link refers to a basic object in SOM:

  • Node - is used to refer to a single location, like BP Service;
  • Way - is used to refer to a building, like IKEA;
  • Relation - is used to refer multiple ways used by the shop, like Carrefour;

Using a Way to designate a shopping location might lead to inconsistencies, like this actual location. Which shop on the street is meant? Using a relation might lead to inconsistencies as well, like this actual location;

Several of the fields are pulled from OSM (name, postcode, city, country, lat, lon). These need to be regularly updated, so that OSM is followed. Any deleted location should be kept.

Maintenance

The stores taxonomy needs to be regularly updated from the data entered through OFF Prices. This means any changed values and any added entries/


Note

  • We need to associate stores with brands that are sold in thoses stores (Auchan for Auchan…)
  • We should try to add Wikidata relations (and thus OSM ones) whenever possible


Moved to GitHub: https://github.com/openfoodfacts/openfoodfacts-server/blob/master/taxonomies/stores.txt