https://wiki.openfoodfacts.org/api.php?action=feedcontributions&user=Aleene&feedformat=atomOpen Food Facts wiki - User contributions [en]2024-03-28T14:34:48ZUser contributionsMediaWiki 1.35.2https://wiki.openfoodfacts.org/index.php?title=Progressboard&diff=20688Progressboard2024-03-15T15:58:52Z<p>Aleene: Aleene moved page Progressboard to ProgressBoard/Explanation: beter</p>
<hr />
<div>#REDIRECT [[ProgressBoard/Explanation]]</div>Aleenehttps://wiki.openfoodfacts.org/index.php?title=ProgressBoard/Explanation&diff=20687ProgressBoard/Explanation2024-03-15T15:58:52Z<p>Aleene: Aleene moved page Progressboard to ProgressBoard/Explanation: beter</p>
<hr />
<div>Improving quality and completeness is a slow process, it involves a lot of product edits. A [[Dashboard/Explanation|Dashboard]] does not change much each month. Updating these monthly is not very useful.<br />
<br />
In every country however many products are added and improved. In order to demonstrate this work a (monthly) Progress Board is available. The Progress Board shows by how much the situation for a country has changed: products that have been added, product evaluation increase (Nutriscore, NOVA), quality that has been improved and products that have been completed. This is shown in 3 graphs.<br />
<br />
== Coping with growth ==<br />
[[File:ImprovementGraphNetherlands.png|100px|thumb|right|Improvement Netherlands March 2024]]<br />
Products are added all the time. And the more products there are, the more work it will be to check and repair products. And this is necessary to be able to enhance products with Nutriscore an NOVA for instance. The main question is whether OFF and its editors can keep up with growth. Some months may be easier than others.<br />
This is all shown in the Improvement graph. An example for the Netherlands is shown here.<br />
The graph shows the situation for the Netherlands in the last year for multiple months. It shows the growth percentage of products sold in the Netherlands in blue, the growth in products with a Nutriscore in green and the growth of products with NOVA in grey. In most cases the Nutriscore and Nova bars are larger than blue growth bars. This implies that the product completeness can keep up with the growth.<br />
The yellow bars show the increase in detected quality. Clearly these must be positive, although OFF is not always able to repair each product due to producer errors.<br />
<br />
== Repairable products ==<br />
[[File:CompletionNetherlands.png|100px|thumb|right|Completion Effort graph Netherlands]]<br />
OFF strives to have a database with complete and correct products. Complete means that it is able to calculate Nutriscore and NOVA. And correct means that there are no errors in transcribing ingredients and nutritional values form the packaging. OFF shows what is provided by the producer.<br />
This can only be achieved if there are product images available. These product images can be looked at and transcribed into the OFF database. Sometimes the images are available, but the transcription has not been done yet: the reparable products.<br />
The graph shows the number of products that have this issue has decreased, i.e. with completed ingredients, nutritional values, categories or data quality. If the number is negative more products have been added than could be completed.<br />
The graph shows the repair effort for the Netherlands for three different months. In blue the completion of ingredients, in green the completion of Nutritional Values, in grey the completion of category assignment and in yellow the improved data quality.<br />
<br />
== Top products ==<br />
[[File:TopProductsCompleted.png|100 px|thumb|right|Completed Top Products March 2024 Italy]]<br />
Each year a list is made of the top scanned products per country. The latest list dates from 2023. The top scanned products are divided into 5 tiers: 1.000, 5.000, 10.000, 50.000 and 100.000 scans.<br />
These most scanned products should be completed first, as this will give the users a better experience. Unfortunately not all products are easily completed as often images are not available. However those that have images can be checked and completed. <br />
The graph shows how many of these products have been completed. The example graph here shows that some 200 products of the top products in Italy have been completed. The different colours show the five top tiers.</div>Aleenehttps://wiki.openfoodfacts.org/index.php?title=ProgressBoard/Explanation&diff=20686ProgressBoard/Explanation2024-03-15T15:57:36Z<p>Aleene: /* Repairable products */</p>
<hr />
<div>Improving quality and completeness is a slow process, it involves a lot of product edits. A [[Dashboard/Explanation|Dashboard]] does not change much each month. Updating these monthly is not very useful.<br />
<br />
In every country however many products are added and improved. In order to demonstrate this work a (monthly) Progress Board is available. The Progress Board shows by how much the situation for a country has changed: products that have been added, product evaluation increase (Nutriscore, NOVA), quality that has been improved and products that have been completed. This is shown in 3 graphs.<br />
<br />
== Coping with growth ==<br />
[[File:ImprovementGraphNetherlands.png|100px|thumb|right|Improvement Netherlands March 2024]]<br />
Products are added all the time. And the more products there are, the more work it will be to check and repair products. And this is necessary to be able to enhance products with Nutriscore an NOVA for instance. The main question is whether OFF and its editors can keep up with growth. Some months may be easier than others.<br />
This is all shown in the Improvement graph. An example for the Netherlands is shown here.<br />
The graph shows the situation for the Netherlands in the last year for multiple months. It shows the growth percentage of products sold in the Netherlands in blue, the growth in products with a Nutriscore in green and the growth of products with NOVA in grey. In most cases the Nutriscore and Nova bars are larger than blue growth bars. This implies that the product completeness can keep up with the growth.<br />
The yellow bars show the increase in detected quality. Clearly these must be positive, although OFF is not always able to repair each product due to producer errors.<br />
<br />
== Repairable products ==<br />
[[File:CompletionNetherlands.png|100px|thumb|right|Completion Effort graph Netherlands]]<br />
OFF strives to have a database with complete and correct products. Complete means that it is able to calculate Nutriscore and NOVA. And correct means that there are no errors in transcribing ingredients and nutritional values form the packaging. OFF shows what is provided by the producer.<br />
This can only be achieved if there are product images available. These product images can be looked at and transcribed into the OFF database. Sometimes the images are available, but the transcription has not been done yet: the reparable products.<br />
The graph shows the number of products that have this issue has decreased, i.e. with completed ingredients, nutritional values, categories or data quality. If the number is negative more products have been added than could be completed.<br />
The graph shows the repair effort for the Netherlands for three different months. In blue the completion of ingredients, in green the completion of Nutritional Values, in grey the completion of category assignment and in yellow the improved data quality.<br />
<br />
== Top products ==<br />
[[File:TopProductsCompleted.png|100 px|thumb|right|Completed Top Products March 2024 Italy]]<br />
Each year a list is made of the top scanned products per country. The latest list dates from 2023. The top scanned products are divided into 5 tiers: 1.000, 5.000, 10.000, 50.000 and 100.000 scans.<br />
These most scanned products should be completed first, as this will give the users a better experience. Unfortunately not all products are easily completed as often images are not available. However those that have images can be checked and completed. <br />
The graph shows how many of these products have been completed. The example graph here shows that some 200 products of the top products in Italy have been completed. The different colours show the five top tiers.</div>Aleenehttps://wiki.openfoodfacts.org/index.php?title=File:CompletionNetherlands.png&diff=20685File:CompletionNetherlands.png2024-03-15T15:55:02Z<p>Aleene: </p>
<hr />
<div>Completion Effort graph Netherlands</div>Aleenehttps://wiki.openfoodfacts.org/index.php?title=ProgressBoard/Explanation&diff=20684ProgressBoard/Explanation2024-03-15T15:40:30Z<p>Aleene: /* Coping with growth */</p>
<hr />
<div>Improving quality and completeness is a slow process, it involves a lot of product edits. A [[Dashboard/Explanation|Dashboard]] does not change much each month. Updating these monthly is not very useful.<br />
<br />
In every country however many products are added and improved. In order to demonstrate this work a (monthly) Progress Board is available. The Progress Board shows by how much the situation for a country has changed: products that have been added, product evaluation increase (Nutriscore, NOVA), quality that has been improved and products that have been completed. This is shown in 3 graphs.<br />
<br />
== Coping with growth ==<br />
[[File:ImprovementGraphNetherlands.png|100px|thumb|right|Improvement Netherlands March 2024]]<br />
Products are added all the time. And the more products there are, the more work it will be to check and repair products. And this is necessary to be able to enhance products with Nutriscore an NOVA for instance. The main question is whether OFF and its editors can keep up with growth. Some months may be easier than others.<br />
This is all shown in the Improvement graph. An example for the Netherlands is shown here.<br />
The graph shows the situation for the Netherlands in the last year for multiple months. It shows the growth percentage of products sold in the Netherlands in blue, the growth in products with a Nutriscore in green and the growth of products with NOVA in grey. In most cases the Nutriscore and Nova bars are larger than blue growth bars. This implies that the product completeness can keep up with the growth.<br />
The yellow bars show the increase in detected quality. Clearly these must be positive, although OFF is not always able to repair each product due to producer errors.<br />
<br />
== Repairable products ==<br />
<br />
== Top products ==<br />
[[File:TopProductsCompleted.png|100 px|thumb|right|Completed Top Products March 2024 Italy]]<br />
Each year a list is made of the top scanned products per country. The latest list dates from 2023. The top scanned products are divided into 5 tiers: 1.000, 5.000, 10.000, 50.000 and 100.000 scans.<br />
These most scanned products should be completed first, as this will give the users a better experience. Unfortunately not all products are easily completed as often images are not available. However those that have images can be checked and completed. <br />
The graph shows how many of these products have been completed. The example graph here shows that some 200 products of the top products in Italy have been completed. The different colours show the five top tiers.</div>Aleenehttps://wiki.openfoodfacts.org/index.php?title=ProgressBoard/Explanation&diff=20683ProgressBoard/Explanation2024-03-15T15:40:14Z<p>Aleene: /* Coping with growth */</p>
<hr />
<div>Improving quality and completeness is a slow process, it involves a lot of product edits. A [[Dashboard/Explanation|Dashboard]] does not change much each month. Updating these monthly is not very useful.<br />
<br />
In every country however many products are added and improved. In order to demonstrate this work a (monthly) Progress Board is available. The Progress Board shows by how much the situation for a country has changed: products that have been added, product evaluation increase (Nutriscore, NOVA), quality that has been improved and products that have been completed. This is shown in 3 graphs.<br />
<br />
== Coping with growth ==<br />
[[File:ImprovementGraphNetherlands.png|100px|thumb|right|Improvement Netherlands March 2024]]<br />
Products are added all the time. And the more products there are, the more work it will be to check and repair products. And this is necessary to be able to enhance products with Nutriscore an NOVA for instance. The main question is whether OFF and its editors can keep up with growth. Some months may be easier than others.<br />
This is all shown in the Improvement graph. An example for the Netherlands is shown here.<br />
The graph shows the situation for the Netherlands in the last year for multiple months. It shows the growth percentage of products sold in the Netherlands in blue, the growth in products with a Nutriscore in green and the growth of products with NOVA in grey. In most cases the Nutriscore and Nova bars are larger than blue growth bars. This implies that the product completeness can keep up with the growth.<br />
The yellow bars show the increase in detected quality. Clearly these must be positive, although OFF is not always able to repair each product.<br />
<br />
== Repairable products ==<br />
<br />
== Top products ==<br />
[[File:TopProductsCompleted.png|100 px|thumb|right|Completed Top Products March 2024 Italy]]<br />
Each year a list is made of the top scanned products per country. The latest list dates from 2023. The top scanned products are divided into 5 tiers: 1.000, 5.000, 10.000, 50.000 and 100.000 scans.<br />
These most scanned products should be completed first, as this will give the users a better experience. Unfortunately not all products are easily completed as often images are not available. However those that have images can be checked and completed. <br />
The graph shows how many of these products have been completed. The example graph here shows that some 200 products of the top products in Italy have been completed. The different colours show the five top tiers.</div>Aleenehttps://wiki.openfoodfacts.org/index.php?title=File:ImprovementGraphNetherlands.png&diff=20682File:ImprovementGraphNetherlands.png2024-03-15T15:34:01Z<p>Aleene: </p>
<hr />
<div>Improvement Netherlands March 2024</div>Aleenehttps://wiki.openfoodfacts.org/index.php?title=ProgressBoard/Explanation&diff=20681ProgressBoard/Explanation2024-03-15T15:25:20Z<p>Aleene: /* Top products */</p>
<hr />
<div>Improving quality and completeness is a slow process, it involves a lot of product edits. A [[Dashboard/Explanation|Dashboard]] does not change much each month. Updating these monthly is not very useful.<br />
<br />
In every country however many products are added and improved. In order to demonstrate this work a (monthly) Progress Board is available. The Progress Board shows by how much the situation for a country has changed: products that have been added, product evaluation increase (Nutriscore, NOVA), quality that has been improved and products that have been completed. This is shown in 3 graphs.<br />
<br />
== Coping with growth ==<br />
<br />
== Repairable products ==<br />
<br />
== Top products ==<br />
[[File:TopProductsCompleted.png|100 px|thumb|right|Completed Top Products March 2024 Italy]]<br />
Each year a list is made of the top scanned products per country. The latest list dates from 2023. The top scanned products are divided into 5 tiers: 1.000, 5.000, 10.000, 50.000 and 100.000 scans.<br />
These most scanned products should be completed first, as this will give the users a better experience. Unfortunately not all products are easily completed as often images are not available. However those that have images can be checked and completed. <br />
The graph shows how many of these products have been completed. The example graph here shows that some 200 products of the top products in Italy have been completed. The different colours show the five top tiers.</div>Aleenehttps://wiki.openfoodfacts.org/index.php?title=File:TopProductsCompleted.png&diff=20680File:TopProductsCompleted.png2024-03-15T15:23:40Z<p>Aleene: </p>
<hr />
<div>Completed Top Products March 2024 Italy</div>Aleenehttps://wiki.openfoodfacts.org/index.php?title=ProgressBoard/Explanation&diff=20679ProgressBoard/Explanation2024-03-15T15:20:18Z<p>Aleene: Created page with "Improving quality and completeness is a slow process, it involves a lot of product edits. A Dashboard does not change much each month. Updating these..."</p>
<hr />
<div>Improving quality and completeness is a slow process, it involves a lot of product edits. A [[Dashboard/Explanation|Dashboard]] does not change much each month. Updating these monthly is not very useful.<br />
<br />
In every country however many products are added and improved. In order to demonstrate this work a (monthly) Progress Board is available. The Progress Board shows by how much the situation for a country has changed: products that have been added, product evaluation increase (Nutriscore, NOVA), quality that has been improved and products that have been completed. This is shown in 3 graphs.<br />
<br />
== Coping with growth ==<br />
<br />
== Repairable products ==<br />
<br />
== Top products ==<br />
Each year a list is made of the top scanned products per country. The latest list dates from 2023. The top scanned products are divided into 5 groups: 1.000, 5.000, 10.000, 50.000 and 100.000 scans.<br />
These most scanned products should be completed first, as this will give the users a better experience. Unfortunately not all products are easily completed as often images are not available. However those that have images can be checked and completed. <br />
The graph shows how many of these products have been completed.</div>Aleenehttps://wiki.openfoodfacts.org/index.php?title=Global_stores_taxonomy&diff=20671Global stores taxonomy2024-03-07T15:41:52Z<p>Aleene: /* Spinoff */</p>
<hr />
<div>See [[Global taxonomies]] for instructions.<br />
[[Category:Global_Taxonomies]]<br />
== Introduction ==<br />
The stores taxonomy contains a list of locations where products (food products, beauty products, etc.) can be obtained. A related store brands taxonomy describes the brand names (store chains) of the individual stores.<br />
<br />
Most of the data related to these taxonomies is obtained through third parties (Wikidata, OpenStreetMap). The main interest of OFF is the relation between products, stores and brands.<br />
<br />
== Store entries ==<br />
An entry in the taxonomy describes a single location. This taxonomy can combine data pulled from various sources: receipts from prices, osm, wikidata, etc or provided by the user (honour system). OFF should be careful not copy to much data already maintained by other parties. And if data is copied, it is to provide a snapshot in time.<br />
=== Receipts ===<br />
[[File:Example receipt heading.png|100 px|thumb|right|Example receipt heading]]<br />
The basis could be the receipts that users have added on prices. As all OFF data, any information should be backed up by image proofs. In the case for a store, this could be a receipt. The store information available on the receipt can be extracted to the taxonomy. What can be extracted depends on the receipt. In the example shown here, it is possible to extract the store name, the operator (useful for franchises), the address, phone number, siret, naf and tva. Analysus of more receipts might reveal other country specific information.<br />
Hopefully this information is enough to unambiguously identify a store.<br />
<br />
=== Prices ===<br />
The stores taxonomy can be based on [https://prices.openfoodfacts.org/ OFF Prices]. The receipts corresponding to a shop are entered on Prices. Prices has a unique identifier for each shop, which should be used as a linking pin. In addition Prices offers a link with Openstreetmap, which can be used to pull in additional information. Some of this information is already cached by Prices.<br />
=== Open Street Map ===<br />
All stores are linked to [https://www.openstreetmap.org/ Open Street Map] (OSM) through the unique OSM id. The link refers to a basic object in OSM:<br />
* Node - is used to refer to a single location, like [https://www.openstreetmap.org/node/25213337 BP Service];<br />
* (Closed) Way - is used to refer to a building, like [https://www.openstreetmap.org/way/31348922 IKEA];<br />
* Relation - is used to refer multiple ways used by the shop, like [https://www.openstreetmap.org/relation/1235874 Carrefour];<br />
<br />
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. This can be limited to OSM objects that have the tag ''shop''.<br />
<br />
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.<br />
<br />
=== Example Taxonomy Entry===<br />
An example for an entry / location / store / shop in the taxonomy:<br><br />
<nowiki>store_brand:en: en:Biocoop</nowiki><br><br />
<nowiki>price_id:en: 45</nowiki><br><br />
<nowiki>osm_id:en: 9815975601</nowiki><br><br />
<nowiki>osm_type:en: NODE</nowiki><br><br />
<nowiki>osm_display_name:en: en:"Biocoop, Rue de Tolbiac, Quartier de la Maison-Blanche, Paris 13e Arrondissement, Paris, Île-de-France, France métropolitaine, 75013, France"</nowiki><br><br />
<nowiki>osm_address_postcode:en: 75013</nowiki><br><br />
<nowiki>osm_address_city:en: en:Paris</nowiki><br><br />
<nowiki>osm_address_country:en: en:france</nowiki><br><br />
<nowiki>osm_lat:en: 48.8259597</nowiki><br><br />
<nowiki>osm_lon:en: 2.3511541</nowiki><br><br />
== Store brand entries ==<br />
The current implementation of OFF already supports a field for Stores. It is a free text field where the user can enter whatever s/he wants. A variety of entries is the consequence. But most of all it is used to enter the value for the Store brand, i.e. the name of the store as is shown outside the store and on receipts.<br />
=== Fields ===<br />
* store-brand - the name of the store as found on receipts<br />
* wikidata - the entry on wikidata that contains more information on the supermarket chain.<br />
* countries - a list of countries where the chain currently operates (has stores). This information can be pulled from wikidata.<br />
* expiration-date-country - some kind of date when store no longer has any stores in a specific country. For instance user chain [https://www.wikidata.org/wiki/Q925132 Dia] used to be active in France and OFF still has products for this.<br />
=== Comments ===<br />
Note that this can also be imported from OSM by means of the receipts. On OSM it is indicated with the tag ''brand''.<br />
<br />
OSM also indicates a link to wikidata (for instance [https://www.wikidata.org/wiki/Q151954 Lidl]).<br />
<br />
<br />
=== Example Taxonomy Entry ===<br />
<nowiki>en:store-brand: en:Biocoop</nowiki><br />
<br><br />
<nowiki>countries:en: en:france</nowiki><br />
<br><br />
<nowiki>wikidata:en: Q2904039</nowiki><br />
<br />
== Lifecycle ==<br />
The lifecycle for the two taxonomies is related, so they will be discussed together.<br />
=== Kickstart ===<br />
The kickstart describes the initial, very first introduction of the taxonomies.<br />
==== Store brands ====<br />
The store brands taxonomy could be started with the current entries in the Stores field. Unfortunately the quality of these current entries seems rather low. It is preferred to start with a high quality list pulled in from external sources, like all [https://www.wikidata.org/wiki/Q18043413 supermarket] chains listed on Wikidata.<br />
<br />
As a subsequent step all existing entries could be mapped to this store brands taxonomy.<br />
<br />
==== Stores ====<br />
The stores taxonomy can initially be pulled from OFF Prices. The data only needs to be formatted in the correct way. The stores information provided by OFF Prices will then be used as a starting point.<br />
<br />
=== Maintenance ===<br />
==== Editing ====<br />
Editing involves changing existing items in the taxonomies.<br />
==== Extending ====<br />
Extending involves adding new items to the taxonomies through all possible applications.<br />
* Stores Taxonomy<br />
** OFF Prices - new stores can be found through new location_id and can be double checked against OSM id;<br />
** Productopener - use OSM id to check whether something is new;<br />
** API - use OSM id to check whether something is new;<br />
* Store Brands Taxonomy<br />
** OFF Prices - new store brands via OSM and wikidata;<br />
** Productopener - new store brands via OSM and wikidata;<br />
** API - new store brands via OSM and wikidata;<br />
<br />
== Spinoff ==<br />
Information on stores, operators and owners is not the main goal of OFF. OFF prefers that this is maintained by more specialised other parties. However OFF does gather some information through receipts for instance (full address, phone number, opening hours, operator, siret, tva, naf). Users are encouraged to add this kind of information to OpenStreetMap or wikidata.<br />
<br />
== Use cases ==<br />
* OFF Prices - To have the prices of products for individual stores and brands.<br />
* https://github.com/danslimmon/oscar Throw out a package, add to shopping list, potentially you can do an online order/click and collect (because the store * is known, and has wikidata, and a url)<br />
* Walk into an area with a geofence - https://github.com/alltheplaces/alltheplaces / open streetmap - have home assistant push a notification to get the three items from that Wikidata:brand store that are on your list<br />
* I need (uncommon ingredient or food); from the places it is sold which is closest to me?<br />
*I scanned an item. I'm standing inside an OSM shop/supermarket at (geofence). It has a Wikidata:brand. Would I like to add this as the store that sells this food?<br />
* Provides a way via name suggestion index to get a clear logo for a given brand of it is a store brand with more data captured in open food facts, Provides some insight into supply chains<br />
<br />
== Discussion points ==<br />
<br />
* What information should be stored by OFF and what can be left to OSM or Wikidata? <br />
* What to be done with shops that go out of business?<br />
<br />
== Note ==<br />
* We need to associate stores with brands that are sold in thoses stores (Auchan for Auchan…)<br />
* We should try to add Wikidata relations (and thus OSM ones) whenever possible<br />
* Chains - if a store is part of a chain with multiple stores it can be added through a wikidata link<br />
<br />
Moved to GitHub: https://github.com/openfoodfacts/openfoodfacts-server/blob/master/taxonomies/stores.txt</div>Aleenehttps://wiki.openfoodfacts.org/index.php?title=Global_stores_taxonomy&diff=20669Global stores taxonomy2024-03-07T15:13:09Z<p>Aleene: /* Extending */</p>
<hr />
<div>See [[Global taxonomies]] for instructions.<br />
[[Category:Global_Taxonomies]]<br />
== Introduction ==<br />
The stores taxonomy contains a list of locations where products (food products, beauty products, etc.) can be obtained. A related store brands taxonomy describes the brand names (store chains) of the individual stores.<br />
<br />
Most of the data related to these taxonomies is obtained through third parties (Wikidata, OpenStreetMap). The main interest of OFF is the relation between products, stores and brands.<br />
<br />
== Store entries ==<br />
An entry in the taxonomy describes a single location. This taxonomy can combine data pulled from various sources: receipts from prices, osm, wikidata, etc or provided by the user (honour system). OFF should be careful not copy to much data already maintained by other parties. And if data is copied, it is to provide a snapshot in time.<br />
=== Receipts ===<br />
[[File:Example receipt heading.png|100 px|thumb|right|Example receipt heading]]<br />
The basis could be the receipts that users have added on prices. As all OFF data, any information should be backed up by image proofs. In the case for a store, this could be a receipt. The store information available on the receipt can be extracted to the taxonomy. What can be extracted depends on the receipt. In the example shown here, it is possible to extract the store name, the operator (useful for franchises), the address, phone number, siret, naf and tva. Analysus of more receipts might reveal other country specific information.<br />
Hopefully this information is enough to unambiguously identify a store.<br />
<br />
=== Prices ===<br />
The stores taxonomy can be based on [https://prices.openfoodfacts.org/ OFF Prices]. The receipts corresponding to a shop are entered on Prices. Prices has a unique identifier for each shop, which should be used as a linking pin. In addition Prices offers a link with Openstreetmap, which can be used to pull in additional information. Some of this information is already cached by Prices.<br />
=== Open Street Map ===<br />
All stores are linked to [https://www.openstreetmap.org/ Open Street Map] (OSM) through the unique OSM id. The link refers to a basic object in OSM:<br />
* Node - is used to refer to a single location, like [https://www.openstreetmap.org/node/25213337 BP Service];<br />
* (Closed) Way - is used to refer to a building, like [https://www.openstreetmap.org/way/31348922 IKEA];<br />
* Relation - is used to refer multiple ways used by the shop, like [https://www.openstreetmap.org/relation/1235874 Carrefour];<br />
<br />
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. This can be limited to OSM objects that have the tag ''shop''.<br />
<br />
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.<br />
<br />
=== Example Taxonomy Entry===<br />
An example for an entry / location / store / shop in the taxonomy:<br><br />
<nowiki>store_brand:en: en:Biocoop</nowiki><br><br />
<nowiki>price_id:en: 45</nowiki><br><br />
<nowiki>osm_id:en: 9815975601</nowiki><br><br />
<nowiki>osm_type:en: NODE</nowiki><br><br />
<nowiki>osm_display_name:en: en:"Biocoop, Rue de Tolbiac, Quartier de la Maison-Blanche, Paris 13e Arrondissement, Paris, Île-de-France, France métropolitaine, 75013, France"</nowiki><br><br />
<nowiki>osm_address_postcode:en: 75013</nowiki><br><br />
<nowiki>osm_address_city:en: en:Paris</nowiki><br><br />
<nowiki>osm_address_country:en: en:france</nowiki><br><br />
<nowiki>osm_lat:en: 48.8259597</nowiki><br><br />
<nowiki>osm_lon:en: 2.3511541</nowiki><br><br />
== Store brand entries ==<br />
The current implementation of OFF already supports a field for Stores. It is a free text field where the user can enter whatever s/he wants. A variety of entries is the consequence. But most of all it is used to enter the value for the Store brand, i.e. the name of the store as is shown outside the store and on receipts.<br />
=== Fields ===<br />
* store-brand - the name of the store as found on receipts<br />
* wikidata - the entry on wikidata that contains more information on the supermarket chain.<br />
* countries - a list of countries where the chain currently operates (has stores). This information can be pulled from wikidata.<br />
* expiration-date-country - some kind of date when store no longer has any stores in a specific country. For instance user chain [https://www.wikidata.org/wiki/Q925132 Dia] used to be active in France and OFF still has products for this.<br />
=== Comments ===<br />
Note that this can also be imported from OSM by means of the receipts. On OSM it is indicated with the tag ''brand''.<br />
<br />
OSM also indicates a link to wikidata (for instance [https://www.wikidata.org/wiki/Q151954 Lidl]).<br />
<br />
<br />
=== Example Taxonomy Entry ===<br />
<nowiki>en:store-brand: en:Biocoop</nowiki><br />
<br><br />
<nowiki>countries:en: en:france</nowiki><br />
<br><br />
<nowiki>wikidata:en: Q2904039</nowiki><br />
<br />
== Lifecycle ==<br />
The lifecycle for the two taxonomies is related, so they will be discussed together.<br />
=== Kickstart ===<br />
The kickstart describes the initial, very first introduction of the taxonomies.<br />
==== Store brands ====<br />
The store brands taxonomy could be started with the current entries in the Stores field. Unfortunately the quality of these current entries seems rather low. It is preferred to start with a high quality list pulled in from external sources, like all [https://www.wikidata.org/wiki/Q18043413 supermarket] chains listed on Wikidata.<br />
<br />
As a subsequent step all existing entries could be mapped to this store brands taxonomy.<br />
<br />
==== Stores ====<br />
The stores taxonomy can initially be pulled from OFF Prices. The data only needs to be formatted in the correct way. The stores information provided by OFF Prices will then be used as a starting point.<br />
<br />
=== Maintenance ===<br />
==== Editing ====<br />
Editing involves changing existing items in the taxonomies.<br />
==== Extending ====<br />
Extending involves adding new items to the taxonomies through all possible applications.<br />
* Stores Taxonomy<br />
** OFF Prices - new stores can be found through new location_id and can be double checked against OSM id;<br />
** Productopener - use OSM id to check whether something is new;<br />
** API - use OSM id to check whether something is new;<br />
* Store Brands Taxonomy<br />
** OFF Prices - new store brands via OSM and wikidata;<br />
** Productopener - new store brands via OSM and wikidata;<br />
** API - new store brands via OSM and wikidata;<br />
<br />
== Spinoff ==<br />
Information on stores, operators and owners is not the main goal of OFF. OFF prefers that this is maintained by more specialised other parties. However OFF does gather this information through receipts for instance. Users are encouraged to add this kind of information to OpenStreetMap or wikidata.<br />
<br />
== Use cases ==<br />
* OFF Prices - To have the prices of products for individual stores and brands.<br />
* https://github.com/danslimmon/oscar Throw out a package, add to shopping list, potentially you can do an online order/click and collect (because the store * is known, and has wikidata, and a url)<br />
* Walk into an area with a geofence - https://github.com/alltheplaces/alltheplaces / open streetmap - have home assistant push a notification to get the three items from that Wikidata:brand store that are on your list<br />
* I need (uncommon ingredient or food); from the places it is sold which is closest to me?<br />
*I scanned an item. I'm standing inside an OSM shop/supermarket at (geofence). It has a Wikidata:brand. Would I like to add this as the store that sells this food?<br />
* Provides a way via name suggestion index to get a clear logo for a given brand of it is a store brand with more data captured in open food facts, Provides some insight into supply chains<br />
<br />
== Discussion points ==<br />
<br />
* What information should be stored by OFF and what can be left to OSM or Wikidata? <br />
* What to be done with shops that go out of business?<br />
<br />
== Note ==<br />
* We need to associate stores with brands that are sold in thoses stores (Auchan for Auchan…)<br />
* We should try to add Wikidata relations (and thus OSM ones) whenever possible<br />
* Chains - if a store is part of a chain with multiple stores it can be added through a wikidata link<br />
<br />
Moved to GitHub: https://github.com/openfoodfacts/openfoodfacts-server/blob/master/taxonomies/stores.txt</div>Aleenehttps://wiki.openfoodfacts.org/index.php?title=Global_stores_taxonomy&diff=20668Global stores taxonomy2024-03-07T15:12:36Z<p>Aleene: /* Extending */</p>
<hr />
<div>See [[Global taxonomies]] for instructions.<br />
[[Category:Global_Taxonomies]]<br />
== Introduction ==<br />
The stores taxonomy contains a list of locations where products (food products, beauty products, etc.) can be obtained. A related store brands taxonomy describes the brand names (store chains) of the individual stores.<br />
<br />
Most of the data related to these taxonomies is obtained through third parties (Wikidata, OpenStreetMap). The main interest of OFF is the relation between products, stores and brands.<br />
<br />
== Store entries ==<br />
An entry in the taxonomy describes a single location. This taxonomy can combine data pulled from various sources: receipts from prices, osm, wikidata, etc or provided by the user (honour system). OFF should be careful not copy to much data already maintained by other parties. And if data is copied, it is to provide a snapshot in time.<br />
=== Receipts ===<br />
[[File:Example receipt heading.png|100 px|thumb|right|Example receipt heading]]<br />
The basis could be the receipts that users have added on prices. As all OFF data, any information should be backed up by image proofs. In the case for a store, this could be a receipt. The store information available on the receipt can be extracted to the taxonomy. What can be extracted depends on the receipt. In the example shown here, it is possible to extract the store name, the operator (useful for franchises), the address, phone number, siret, naf and tva. Analysus of more receipts might reveal other country specific information.<br />
Hopefully this information is enough to unambiguously identify a store.<br />
<br />
=== Prices ===<br />
The stores taxonomy can be based on [https://prices.openfoodfacts.org/ OFF Prices]. The receipts corresponding to a shop are entered on Prices. Prices has a unique identifier for each shop, which should be used as a linking pin. In addition Prices offers a link with Openstreetmap, which can be used to pull in additional information. Some of this information is already cached by Prices.<br />
=== Open Street Map ===<br />
All stores are linked to [https://www.openstreetmap.org/ Open Street Map] (OSM) through the unique OSM id. The link refers to a basic object in OSM:<br />
* Node - is used to refer to a single location, like [https://www.openstreetmap.org/node/25213337 BP Service];<br />
* (Closed) Way - is used to refer to a building, like [https://www.openstreetmap.org/way/31348922 IKEA];<br />
* Relation - is used to refer multiple ways used by the shop, like [https://www.openstreetmap.org/relation/1235874 Carrefour];<br />
<br />
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. This can be limited to OSM objects that have the tag ''shop''.<br />
<br />
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.<br />
<br />
=== Example Taxonomy Entry===<br />
An example for an entry / location / store / shop in the taxonomy:<br><br />
<nowiki>store_brand:en: en:Biocoop</nowiki><br><br />
<nowiki>price_id:en: 45</nowiki><br><br />
<nowiki>osm_id:en: 9815975601</nowiki><br><br />
<nowiki>osm_type:en: NODE</nowiki><br><br />
<nowiki>osm_display_name:en: en:"Biocoop, Rue de Tolbiac, Quartier de la Maison-Blanche, Paris 13e Arrondissement, Paris, Île-de-France, France métropolitaine, 75013, France"</nowiki><br><br />
<nowiki>osm_address_postcode:en: 75013</nowiki><br><br />
<nowiki>osm_address_city:en: en:Paris</nowiki><br><br />
<nowiki>osm_address_country:en: en:france</nowiki><br><br />
<nowiki>osm_lat:en: 48.8259597</nowiki><br><br />
<nowiki>osm_lon:en: 2.3511541</nowiki><br><br />
== Store brand entries ==<br />
The current implementation of OFF already supports a field for Stores. It is a free text field where the user can enter whatever s/he wants. A variety of entries is the consequence. But most of all it is used to enter the value for the Store brand, i.e. the name of the store as is shown outside the store and on receipts.<br />
=== Fields ===<br />
* store-brand - the name of the store as found on receipts<br />
* wikidata - the entry on wikidata that contains more information on the supermarket chain.<br />
* countries - a list of countries where the chain currently operates (has stores). This information can be pulled from wikidata.<br />
* expiration-date-country - some kind of date when store no longer has any stores in a specific country. For instance user chain [https://www.wikidata.org/wiki/Q925132 Dia] used to be active in France and OFF still has products for this.<br />
=== Comments ===<br />
Note that this can also be imported from OSM by means of the receipts. On OSM it is indicated with the tag ''brand''.<br />
<br />
OSM also indicates a link to wikidata (for instance [https://www.wikidata.org/wiki/Q151954 Lidl]).<br />
<br />
<br />
=== Example Taxonomy Entry ===<br />
<nowiki>en:store-brand: en:Biocoop</nowiki><br />
<br><br />
<nowiki>countries:en: en:france</nowiki><br />
<br><br />
<nowiki>wikidata:en: Q2904039</nowiki><br />
<br />
== Lifecycle ==<br />
The lifecycle for the two taxonomies is related, so they will be discussed together.<br />
=== Kickstart ===<br />
The kickstart describes the initial, very first introduction of the taxonomies.<br />
==== Store brands ====<br />
The store brands taxonomy could be started with the current entries in the Stores field. Unfortunately the quality of these current entries seems rather low. It is preferred to start with a high quality list pulled in from external sources, like all [https://www.wikidata.org/wiki/Q18043413 supermarket] chains listed on Wikidata.<br />
<br />
As a subsequent step all existing entries could be mapped to this store brands taxonomy.<br />
<br />
==== Stores ====<br />
The stores taxonomy can initially be pulled from OFF Prices. The data only needs to be formatted in the correct way. The stores information provided by OFF Prices will then be used as a starting point.<br />
<br />
=== Maintenance ===<br />
==== Editing ====<br />
Editing involves changing existing items in the taxonomies.<br />
==== Extending ====<br />
Extending involves adding new items to the taxonomies through all possible applications.<br />
* Stores Taxonomy<br />
** OFF Prices - new stores can be found through new location_id and can be double checked against OSM id;<br />
* Productopener - use OSM id to check whether something is new;<br />
* API - use OSM id to check whether something is new;<br />
===== - Store Brands Taxonomy =====<br />
* OFF Prices - new store brands via OSM and wikidata;<br />
* Productopener - new store brands via OSM and wikidata;<br />
* API - new store brands via OSM and wikidata;<br />
<br />
== Spinoff ==<br />
Information on stores, operators and owners is not the main goal of OFF. OFF prefers that this is maintained by more specialised other parties. However OFF does gather this information through receipts for instance. Users are encouraged to add this kind of information to OpenStreetMap or wikidata.<br />
<br />
== Use cases ==<br />
* OFF Prices - To have the prices of products for individual stores and brands.<br />
* https://github.com/danslimmon/oscar Throw out a package, add to shopping list, potentially you can do an online order/click and collect (because the store * is known, and has wikidata, and a url)<br />
* Walk into an area with a geofence - https://github.com/alltheplaces/alltheplaces / open streetmap - have home assistant push a notification to get the three items from that Wikidata:brand store that are on your list<br />
* I need (uncommon ingredient or food); from the places it is sold which is closest to me?<br />
*I scanned an item. I'm standing inside an OSM shop/supermarket at (geofence). It has a Wikidata:brand. Would I like to add this as the store that sells this food?<br />
* Provides a way via name suggestion index to get a clear logo for a given brand of it is a store brand with more data captured in open food facts, Provides some insight into supply chains<br />
<br />
== Discussion points ==<br />
<br />
* What information should be stored by OFF and what can be left to OSM or Wikidata? <br />
* What to be done with shops that go out of business?<br />
<br />
== Note ==<br />
* We need to associate stores with brands that are sold in thoses stores (Auchan for Auchan…)<br />
* We should try to add Wikidata relations (and thus OSM ones) whenever possible<br />
* Chains - if a store is part of a chain with multiple stores it can be added through a wikidata link<br />
<br />
Moved to GitHub: https://github.com/openfoodfacts/openfoodfacts-server/blob/master/taxonomies/stores.txt</div>Aleenehttps://wiki.openfoodfacts.org/index.php?title=Global_stores_taxonomy&diff=20667Global stores taxonomy2024-03-07T15:12:03Z<p>Aleene: /* Extending */</p>
<hr />
<div>See [[Global taxonomies]] for instructions.<br />
[[Category:Global_Taxonomies]]<br />
== Introduction ==<br />
The stores taxonomy contains a list of locations where products (food products, beauty products, etc.) can be obtained. A related store brands taxonomy describes the brand names (store chains) of the individual stores.<br />
<br />
Most of the data related to these taxonomies is obtained through third parties (Wikidata, OpenStreetMap). The main interest of OFF is the relation between products, stores and brands.<br />
<br />
== Store entries ==<br />
An entry in the taxonomy describes a single location. This taxonomy can combine data pulled from various sources: receipts from prices, osm, wikidata, etc or provided by the user (honour system). OFF should be careful not copy to much data already maintained by other parties. And if data is copied, it is to provide a snapshot in time.<br />
=== Receipts ===<br />
[[File:Example receipt heading.png|100 px|thumb|right|Example receipt heading]]<br />
The basis could be the receipts that users have added on prices. As all OFF data, any information should be backed up by image proofs. In the case for a store, this could be a receipt. The store information available on the receipt can be extracted to the taxonomy. What can be extracted depends on the receipt. In the example shown here, it is possible to extract the store name, the operator (useful for franchises), the address, phone number, siret, naf and tva. Analysus of more receipts might reveal other country specific information.<br />
Hopefully this information is enough to unambiguously identify a store.<br />
<br />
=== Prices ===<br />
The stores taxonomy can be based on [https://prices.openfoodfacts.org/ OFF Prices]. The receipts corresponding to a shop are entered on Prices. Prices has a unique identifier for each shop, which should be used as a linking pin. In addition Prices offers a link with Openstreetmap, which can be used to pull in additional information. Some of this information is already cached by Prices.<br />
=== Open Street Map ===<br />
All stores are linked to [https://www.openstreetmap.org/ Open Street Map] (OSM) through the unique OSM id. The link refers to a basic object in OSM:<br />
* Node - is used to refer to a single location, like [https://www.openstreetmap.org/node/25213337 BP Service];<br />
* (Closed) Way - is used to refer to a building, like [https://www.openstreetmap.org/way/31348922 IKEA];<br />
* Relation - is used to refer multiple ways used by the shop, like [https://www.openstreetmap.org/relation/1235874 Carrefour];<br />
<br />
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. This can be limited to OSM objects that have the tag ''shop''.<br />
<br />
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.<br />
<br />
=== Example Taxonomy Entry===<br />
An example for an entry / location / store / shop in the taxonomy:<br><br />
<nowiki>store_brand:en: en:Biocoop</nowiki><br><br />
<nowiki>price_id:en: 45</nowiki><br><br />
<nowiki>osm_id:en: 9815975601</nowiki><br><br />
<nowiki>osm_type:en: NODE</nowiki><br><br />
<nowiki>osm_display_name:en: en:"Biocoop, Rue de Tolbiac, Quartier de la Maison-Blanche, Paris 13e Arrondissement, Paris, Île-de-France, France métropolitaine, 75013, France"</nowiki><br><br />
<nowiki>osm_address_postcode:en: 75013</nowiki><br><br />
<nowiki>osm_address_city:en: en:Paris</nowiki><br><br />
<nowiki>osm_address_country:en: en:france</nowiki><br><br />
<nowiki>osm_lat:en: 48.8259597</nowiki><br><br />
<nowiki>osm_lon:en: 2.3511541</nowiki><br><br />
== Store brand entries ==<br />
The current implementation of OFF already supports a field for Stores. It is a free text field where the user can enter whatever s/he wants. A variety of entries is the consequence. But most of all it is used to enter the value for the Store brand, i.e. the name of the store as is shown outside the store and on receipts.<br />
=== Fields ===<br />
* store-brand - the name of the store as found on receipts<br />
* wikidata - the entry on wikidata that contains more information on the supermarket chain.<br />
* countries - a list of countries where the chain currently operates (has stores). This information can be pulled from wikidata.<br />
* expiration-date-country - some kind of date when store no longer has any stores in a specific country. For instance user chain [https://www.wikidata.org/wiki/Q925132 Dia] used to be active in France and OFF still has products for this.<br />
=== Comments ===<br />
Note that this can also be imported from OSM by means of the receipts. On OSM it is indicated with the tag ''brand''.<br />
<br />
OSM also indicates a link to wikidata (for instance [https://www.wikidata.org/wiki/Q151954 Lidl]).<br />
<br />
<br />
=== Example Taxonomy Entry ===<br />
<nowiki>en:store-brand: en:Biocoop</nowiki><br />
<br><br />
<nowiki>countries:en: en:france</nowiki><br />
<br><br />
<nowiki>wikidata:en: Q2904039</nowiki><br />
<br />
== Lifecycle ==<br />
The lifecycle for the two taxonomies is related, so they will be discussed together.<br />
=== Kickstart ===<br />
The kickstart describes the initial, very first introduction of the taxonomies.<br />
==== Store brands ====<br />
The store brands taxonomy could be started with the current entries in the Stores field. Unfortunately the quality of these current entries seems rather low. It is preferred to start with a high quality list pulled in from external sources, like all [https://www.wikidata.org/wiki/Q18043413 supermarket] chains listed on Wikidata.<br />
<br />
As a subsequent step all existing entries could be mapped to this store brands taxonomy.<br />
<br />
==== Stores ====<br />
The stores taxonomy can initially be pulled from OFF Prices. The data only needs to be formatted in the correct way. The stores information provided by OFF Prices will then be used as a starting point.<br />
<br />
=== Maintenance ===<br />
==== Editing ====<br />
Editing involves changing existing items in the taxonomies.<br />
==== Extending ====<br />
Extending involves adding new items to the taxonomies through all possible applications.<br />
===== - Stores Taxonomy =====<br />
* OFF Prices - new stores can be found through new location_id and can be double checked against OSM id;<br />
* Productopener - use OSM id to check whether something is new;<br />
* API - use OSM id to check whether something is new;<br />
===== - Store Brands Taxonomy =====<br />
* OFF Prices - new store brands via OSM and wikidata;<br />
* Productopener - new store brands via OSM and wikidata;<br />
* API - new store brands via OSM and wikidata;<br />
<br />
== Spinoff ==<br />
Information on stores, operators and owners is not the main goal of OFF. OFF prefers that this is maintained by more specialised other parties. However OFF does gather this information through receipts for instance. Users are encouraged to add this kind of information to OpenStreetMap or wikidata.<br />
<br />
== Use cases ==<br />
* OFF Prices - To have the prices of products for individual stores and brands.<br />
* https://github.com/danslimmon/oscar Throw out a package, add to shopping list, potentially you can do an online order/click and collect (because the store * is known, and has wikidata, and a url)<br />
* Walk into an area with a geofence - https://github.com/alltheplaces/alltheplaces / open streetmap - have home assistant push a notification to get the three items from that Wikidata:brand store that are on your list<br />
* I need (uncommon ingredient or food); from the places it is sold which is closest to me?<br />
*I scanned an item. I'm standing inside an OSM shop/supermarket at (geofence). It has a Wikidata:brand. Would I like to add this as the store that sells this food?<br />
* Provides a way via name suggestion index to get a clear logo for a given brand of it is a store brand with more data captured in open food facts, Provides some insight into supply chains<br />
<br />
== Discussion points ==<br />
<br />
* What information should be stored by OFF and what can be left to OSM or Wikidata? <br />
* What to be done with shops that go out of business?<br />
<br />
== Note ==<br />
* We need to associate stores with brands that are sold in thoses stores (Auchan for Auchan…)<br />
* We should try to add Wikidata relations (and thus OSM ones) whenever possible<br />
* Chains - if a store is part of a chain with multiple stores it can be added through a wikidata link<br />
<br />
Moved to GitHub: https://github.com/openfoodfacts/openfoodfacts-server/blob/master/taxonomies/stores.txt</div>Aleenehttps://wiki.openfoodfacts.org/index.php?title=Global_stores_taxonomy&diff=20666Global stores taxonomy2024-03-07T15:11:29Z<p>Aleene: /* Extending */</p>
<hr />
<div>See [[Global taxonomies]] for instructions.<br />
[[Category:Global_Taxonomies]]<br />
== Introduction ==<br />
The stores taxonomy contains a list of locations where products (food products, beauty products, etc.) can be obtained. A related store brands taxonomy describes the brand names (store chains) of the individual stores.<br />
<br />
Most of the data related to these taxonomies is obtained through third parties (Wikidata, OpenStreetMap). The main interest of OFF is the relation between products, stores and brands.<br />
<br />
== Store entries ==<br />
An entry in the taxonomy describes a single location. This taxonomy can combine data pulled from various sources: receipts from prices, osm, wikidata, etc or provided by the user (honour system). OFF should be careful not copy to much data already maintained by other parties. And if data is copied, it is to provide a snapshot in time.<br />
=== Receipts ===<br />
[[File:Example receipt heading.png|100 px|thumb|right|Example receipt heading]]<br />
The basis could be the receipts that users have added on prices. As all OFF data, any information should be backed up by image proofs. In the case for a store, this could be a receipt. The store information available on the receipt can be extracted to the taxonomy. What can be extracted depends on the receipt. In the example shown here, it is possible to extract the store name, the operator (useful for franchises), the address, phone number, siret, naf and tva. Analysus of more receipts might reveal other country specific information.<br />
Hopefully this information is enough to unambiguously identify a store.<br />
<br />
=== Prices ===<br />
The stores taxonomy can be based on [https://prices.openfoodfacts.org/ OFF Prices]. The receipts corresponding to a shop are entered on Prices. Prices has a unique identifier for each shop, which should be used as a linking pin. In addition Prices offers a link with Openstreetmap, which can be used to pull in additional information. Some of this information is already cached by Prices.<br />
=== Open Street Map ===<br />
All stores are linked to [https://www.openstreetmap.org/ Open Street Map] (OSM) through the unique OSM id. The link refers to a basic object in OSM:<br />
* Node - is used to refer to a single location, like [https://www.openstreetmap.org/node/25213337 BP Service];<br />
* (Closed) Way - is used to refer to a building, like [https://www.openstreetmap.org/way/31348922 IKEA];<br />
* Relation - is used to refer multiple ways used by the shop, like [https://www.openstreetmap.org/relation/1235874 Carrefour];<br />
<br />
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. This can be limited to OSM objects that have the tag ''shop''.<br />
<br />
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.<br />
<br />
=== Example Taxonomy Entry===<br />
An example for an entry / location / store / shop in the taxonomy:<br><br />
<nowiki>store_brand:en: en:Biocoop</nowiki><br><br />
<nowiki>price_id:en: 45</nowiki><br><br />
<nowiki>osm_id:en: 9815975601</nowiki><br><br />
<nowiki>osm_type:en: NODE</nowiki><br><br />
<nowiki>osm_display_name:en: en:"Biocoop, Rue de Tolbiac, Quartier de la Maison-Blanche, Paris 13e Arrondissement, Paris, Île-de-France, France métropolitaine, 75013, France"</nowiki><br><br />
<nowiki>osm_address_postcode:en: 75013</nowiki><br><br />
<nowiki>osm_address_city:en: en:Paris</nowiki><br><br />
<nowiki>osm_address_country:en: en:france</nowiki><br><br />
<nowiki>osm_lat:en: 48.8259597</nowiki><br><br />
<nowiki>osm_lon:en: 2.3511541</nowiki><br><br />
== Store brand entries ==<br />
The current implementation of OFF already supports a field for Stores. It is a free text field where the user can enter whatever s/he wants. A variety of entries is the consequence. But most of all it is used to enter the value for the Store brand, i.e. the name of the store as is shown outside the store and on receipts.<br />
=== Fields ===<br />
* store-brand - the name of the store as found on receipts<br />
* wikidata - the entry on wikidata that contains more information on the supermarket chain.<br />
* countries - a list of countries where the chain currently operates (has stores). This information can be pulled from wikidata.<br />
* expiration-date-country - some kind of date when store no longer has any stores in a specific country. For instance user chain [https://www.wikidata.org/wiki/Q925132 Dia] used to be active in France and OFF still has products for this.<br />
=== Comments ===<br />
Note that this can also be imported from OSM by means of the receipts. On OSM it is indicated with the tag ''brand''.<br />
<br />
OSM also indicates a link to wikidata (for instance [https://www.wikidata.org/wiki/Q151954 Lidl]).<br />
<br />
<br />
=== Example Taxonomy Entry ===<br />
<nowiki>en:store-brand: en:Biocoop</nowiki><br />
<br><br />
<nowiki>countries:en: en:france</nowiki><br />
<br><br />
<nowiki>wikidata:en: Q2904039</nowiki><br />
<br />
== Lifecycle ==<br />
The lifecycle for the two taxonomies is related, so they will be discussed together.<br />
=== Kickstart ===<br />
The kickstart describes the initial, very first introduction of the taxonomies.<br />
==== Store brands ====<br />
The store brands taxonomy could be started with the current entries in the Stores field. Unfortunately the quality of these current entries seems rather low. It is preferred to start with a high quality list pulled in from external sources, like all [https://www.wikidata.org/wiki/Q18043413 supermarket] chains listed on Wikidata.<br />
<br />
As a subsequent step all existing entries could be mapped to this store brands taxonomy.<br />
<br />
==== Stores ====<br />
The stores taxonomy can initially be pulled from OFF Prices. The data only needs to be formatted in the correct way. The stores information provided by OFF Prices will then be used as a starting point.<br />
<br />
=== Maintenance ===<br />
==== Editing ====<br />
Editing involves changing existing items in the taxonomies.<br />
==== Extending ====<br />
Extending involves adding new items to the taxonomies through all possible applications.<br />
===== Stores Taxonomy =====<br />
* OFF Prices - new stores can be found through new location_id and can be double checked against OSM id;<br />
* Productopener - use OSM id to check whether something is new;<br />
* API - use OSM id to check whether something is new;<br />
===== Store Brands Taxonomy =====<br />
* OFF Prices - new store brands via OSM and wikidata;<br />
* Productopener - new store brands via OSM and wikidata;<br />
* API - new store brands via OSM and wikidata;<br />
<br />
== Spinoff ==<br />
Information on stores, operators and owners is not the main goal of OFF. OFF prefers that this is maintained by more specialised other parties. However OFF does gather this information through receipts for instance. Users are encouraged to add this kind of information to OpenStreetMap or wikidata.<br />
<br />
== Use cases ==<br />
* OFF Prices - To have the prices of products for individual stores and brands.<br />
* https://github.com/danslimmon/oscar Throw out a package, add to shopping list, potentially you can do an online order/click and collect (because the store * is known, and has wikidata, and a url)<br />
* Walk into an area with a geofence - https://github.com/alltheplaces/alltheplaces / open streetmap - have home assistant push a notification to get the three items from that Wikidata:brand store that are on your list<br />
* I need (uncommon ingredient or food); from the places it is sold which is closest to me?<br />
*I scanned an item. I'm standing inside an OSM shop/supermarket at (geofence). It has a Wikidata:brand. Would I like to add this as the store that sells this food?<br />
* Provides a way via name suggestion index to get a clear logo for a given brand of it is a store brand with more data captured in open food facts, Provides some insight into supply chains<br />
<br />
== Discussion points ==<br />
<br />
* What information should be stored by OFF and what can be left to OSM or Wikidata? <br />
* What to be done with shops that go out of business?<br />
<br />
== Note ==<br />
* We need to associate stores with brands that are sold in thoses stores (Auchan for Auchan…)<br />
* We should try to add Wikidata relations (and thus OSM ones) whenever possible<br />
* Chains - if a store is part of a chain with multiple stores it can be added through a wikidata link<br />
<br />
Moved to GitHub: https://github.com/openfoodfacts/openfoodfacts-server/blob/master/taxonomies/stores.txt</div>Aleenehttps://wiki.openfoodfacts.org/index.php?title=Global_stores_taxonomy&diff=20665Global stores taxonomy2024-03-07T14:29:02Z<p>Aleene: /* Extending */</p>
<hr />
<div>See [[Global taxonomies]] for instructions.<br />
[[Category:Global_Taxonomies]]<br />
== Introduction ==<br />
The stores taxonomy contains a list of locations where products (food products, beauty products, etc.) can be obtained. A related store brands taxonomy describes the brand names (store chains) of the individual stores.<br />
<br />
Most of the data related to these taxonomies is obtained through third parties (Wikidata, OpenStreetMap). The main interest of OFF is the relation between products, stores and brands.<br />
<br />
== Store entries ==<br />
An entry in the taxonomy describes a single location. This taxonomy can combine data pulled from various sources: receipts from prices, osm, wikidata, etc or provided by the user (honour system). OFF should be careful not copy to much data already maintained by other parties. And if data is copied, it is to provide a snapshot in time.<br />
=== Receipts ===<br />
[[File:Example receipt heading.png|100 px|thumb|right|Example receipt heading]]<br />
The basis could be the receipts that users have added on prices. As all OFF data, any information should be backed up by image proofs. In the case for a store, this could be a receipt. The store information available on the receipt can be extracted to the taxonomy. What can be extracted depends on the receipt. In the example shown here, it is possible to extract the store name, the operator (useful for franchises), the address, phone number, siret, naf and tva. Analysus of more receipts might reveal other country specific information.<br />
Hopefully this information is enough to unambiguously identify a store.<br />
<br />
=== Prices ===<br />
The stores taxonomy can be based on [https://prices.openfoodfacts.org/ OFF Prices]. The receipts corresponding to a shop are entered on Prices. Prices has a unique identifier for each shop, which should be used as a linking pin. In addition Prices offers a link with Openstreetmap, which can be used to pull in additional information. Some of this information is already cached by Prices.<br />
=== Open Street Map ===<br />
All stores are linked to [https://www.openstreetmap.org/ Open Street Map] (OSM) through the unique OSM id. The link refers to a basic object in OSM:<br />
* Node - is used to refer to a single location, like [https://www.openstreetmap.org/node/25213337 BP Service];<br />
* (Closed) Way - is used to refer to a building, like [https://www.openstreetmap.org/way/31348922 IKEA];<br />
* Relation - is used to refer multiple ways used by the shop, like [https://www.openstreetmap.org/relation/1235874 Carrefour];<br />
<br />
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. This can be limited to OSM objects that have the tag ''shop''.<br />
<br />
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.<br />
<br />
=== Example Taxonomy Entry===<br />
An example for an entry / location / store / shop in the taxonomy:<br><br />
<nowiki>store_brand:en: en:Biocoop</nowiki><br><br />
<nowiki>price_id:en: 45</nowiki><br><br />
<nowiki>osm_id:en: 9815975601</nowiki><br><br />
<nowiki>osm_type:en: NODE</nowiki><br><br />
<nowiki>osm_display_name:en: en:"Biocoop, Rue de Tolbiac, Quartier de la Maison-Blanche, Paris 13e Arrondissement, Paris, Île-de-France, France métropolitaine, 75013, France"</nowiki><br><br />
<nowiki>osm_address_postcode:en: 75013</nowiki><br><br />
<nowiki>osm_address_city:en: en:Paris</nowiki><br><br />
<nowiki>osm_address_country:en: en:france</nowiki><br><br />
<nowiki>osm_lat:en: 48.8259597</nowiki><br><br />
<nowiki>osm_lon:en: 2.3511541</nowiki><br><br />
== Store brand entries ==<br />
The current implementation of OFF already supports a field for Stores. It is a free text field where the user can enter whatever s/he wants. A variety of entries is the consequence. But most of all it is used to enter the value for the Store brand, i.e. the name of the store as is shown outside the store and on receipts.<br />
=== Fields ===<br />
* store-brand - the name of the store as found on receipts<br />
* wikidata - the entry on wikidata that contains more information on the supermarket chain.<br />
* countries - a list of countries where the chain currently operates (has stores). This information can be pulled from wikidata.<br />
* expiration-date-country - some kind of date when store no longer has any stores in a specific country. For instance user chain [https://www.wikidata.org/wiki/Q925132 Dia] used to be active in France and OFF still has products for this.<br />
=== Comments ===<br />
Note that this can also be imported from OSM by means of the receipts. On OSM it is indicated with the tag ''brand''.<br />
<br />
OSM also indicates a link to wikidata (for instance [https://www.wikidata.org/wiki/Q151954 Lidl]).<br />
<br />
<br />
=== Example Taxonomy Entry ===<br />
<nowiki>en:store-brand: en:Biocoop</nowiki><br />
<br><br />
<nowiki>countries:en: en:france</nowiki><br />
<br><br />
<nowiki>wikidata:en: Q2904039</nowiki><br />
<br />
== Lifecycle ==<br />
The lifecycle for the two taxonomies is related, so they will be discussed together.<br />
=== Kickstart ===<br />
The kickstart describes the initial, very first introduction of the taxonomies.<br />
==== Store brands ====<br />
The store brands taxonomy could be started with the current entries in the Stores field. Unfortunately the quality of these current entries seems rather low. It is preferred to start with a high quality list pulled in from external sources, like all [https://www.wikidata.org/wiki/Q18043413 supermarket] chains listed on Wikidata.<br />
<br />
As a subsequent step all existing entries could be mapped to this store brands taxonomy.<br />
<br />
==== Stores ====<br />
The stores taxonomy can initially be pulled from OFF Prices. The data only needs to be formatted in the correct way. The stores information provided by OFF Prices will then be used as a starting point.<br />
<br />
=== Maintenance ===<br />
==== Editing ====<br />
Editing involves changing existing items in the taxonomies.<br />
==== Extending ====<br />
Extending involves adding new items to the taxonomies through all possible applications.<br />
* Prices [https://prices.openfoodfacts.org/ OFF Prices].<br />
* Productopener<br />
* API<br />
<br />
== Spinoff ==<br />
Information on stores, operators and owners is not the main goal of OFF. OFF prefers that this is maintained by more specialised other parties. However OFF does gather this information through receipts for instance. Users are encouraged to add this kind of information to OpenStreetMap or wikidata.<br />
<br />
== Use cases ==<br />
* OFF Prices - To have the prices of products for individual stores and brands.<br />
* https://github.com/danslimmon/oscar Throw out a package, add to shopping list, potentially you can do an online order/click and collect (because the store * is known, and has wikidata, and a url)<br />
* Walk into an area with a geofence - https://github.com/alltheplaces/alltheplaces / open streetmap - have home assistant push a notification to get the three items from that Wikidata:brand store that are on your list<br />
* I need (uncommon ingredient or food); from the places it is sold which is closest to me?<br />
*I scanned an item. I'm standing inside an OSM shop/supermarket at (geofence). It has a Wikidata:brand. Would I like to add this as the store that sells this food?<br />
* Provides a way via name suggestion index to get a clear logo for a given brand of it is a store brand with more data captured in open food facts, Provides some insight into supply chains<br />
<br />
== Discussion points ==<br />
<br />
* What information should be stored by OFF and what can be left to OSM or Wikidata? <br />
* What to be done with shops that go out of business?<br />
<br />
== Note ==<br />
* We need to associate stores with brands that are sold in thoses stores (Auchan for Auchan…)<br />
* We should try to add Wikidata relations (and thus OSM ones) whenever possible<br />
* Chains - if a store is part of a chain with multiple stores it can be added through a wikidata link<br />
<br />
Moved to GitHub: https://github.com/openfoodfacts/openfoodfacts-server/blob/master/taxonomies/stores.txt</div>Aleenehttps://wiki.openfoodfacts.org/index.php?title=Global_stores_taxonomy&diff=20663Global stores taxonomy2024-03-07T10:27:46Z<p>Aleene: /* Use cases */</p>
<hr />
<div>See [[Global taxonomies]] for instructions.<br />
[[Category:Global_Taxonomies]]<br />
== Introduction ==<br />
The stores taxonomy contains a list of locations where products (food products, beauty products, etc.) can be obtained. A related store brands taxonomy describes the brand names (store chains) of the individual stores.<br />
<br />
Most of the data related to these taxonomies is obtained through third parties (Wikidata, OpenStreetMap). The main interest of OFF is the relation between products, stores and brands.<br />
<br />
== Store entries ==<br />
An entry in the taxonomy describes a single location. This taxonomy can combine data pulled from various sources: receipts from prices, osm, wikidata, etc or provided by the user (honour system). OFF should be careful not copy to much data already maintained by other parties. And if data is copied, it is to provide a snapshot in time.<br />
=== Receipts ===<br />
[[File:Example receipt heading.png|100 px|thumb|right|Example receipt heading]]<br />
The basis could be the receipts that users have added on prices. As all OFF data, any information should be backed up by image proofs. In the case for a store, this could be a receipt. The store information available on the receipt can be extracted to the taxonomy. What can be extracted depends on the receipt. In the example shown here, it is possible to extract the store name, the operator (useful for franchises), the address, phone number, siret, naf and tva. Analysus of more receipts might reveal other country specific information.<br />
Hopefully this information is enough to unambiguously identify a store.<br />
<br />
=== Prices ===<br />
The stores taxonomy can be based on [https://prices.openfoodfacts.org/ OFF Prices]. The receipts corresponding to a shop are entered on Prices. Prices has a unique identifier for each shop, which should be used as a linking pin. In addition Prices offers a link with Openstreetmap, which can be used to pull in additional information. Some of this information is already cached by Prices.<br />
=== Open Street Map ===<br />
All stores are linked to [https://www.openstreetmap.org/ Open Street Map] (OSM) through the unique OSM id. The link refers to a basic object in OSM:<br />
* Node - is used to refer to a single location, like [https://www.openstreetmap.org/node/25213337 BP Service];<br />
* (Closed) Way - is used to refer to a building, like [https://www.openstreetmap.org/way/31348922 IKEA];<br />
* Relation - is used to refer multiple ways used by the shop, like [https://www.openstreetmap.org/relation/1235874 Carrefour];<br />
<br />
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. This can be limited to OSM objects that have the tag ''shop''.<br />
<br />
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.<br />
<br />
=== Example Taxonomy Entry===<br />
An example for an entry / location / store / shop in the taxonomy:<br><br />
<nowiki>store_brand:en: en:Biocoop</nowiki><br><br />
<nowiki>price_id:en: 45</nowiki><br><br />
<nowiki>osm_id:en: 9815975601</nowiki><br><br />
<nowiki>osm_type:en: NODE</nowiki><br><br />
<nowiki>osm_display_name:en: en:"Biocoop, Rue de Tolbiac, Quartier de la Maison-Blanche, Paris 13e Arrondissement, Paris, Île-de-France, France métropolitaine, 75013, France"</nowiki><br><br />
<nowiki>osm_address_postcode:en: 75013</nowiki><br><br />
<nowiki>osm_address_city:en: en:Paris</nowiki><br><br />
<nowiki>osm_address_country:en: en:france</nowiki><br><br />
<nowiki>osm_lat:en: 48.8259597</nowiki><br><br />
<nowiki>osm_lon:en: 2.3511541</nowiki><br><br />
== Store brand entries ==<br />
The current implementation of OFF already supports a field for Stores. It is a free text field where the user can enter whatever s/he wants. A variety of entries is the consequence. But most of all it is used to enter the value for the Store brand, i.e. the name of the store as is shown outside the store and on receipts.<br />
=== Fields ===<br />
* store-brand - the name of the store as found on receipts<br />
* wikidata - the entry on wikidata that contains more information on the supermarket chain.<br />
* countries - a list of countries where the chain currently operates (has stores). This information can be pulled from wikidata.<br />
* expiration-date-country - some kind of date when store no longer has any stores in a specific country. For instance user chain [https://www.wikidata.org/wiki/Q925132 Dia] used to be active in France and OFF still has products for this.<br />
=== Comments ===<br />
Note that this can also be imported from OSM by means of the receipts. On OSM it is indicated with the tag ''brand''.<br />
<br />
OSM also indicates a link to wikidata (for instance [https://www.wikidata.org/wiki/Q151954 Lidl]).<br />
<br />
<br />
=== Example Taxonomy Entry ===<br />
<nowiki>en:store-brand: en:Biocoop</nowiki><br />
<br><br />
<nowiki>countries:en: en:france</nowiki><br />
<br><br />
<nowiki>wikidata:en: Q2904039</nowiki><br />
<br />
== Lifecycle ==<br />
The lifecycle for the two taxonomies is related, so they will be discussed together.<br />
=== Kickstart ===<br />
The kickstart describes the initial, very first introduction of the taxonomies.<br />
==== Store brands ====<br />
The store brands taxonomy could be started with the current entries in the Stores field. Unfortunately the quality of these current entries seems rather low. It is preferred to start with a high quality list pulled in from external sources, like all [https://www.wikidata.org/wiki/Q18043413 supermarket] chains listed on Wikidata.<br />
<br />
As a subsequent step all existing entries could be mapped to this store brands taxonomy.<br />
<br />
==== Stores ====<br />
The stores taxonomy can initially be pulled from OFF Prices. The data only needs to be formatted in the correct way. The stores information provided by OFF Prices will then be used as a starting point.<br />
<br />
=== Maintenance ===<br />
==== Editing ====<br />
Editing involves changing existing items in the taxonomies.<br />
==== Extending ====<br />
Extending involves adding new items to the taxonomies.<br />
The stores taxonomy needs to be regularly updated from the data entered through [https://prices.openfoodfacts.org/ OFF Prices]. This means any changed values and any added entries/<br />
<br />
== Spinoff ==<br />
Information on stores, operators and owners is not the main goal of OFF. OFF prefers that this is maintained by more specialised other parties. However OFF does gather this information through receipts for instance. Users are encouraged to add this kind of information to OpenStreetMap or wikidata.<br />
<br />
== Use cases ==<br />
* OFF Prices - To have the prices of products for individual stores and brands.<br />
* https://github.com/danslimmon/oscar Throw out a package, add to shopping list, potentially you can do an online order/click and collect (because the store * is known, and has wikidata, and a url)<br />
* Walk into an area with a geofence - https://github.com/alltheplaces/alltheplaces / open streetmap - have home assistant push a notification to get the three items from that Wikidata:brand store that are on your list<br />
* I need (uncommon ingredient or food); from the places it is sold which is closest to me?<br />
*I scanned an item. I'm standing inside an OSM shop/supermarket at (geofence). It has a Wikidata:brand. Would I like to add this as the store that sells this food?<br />
* Provides a way via name suggestion index to get a clear logo for a given brand of it is a store brand with more data captured in open food facts, Provides some insight into supply chains<br />
<br />
== Discussion points ==<br />
<br />
* What information should be stored by OFF and what can be left to OSM or Wikidata? <br />
* What to be done with shops that go out of business?<br />
<br />
== Note ==<br />
* We need to associate stores with brands that are sold in thoses stores (Auchan for Auchan…)<br />
* We should try to add Wikidata relations (and thus OSM ones) whenever possible<br />
* Chains - if a store is part of a chain with multiple stores it can be added through a wikidata link<br />
<br />
Moved to GitHub: https://github.com/openfoodfacts/openfoodfacts-server/blob/master/taxonomies/stores.txt</div>Aleenehttps://wiki.openfoodfacts.org/index.php?title=Global_stores_taxonomy&diff=20662Global stores taxonomy2024-03-07T10:22:13Z<p>Aleene: /* Example Taxonomy Entry */</p>
<hr />
<div>See [[Global taxonomies]] for instructions.<br />
[[Category:Global_Taxonomies]]<br />
== Introduction ==<br />
The stores taxonomy contains a list of locations where products (food products, beauty products, etc.) can be obtained. A related store brands taxonomy describes the brand names (store chains) of the individual stores.<br />
<br />
Most of the data related to these taxonomies is obtained through third parties (Wikidata, OpenStreetMap). The main interest of OFF is the relation between products, stores and brands.<br />
<br />
== Store entries ==<br />
An entry in the taxonomy describes a single location. This taxonomy can combine data pulled from various sources: receipts from prices, osm, wikidata, etc or provided by the user (honour system). OFF should be careful not copy to much data already maintained by other parties. And if data is copied, it is to provide a snapshot in time.<br />
=== Receipts ===<br />
[[File:Example receipt heading.png|100 px|thumb|right|Example receipt heading]]<br />
The basis could be the receipts that users have added on prices. As all OFF data, any information should be backed up by image proofs. In the case for a store, this could be a receipt. The store information available on the receipt can be extracted to the taxonomy. What can be extracted depends on the receipt. In the example shown here, it is possible to extract the store name, the operator (useful for franchises), the address, phone number, siret, naf and tva. Analysus of more receipts might reveal other country specific information.<br />
Hopefully this information is enough to unambiguously identify a store.<br />
<br />
=== Prices ===<br />
The stores taxonomy can be based on [https://prices.openfoodfacts.org/ OFF Prices]. The receipts corresponding to a shop are entered on Prices. Prices has a unique identifier for each shop, which should be used as a linking pin. In addition Prices offers a link with Openstreetmap, which can be used to pull in additional information. Some of this information is already cached by Prices.<br />
=== Open Street Map ===<br />
All stores are linked to [https://www.openstreetmap.org/ Open Street Map] (OSM) through the unique OSM id. The link refers to a basic object in OSM:<br />
* Node - is used to refer to a single location, like [https://www.openstreetmap.org/node/25213337 BP Service];<br />
* (Closed) Way - is used to refer to a building, like [https://www.openstreetmap.org/way/31348922 IKEA];<br />
* Relation - is used to refer multiple ways used by the shop, like [https://www.openstreetmap.org/relation/1235874 Carrefour];<br />
<br />
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. This can be limited to OSM objects that have the tag ''shop''.<br />
<br />
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.<br />
<br />
=== Example Taxonomy Entry===<br />
An example for an entry / location / store / shop in the taxonomy:<br><br />
<nowiki>store_brand:en: en:Biocoop</nowiki><br><br />
<nowiki>price_id:en: 45</nowiki><br><br />
<nowiki>osm_id:en: 9815975601</nowiki><br><br />
<nowiki>osm_type:en: NODE</nowiki><br><br />
<nowiki>osm_display_name:en: en:"Biocoop, Rue de Tolbiac, Quartier de la Maison-Blanche, Paris 13e Arrondissement, Paris, Île-de-France, France métropolitaine, 75013, France"</nowiki><br><br />
<nowiki>osm_address_postcode:en: 75013</nowiki><br><br />
<nowiki>osm_address_city:en: en:Paris</nowiki><br><br />
<nowiki>osm_address_country:en: en:france</nowiki><br><br />
<nowiki>osm_lat:en: 48.8259597</nowiki><br><br />
<nowiki>osm_lon:en: 2.3511541</nowiki><br><br />
== Store brand entries ==<br />
The current implementation of OFF already supports a field for Stores. It is a free text field where the user can enter whatever s/he wants. A variety of entries is the consequence. But most of all it is used to enter the value for the Store brand, i.e. the name of the store as is shown outside the store and on receipts.<br />
=== Fields ===<br />
* store-brand - the name of the store as found on receipts<br />
* wikidata - the entry on wikidata that contains more information on the supermarket chain.<br />
* countries - a list of countries where the chain currently operates (has stores). This information can be pulled from wikidata.<br />
* expiration-date-country - some kind of date when store no longer has any stores in a specific country. For instance user chain [https://www.wikidata.org/wiki/Q925132 Dia] used to be active in France and OFF still has products for this.<br />
=== Comments ===<br />
Note that this can also be imported from OSM by means of the receipts. On OSM it is indicated with the tag ''brand''.<br />
<br />
OSM also indicates a link to wikidata (for instance [https://www.wikidata.org/wiki/Q151954 Lidl]).<br />
<br />
<br />
=== Example Taxonomy Entry ===<br />
<nowiki>en:store-brand: en:Biocoop</nowiki><br />
<br><br />
<nowiki>countries:en: en:france</nowiki><br />
<br><br />
<nowiki>wikidata:en: Q2904039</nowiki><br />
<br />
== Lifecycle ==<br />
The lifecycle for the two taxonomies is related, so they will be discussed together.<br />
=== Kickstart ===<br />
The kickstart describes the initial, very first introduction of the taxonomies.<br />
==== Store brands ====<br />
The store brands taxonomy could be started with the current entries in the Stores field. Unfortunately the quality of these current entries seems rather low. It is preferred to start with a high quality list pulled in from external sources, like all [https://www.wikidata.org/wiki/Q18043413 supermarket] chains listed on Wikidata.<br />
<br />
As a subsequent step all existing entries could be mapped to this store brands taxonomy.<br />
<br />
==== Stores ====<br />
The stores taxonomy can initially be pulled from OFF Prices. The data only needs to be formatted in the correct way. The stores information provided by OFF Prices will then be used as a starting point.<br />
<br />
=== Maintenance ===<br />
==== Editing ====<br />
Editing involves changing existing items in the taxonomies.<br />
==== Extending ====<br />
Extending involves adding new items to the taxonomies.<br />
The stores taxonomy needs to be regularly updated from the data entered through [https://prices.openfoodfacts.org/ OFF Prices]. This means any changed values and any added entries/<br />
<br />
== Spinoff ==<br />
Information on stores, operators and owners is not the main goal of OFF. OFF prefers that this is maintained by more specialised other parties. However OFF does gather this information through receipts for instance. Users are encouraged to add this kind of information to OpenStreetMap or wikidata.<br />
<br />
== Use cases ==<br />
=== OFF Prices ===<br />
To have the prices of products for individual stores and brands.<br />
<br />
== Discussion points ==<br />
<br />
* What information should be stored by OFF and what can be left to OSM or Wikidata? <br />
* What to be done with shops that go out of business?<br />
<br />
== Note ==<br />
* We need to associate stores with brands that are sold in thoses stores (Auchan for Auchan…)<br />
* We should try to add Wikidata relations (and thus OSM ones) whenever possible<br />
* Chains - if a store is part of a chain with multiple stores it can be added through a wikidata link<br />
<br />
Moved to GitHub: https://github.com/openfoodfacts/openfoodfacts-server/blob/master/taxonomies/stores.txt</div>Aleenehttps://wiki.openfoodfacts.org/index.php?title=Global_stores_taxonomy&diff=20661Global stores taxonomy2024-03-07T10:22:01Z<p>Aleene: /* Example Taxonomy Entry */</p>
<hr />
<div>See [[Global taxonomies]] for instructions.<br />
[[Category:Global_Taxonomies]]<br />
== Introduction ==<br />
The stores taxonomy contains a list of locations where products (food products, beauty products, etc.) can be obtained. A related store brands taxonomy describes the brand names (store chains) of the individual stores.<br />
<br />
Most of the data related to these taxonomies is obtained through third parties (Wikidata, OpenStreetMap). The main interest of OFF is the relation between products, stores and brands.<br />
<br />
== Store entries ==<br />
An entry in the taxonomy describes a single location. This taxonomy can combine data pulled from various sources: receipts from prices, osm, wikidata, etc or provided by the user (honour system). OFF should be careful not copy to much data already maintained by other parties. And if data is copied, it is to provide a snapshot in time.<br />
=== Receipts ===<br />
[[File:Example receipt heading.png|100 px|thumb|right|Example receipt heading]]<br />
The basis could be the receipts that users have added on prices. As all OFF data, any information should be backed up by image proofs. In the case for a store, this could be a receipt. The store information available on the receipt can be extracted to the taxonomy. What can be extracted depends on the receipt. In the example shown here, it is possible to extract the store name, the operator (useful for franchises), the address, phone number, siret, naf and tva. Analysus of more receipts might reveal other country specific information.<br />
Hopefully this information is enough to unambiguously identify a store.<br />
<br />
=== Prices ===<br />
The stores taxonomy can be based on [https://prices.openfoodfacts.org/ OFF Prices]. The receipts corresponding to a shop are entered on Prices. Prices has a unique identifier for each shop, which should be used as a linking pin. In addition Prices offers a link with Openstreetmap, which can be used to pull in additional information. Some of this information is already cached by Prices.<br />
=== Open Street Map ===<br />
All stores are linked to [https://www.openstreetmap.org/ Open Street Map] (OSM) through the unique OSM id. The link refers to a basic object in OSM:<br />
* Node - is used to refer to a single location, like [https://www.openstreetmap.org/node/25213337 BP Service];<br />
* (Closed) Way - is used to refer to a building, like [https://www.openstreetmap.org/way/31348922 IKEA];<br />
* Relation - is used to refer multiple ways used by the shop, like [https://www.openstreetmap.org/relation/1235874 Carrefour];<br />
<br />
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. This can be limited to OSM objects that have the tag ''shop''.<br />
<br />
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.<br />
<br />
=== Example Taxonomy Entry===<br />
An example for an entry / location / store / shop in the taxonomy:<br><br />
<nowiki>store_brand:en: en:Biocoop</nowiki><br><br />
<nowiki>price_id:en: 45</nowiki><br><br />
<nowiki>osm_id:en: 9815975601</nowiki><br><br />
<nowiki>osm_type:en: NODE</nowiki><br><br />
<nowiki>osm_display_name:en: en:"Biocoop, Rue de Tolbiac, Quartier de la Maison-Blanche, Paris 13e Arrondissement, Paris, Île-de-France, France métropolitaine, 75013, France"</nowiki><br><br />
<nowiki>osm_address_postcode:en: 75013</nowiki><br><br />
<nowiki>osm_address_city:en: en:Paris</nowiki><br><br />
<nowiki>osm_address_country:en: en:france</nowiki><br><br />
<nowiki>osm_lat:en: 48.8259597</nowiki><br><br />
<nowiki>osm_lon:en: 2.3511541</nowiki><br><br />
== Store brand entries ==<br />
The current implementation of OFF already supports a field for Stores. It is a free text field where the user can enter whatever s/he wants. A variety of entries is the consequence. But most of all it is used to enter the value for the Store brand, i.e. the name of the store as is shown outside the store and on receipts.<br />
=== Fields ===<br />
* store-brand - the name of the store as found on receipts<br />
* wikidata - the entry on wikidata that contains more information on the supermarket chain.<br />
* countries - a list of countries where the chain currently operates (has stores). This information can be pulled from wikidata.<br />
* expiration-date-country - some kind of date when store no longer has any stores in a specific country. For instance user chain [https://www.wikidata.org/wiki/Q925132 Dia] used to be active in France and OFF still has products for this.<br />
=== Comments ===<br />
Note that this can also be imported from OSM by means of the receipts. On OSM it is indicated with the tag ''brand''.<br />
<br />
OSM also indicates a link to wikidata (for instance [https://www.wikidata.org/wiki/Q151954 Lidl]).<br />
<br />
<br />
=== Example Taxonomy Entry ===<br />
<br><br />
<nowiki>en:store-brand: en:Biocoop</nowiki><br />
<br><br />
<nowiki>countries:en: en:france</nowiki><br />
<br><br />
<nowiki>wikidata:en: Q2904039</nowiki><br />
<br />
== Lifecycle ==<br />
The lifecycle for the two taxonomies is related, so they will be discussed together.<br />
=== Kickstart ===<br />
The kickstart describes the initial, very first introduction of the taxonomies.<br />
==== Store brands ====<br />
The store brands taxonomy could be started with the current entries in the Stores field. Unfortunately the quality of these current entries seems rather low. It is preferred to start with a high quality list pulled in from external sources, like all [https://www.wikidata.org/wiki/Q18043413 supermarket] chains listed on Wikidata.<br />
<br />
As a subsequent step all existing entries could be mapped to this store brands taxonomy.<br />
<br />
==== Stores ====<br />
The stores taxonomy can initially be pulled from OFF Prices. The data only needs to be formatted in the correct way. The stores information provided by OFF Prices will then be used as a starting point.<br />
<br />
=== Maintenance ===<br />
==== Editing ====<br />
Editing involves changing existing items in the taxonomies.<br />
==== Extending ====<br />
Extending involves adding new items to the taxonomies.<br />
The stores taxonomy needs to be regularly updated from the data entered through [https://prices.openfoodfacts.org/ OFF Prices]. This means any changed values and any added entries/<br />
<br />
== Spinoff ==<br />
Information on stores, operators and owners is not the main goal of OFF. OFF prefers that this is maintained by more specialised other parties. However OFF does gather this information through receipts for instance. Users are encouraged to add this kind of information to OpenStreetMap or wikidata.<br />
<br />
== Use cases ==<br />
=== OFF Prices ===<br />
To have the prices of products for individual stores and brands.<br />
<br />
== Discussion points ==<br />
<br />
* What information should be stored by OFF and what can be left to OSM or Wikidata? <br />
* What to be done with shops that go out of business?<br />
<br />
== Note ==<br />
* We need to associate stores with brands that are sold in thoses stores (Auchan for Auchan…)<br />
* We should try to add Wikidata relations (and thus OSM ones) whenever possible<br />
* Chains - if a store is part of a chain with multiple stores it can be added through a wikidata link<br />
<br />
Moved to GitHub: https://github.com/openfoodfacts/openfoodfacts-server/blob/master/taxonomies/stores.txt</div>Aleenehttps://wiki.openfoodfacts.org/index.php?title=Global_stores_taxonomy&diff=20660Global stores taxonomy2024-03-07T10:21:09Z<p>Aleene: /* Store brand entries */</p>
<hr />
<div>See [[Global taxonomies]] for instructions.<br />
[[Category:Global_Taxonomies]]<br />
== Introduction ==<br />
The stores taxonomy contains a list of locations where products (food products, beauty products, etc.) can be obtained. A related store brands taxonomy describes the brand names (store chains) of the individual stores.<br />
<br />
Most of the data related to these taxonomies is obtained through third parties (Wikidata, OpenStreetMap). The main interest of OFF is the relation between products, stores and brands.<br />
<br />
== Store entries ==<br />
An entry in the taxonomy describes a single location. This taxonomy can combine data pulled from various sources: receipts from prices, osm, wikidata, etc or provided by the user (honour system). OFF should be careful not copy to much data already maintained by other parties. And if data is copied, it is to provide a snapshot in time.<br />
=== Receipts ===<br />
[[File:Example receipt heading.png|100 px|thumb|right|Example receipt heading]]<br />
The basis could be the receipts that users have added on prices. As all OFF data, any information should be backed up by image proofs. In the case for a store, this could be a receipt. The store information available on the receipt can be extracted to the taxonomy. What can be extracted depends on the receipt. In the example shown here, it is possible to extract the store name, the operator (useful for franchises), the address, phone number, siret, naf and tva. Analysus of more receipts might reveal other country specific information.<br />
Hopefully this information is enough to unambiguously identify a store.<br />
<br />
=== Prices ===<br />
The stores taxonomy can be based on [https://prices.openfoodfacts.org/ OFF Prices]. The receipts corresponding to a shop are entered on Prices. Prices has a unique identifier for each shop, which should be used as a linking pin. In addition Prices offers a link with Openstreetmap, which can be used to pull in additional information. Some of this information is already cached by Prices.<br />
=== Open Street Map ===<br />
All stores are linked to [https://www.openstreetmap.org/ Open Street Map] (OSM) through the unique OSM id. The link refers to a basic object in OSM:<br />
* Node - is used to refer to a single location, like [https://www.openstreetmap.org/node/25213337 BP Service];<br />
* (Closed) Way - is used to refer to a building, like [https://www.openstreetmap.org/way/31348922 IKEA];<br />
* Relation - is used to refer multiple ways used by the shop, like [https://www.openstreetmap.org/relation/1235874 Carrefour];<br />
<br />
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. This can be limited to OSM objects that have the tag ''shop''.<br />
<br />
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.<br />
<br />
=== Example Taxonomy Entry===<br />
An example for an entry / location / store / shop in the taxonomy:<br><br />
<nowiki>store_brand:en: en:Biocoop</nowiki><br><br />
<nowiki>price_id:en: 45</nowiki><br><br />
<nowiki>osm_id:en: 9815975601</nowiki><br><br />
<nowiki>osm_type:en: NODE</nowiki><br><br />
<nowiki>osm_display_name:en: en:"Biocoop, Rue de Tolbiac, Quartier de la Maison-Blanche, Paris 13e Arrondissement, Paris, Île-de-France, France métropolitaine, 75013, France"</nowiki><br><br />
<nowiki>osm_address_postcode:en: 75013</nowiki><br><br />
<nowiki>osm_address_city:en: en:Paris</nowiki><br><br />
<nowiki>osm_address_country:en: en:france</nowiki><br><br />
<nowiki>osm_lat:en: 48.8259597</nowiki><br><br />
<nowiki>osm_lon:en: 2.3511541</nowiki><br><br />
== Store brand entries ==<br />
The current implementation of OFF already supports a field for Stores. It is a free text field where the user can enter whatever s/he wants. A variety of entries is the consequence. But most of all it is used to enter the value for the Store brand, i.e. the name of the store as is shown outside the store and on receipts.<br />
=== Fields ===<br />
* store-brand - the name of the store as found on receipts<br />
* wikidata - the entry on wikidata that contains more information on the supermarket chain.<br />
* countries - a list of countries where the chain currently operates (has stores). This information can be pulled from wikidata.<br />
* expiration-date-country - some kind of date when store no longer has any stores in a specific country. For instance user chain [https://www.wikidata.org/wiki/Q925132 Dia] used to be active in France and OFF still has products for this.<br />
=== Comments ===<br />
Note that this can also be imported from OSM by means of the receipts. On OSM it is indicated with the tag ''brand''.<br />
<br />
OSM also indicates a link to wikidata (for instance [https://www.wikidata.org/wiki/Q151954 Lidl]).<br />
<br />
<br />
=== Example Taxonomy Entry ===<br />
en:store-brand: en:Biocoop<br />
countries:en: en:france<br />
wikidata:en: Q2904039<br />
<br />
== Lifecycle ==<br />
The lifecycle for the two taxonomies is related, so they will be discussed together.<br />
=== Kickstart ===<br />
The kickstart describes the initial, very first introduction of the taxonomies.<br />
==== Store brands ====<br />
The store brands taxonomy could be started with the current entries in the Stores field. Unfortunately the quality of these current entries seems rather low. It is preferred to start with a high quality list pulled in from external sources, like all [https://www.wikidata.org/wiki/Q18043413 supermarket] chains listed on Wikidata.<br />
<br />
As a subsequent step all existing entries could be mapped to this store brands taxonomy.<br />
<br />
==== Stores ====<br />
The stores taxonomy can initially be pulled from OFF Prices. The data only needs to be formatted in the correct way. The stores information provided by OFF Prices will then be used as a starting point.<br />
<br />
=== Maintenance ===<br />
==== Editing ====<br />
Editing involves changing existing items in the taxonomies.<br />
==== Extending ====<br />
Extending involves adding new items to the taxonomies.<br />
The stores taxonomy needs to be regularly updated from the data entered through [https://prices.openfoodfacts.org/ OFF Prices]. This means any changed values and any added entries/<br />
<br />
== Spinoff ==<br />
Information on stores, operators and owners is not the main goal of OFF. OFF prefers that this is maintained by more specialised other parties. However OFF does gather this information through receipts for instance. Users are encouraged to add this kind of information to OpenStreetMap or wikidata.<br />
<br />
== Use cases ==<br />
=== OFF Prices ===<br />
To have the prices of products for individual stores and brands.<br />
<br />
== Discussion points ==<br />
<br />
* What information should be stored by OFF and what can be left to OSM or Wikidata? <br />
* What to be done with shops that go out of business?<br />
<br />
== Note ==<br />
* We need to associate stores with brands that are sold in thoses stores (Auchan for Auchan…)<br />
* We should try to add Wikidata relations (and thus OSM ones) whenever possible<br />
* Chains - if a store is part of a chain with multiple stores it can be added through a wikidata link<br />
<br />
Moved to GitHub: https://github.com/openfoodfacts/openfoodfacts-server/blob/master/taxonomies/stores.txt</div>Aleenehttps://wiki.openfoodfacts.org/index.php?title=Global_stores_taxonomy&diff=20659Global stores taxonomy2024-03-07T10:04:42Z<p>Aleene: /* Receipts */</p>
<hr />
<div>See [[Global taxonomies]] for instructions.<br />
[[Category:Global_Taxonomies]]<br />
== Introduction ==<br />
The stores taxonomy contains a list of locations where products (food products, beauty products, etc.) can be obtained. A related store brands taxonomy describes the brand names (store chains) of the individual stores.<br />
<br />
Most of the data related to these taxonomies is obtained through third parties (Wikidata, OpenStreetMap). The main interest of OFF is the relation between products, stores and brands.<br />
<br />
== Store entries ==<br />
An entry in the taxonomy describes a single location. This taxonomy can combine data pulled from various sources: receipts from prices, osm, wikidata, etc or provided by the user (honour system). OFF should be careful not copy to much data already maintained by other parties. And if data is copied, it is to provide a snapshot in time.<br />
=== Receipts ===<br />
[[File:Example receipt heading.png|100 px|thumb|right|Example receipt heading]]<br />
The basis could be the receipts that users have added on prices. As all OFF data, any information should be backed up by image proofs. In the case for a store, this could be a receipt. The store information available on the receipt can be extracted to the taxonomy. What can be extracted depends on the receipt. In the example shown here, it is possible to extract the store name, the operator (useful for franchises), the address, phone number, siret, naf and tva. Analysus of more receipts might reveal other country specific information.<br />
Hopefully this information is enough to unambiguously identify a store.<br />
<br />
=== Prices ===<br />
The stores taxonomy can be based on [https://prices.openfoodfacts.org/ OFF Prices]. The receipts corresponding to a shop are entered on Prices. Prices has a unique identifier for each shop, which should be used as a linking pin. In addition Prices offers a link with Openstreetmap, which can be used to pull in additional information. Some of this information is already cached by Prices.<br />
=== Open Street Map ===<br />
All stores are linked to [https://www.openstreetmap.org/ Open Street Map] (OSM) through the unique OSM id. The link refers to a basic object in OSM:<br />
* Node - is used to refer to a single location, like [https://www.openstreetmap.org/node/25213337 BP Service];<br />
* (Closed) Way - is used to refer to a building, like [https://www.openstreetmap.org/way/31348922 IKEA];<br />
* Relation - is used to refer multiple ways used by the shop, like [https://www.openstreetmap.org/relation/1235874 Carrefour];<br />
<br />
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. This can be limited to OSM objects that have the tag ''shop''.<br />
<br />
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.<br />
<br />
=== Example Taxonomy Entry===<br />
An example for an entry / location / store / shop in the taxonomy:<br><br />
<nowiki>store_brand:en: en:Biocoop</nowiki><br><br />
<nowiki>price_id:en: 45</nowiki><br><br />
<nowiki>osm_id:en: 9815975601</nowiki><br><br />
<nowiki>osm_type:en: NODE</nowiki><br><br />
<nowiki>osm_display_name:en: en:"Biocoop, Rue de Tolbiac, Quartier de la Maison-Blanche, Paris 13e Arrondissement, Paris, Île-de-France, France métropolitaine, 75013, France"</nowiki><br><br />
<nowiki>osm_address_postcode:en: 75013</nowiki><br><br />
<nowiki>osm_address_city:en: en:Paris</nowiki><br><br />
<nowiki>osm_address_country:en: en:france</nowiki><br><br />
<nowiki>osm_lat:en: 48.8259597</nowiki><br><br />
<nowiki>osm_lon:en: 2.3511541</nowiki><br><br />
== Store brand entries ==<br />
The current implementation of OFF already supports a field for Stores. It is a free text field where the user can enter whatever s/he wants. A variety of entries is the consequence. But most of all it is used to enter the value for the Store brand, i.e. the name of the store as is shown outside the store and on receipts.<br />
<br />
Note that this can also be imported from OSM by means of the receipts. On OSM it is indicated with the tag ''brand''.<br />
<br />
OSM also indicates a link to wikidata (for instance [https://www.wikidata.org/wiki/Q151954 Lidl]).<br />
<br />
There are also ideas how to kickstart a list of store brands from external sources.<br />
<br />
== Lifecycle ==<br />
The lifecycle for the two taxonomies is related, so they will be discussed together.<br />
=== Kickstart ===<br />
The kickstart describes the initial, very first introduction of the taxonomies.<br />
==== Store brands ====<br />
The store brands taxonomy could be started with the current entries in the Stores field. Unfortunately the quality of these current entries seems rather low. It is preferred to start with a high quality list pulled in from external sources, like all [https://www.wikidata.org/wiki/Q18043413 supermarket] chains listed on Wikidata.<br />
<br />
As a subsequent step all existing entries could be mapped to this store brands taxonomy.<br />
<br />
==== Stores ====<br />
The stores taxonomy can initially be pulled from OFF Prices. The data only needs to be formatted in the correct way. The stores information provided by OFF Prices will then be used as a starting point.<br />
<br />
=== Maintenance ===<br />
==== Editing ====<br />
Editing involves changing existing items in the taxonomies.<br />
==== Extending ====<br />
Extending involves adding new items to the taxonomies.<br />
The stores taxonomy needs to be regularly updated from the data entered through [https://prices.openfoodfacts.org/ OFF Prices]. This means any changed values and any added entries/<br />
<br />
== Spinoff ==<br />
Information on stores, operators and owners is not the main goal of OFF. OFF prefers that this is maintained by more specialised other parties. However OFF does gather this information through receipts for instance. Users are encouraged to add this kind of information to OpenStreetMap or wikidata.<br />
<br />
== Use cases ==<br />
=== OFF Prices ===<br />
To have the prices of products for individual stores and brands.<br />
<br />
== Discussion points ==<br />
<br />
* What information should be stored by OFF and what can be left to OSM or Wikidata? <br />
* What to be done with shops that go out of business?<br />
<br />
== Note ==<br />
* We need to associate stores with brands that are sold in thoses stores (Auchan for Auchan…)<br />
* We should try to add Wikidata relations (and thus OSM ones) whenever possible<br />
* Chains - if a store is part of a chain with multiple stores it can be added through a wikidata link<br />
<br />
Moved to GitHub: https://github.com/openfoodfacts/openfoodfacts-server/blob/master/taxonomies/stores.txt</div>Aleenehttps://wiki.openfoodfacts.org/index.php?title=File:Example_receipt_heading.png&diff=20658File:Example receipt heading.png2024-03-07T10:04:16Z<p>Aleene: </p>
<hr />
<div>Example receipt heading</div>Aleenehttps://wiki.openfoodfacts.org/index.php?title=Global_stores_taxonomy&diff=20657Global stores taxonomy2024-03-07T09:07:09Z<p>Aleene: /* Use cases */</p>
<hr />
<div>See [[Global taxonomies]] for instructions.<br />
[[Category:Global_Taxonomies]]<br />
== Introduction ==<br />
The stores taxonomy contains a list of locations where products (food products, beauty products, etc.) can be obtained. A related store brands taxonomy describes the brand names (store chains) of the individual stores.<br />
<br />
Most of the data related to these taxonomies is obtained through third parties (Wikidata, OpenStreetMap). The main interest of OFF is the relation between products, stores and brands.<br />
<br />
== Store entries ==<br />
An entry in the taxonomy describes a single location. This taxonomy can combine data pulled from various sources: receipts from prices, osm, wikidata, etc or provided by the user (honour system). OFF should be careful not copy to much data already maintained by other parties. And if data is copied, it is to provide a snapshot in time.<br />
=== Receipts ===<br />
[[File:Receipt example.png|thumb|Example of store information on a receipt]]<br />
The basis could be the receipts that users have added on prices. As all OFF data, any information should be backed up by image proofs. In the case for a store, this could be a receipt. The store information available on the receipt can be extracted to the taxonomy. What can be extracted depends on the receipt. In the example shown here, it is possible to extract the store name, the operator (useful for franchises), the address, phone number, siret, naf and tva. Analysus of more receipts might reveal other country specific information.<br />
Hopefully this information is enough to unambiguously identify a store.<br />
<br />
=== Prices ===<br />
The stores taxonomy can be based on [https://prices.openfoodfacts.org/ OFF Prices]. The receipts corresponding to a shop are entered on Prices. Prices has a unique identifier for each shop, which should be used as a linking pin. In addition Prices offers a link with Openstreetmap, which can be used to pull in additional information. Some of this information is already cached by Prices.<br />
=== Open Street Map ===<br />
All stores are linked to [https://www.openstreetmap.org/ Open Street Map] (OSM) through the unique OSM id. The link refers to a basic object in OSM:<br />
* Node - is used to refer to a single location, like [https://www.openstreetmap.org/node/25213337 BP Service];<br />
* (Closed) Way - is used to refer to a building, like [https://www.openstreetmap.org/way/31348922 IKEA];<br />
* Relation - is used to refer multiple ways used by the shop, like [https://www.openstreetmap.org/relation/1235874 Carrefour];<br />
<br />
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. This can be limited to OSM objects that have the tag ''shop''.<br />
<br />
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.<br />
<br />
=== Example Taxonomy Entry===<br />
An example for an entry / location / store / shop in the taxonomy:<br><br />
<nowiki>store_brand:en: en:Biocoop</nowiki><br><br />
<nowiki>price_id:en: 45</nowiki><br><br />
<nowiki>osm_id:en: 9815975601</nowiki><br><br />
<nowiki>osm_type:en: NODE</nowiki><br><br />
<nowiki>osm_display_name:en: en:"Biocoop, Rue de Tolbiac, Quartier de la Maison-Blanche, Paris 13e Arrondissement, Paris, Île-de-France, France métropolitaine, 75013, France"</nowiki><br><br />
<nowiki>osm_address_postcode:en: 75013</nowiki><br><br />
<nowiki>osm_address_city:en: en:Paris</nowiki><br><br />
<nowiki>osm_address_country:en: en:france</nowiki><br><br />
<nowiki>osm_lat:en: 48.8259597</nowiki><br><br />
<nowiki>osm_lon:en: 2.3511541</nowiki><br><br />
== Store brand entries ==<br />
The current implementation of OFF already supports a field for Stores. It is a free text field where the user can enter whatever s/he wants. A variety of entries is the consequence. But most of all it is used to enter the value for the Store brand, i.e. the name of the store as is shown outside the store and on receipts.<br />
<br />
Note that this can also be imported from OSM by means of the receipts. On OSM it is indicated with the tag ''brand''.<br />
<br />
OSM also indicates a link to wikidata (for instance [https://www.wikidata.org/wiki/Q151954 Lidl]).<br />
<br />
There are also ideas how to kickstart a list of store brands from external sources.<br />
<br />
== Lifecycle ==<br />
The lifecycle for the two taxonomies is related, so they will be discussed together.<br />
=== Kickstart ===<br />
The kickstart describes the initial, very first introduction of the taxonomies.<br />
==== Store brands ====<br />
The store brands taxonomy could be started with the current entries in the Stores field. Unfortunately the quality of these current entries seems rather low. It is preferred to start with a high quality list pulled in from external sources, like all [https://www.wikidata.org/wiki/Q18043413 supermarket] chains listed on Wikidata.<br />
<br />
As a subsequent step all existing entries could be mapped to this store brands taxonomy.<br />
<br />
==== Stores ====<br />
The stores taxonomy can initially be pulled from OFF Prices. The data only needs to be formatted in the correct way. The stores information provided by OFF Prices will then be used as a starting point.<br />
<br />
=== Maintenance ===<br />
==== Editing ====<br />
Editing involves changing existing items in the taxonomies.<br />
==== Extending ====<br />
Extending involves adding new items to the taxonomies.<br />
The stores taxonomy needs to be regularly updated from the data entered through [https://prices.openfoodfacts.org/ OFF Prices]. This means any changed values and any added entries/<br />
<br />
== Spinoff ==<br />
Information on stores, operators and owners is not the main goal of OFF. OFF prefers that this is maintained by more specialised other parties. However OFF does gather this information through receipts for instance. Users are encouraged to add this kind of information to OpenStreetMap or wikidata.<br />
<br />
== Use cases ==<br />
=== OFF Prices ===<br />
To have the prices of products for individual stores and brands.<br />
<br />
== Discussion points ==<br />
<br />
* What information should be stored by OFF and what can be left to OSM or Wikidata? <br />
* What to be done with shops that go out of business?<br />
<br />
== Note ==<br />
* We need to associate stores with brands that are sold in thoses stores (Auchan for Auchan…)<br />
* We should try to add Wikidata relations (and thus OSM ones) whenever possible<br />
* Chains - if a store is part of a chain with multiple stores it can be added through a wikidata link<br />
<br />
Moved to GitHub: https://github.com/openfoodfacts/openfoodfacts-server/blob/master/taxonomies/stores.txt</div>Aleenehttps://wiki.openfoodfacts.org/index.php?title=Global_stores_taxonomy&diff=20656Global stores taxonomy2024-03-07T09:06:00Z<p>Aleene: /* Store brand entries */</p>
<hr />
<div>See [[Global taxonomies]] for instructions.<br />
[[Category:Global_Taxonomies]]<br />
== Introduction ==<br />
The stores taxonomy contains a list of locations where products (food products, beauty products, etc.) can be obtained. A related store brands taxonomy describes the brand names (store chains) of the individual stores.<br />
<br />
Most of the data related to these taxonomies is obtained through third parties (Wikidata, OpenStreetMap). The main interest of OFF is the relation between products, stores and brands.<br />
<br />
== Store entries ==<br />
An entry in the taxonomy describes a single location. This taxonomy can combine data pulled from various sources: receipts from prices, osm, wikidata, etc or provided by the user (honour system). OFF should be careful not copy to much data already maintained by other parties. And if data is copied, it is to provide a snapshot in time.<br />
=== Receipts ===<br />
[[File:Receipt example.png|thumb|Example of store information on a receipt]]<br />
The basis could be the receipts that users have added on prices. As all OFF data, any information should be backed up by image proofs. In the case for a store, this could be a receipt. The store information available on the receipt can be extracted to the taxonomy. What can be extracted depends on the receipt. In the example shown here, it is possible to extract the store name, the operator (useful for franchises), the address, phone number, siret, naf and tva. Analysus of more receipts might reveal other country specific information.<br />
Hopefully this information is enough to unambiguously identify a store.<br />
<br />
=== Prices ===<br />
The stores taxonomy can be based on [https://prices.openfoodfacts.org/ OFF Prices]. The receipts corresponding to a shop are entered on Prices. Prices has a unique identifier for each shop, which should be used as a linking pin. In addition Prices offers a link with Openstreetmap, which can be used to pull in additional information. Some of this information is already cached by Prices.<br />
=== Open Street Map ===<br />
All stores are linked to [https://www.openstreetmap.org/ Open Street Map] (OSM) through the unique OSM id. The link refers to a basic object in OSM:<br />
* Node - is used to refer to a single location, like [https://www.openstreetmap.org/node/25213337 BP Service];<br />
* (Closed) Way - is used to refer to a building, like [https://www.openstreetmap.org/way/31348922 IKEA];<br />
* Relation - is used to refer multiple ways used by the shop, like [https://www.openstreetmap.org/relation/1235874 Carrefour];<br />
<br />
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. This can be limited to OSM objects that have the tag ''shop''.<br />
<br />
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.<br />
<br />
=== Example Taxonomy Entry===<br />
An example for an entry / location / store / shop in the taxonomy:<br><br />
<nowiki>store_brand:en: en:Biocoop</nowiki><br><br />
<nowiki>price_id:en: 45</nowiki><br><br />
<nowiki>osm_id:en: 9815975601</nowiki><br><br />
<nowiki>osm_type:en: NODE</nowiki><br><br />
<nowiki>osm_display_name:en: en:"Biocoop, Rue de Tolbiac, Quartier de la Maison-Blanche, Paris 13e Arrondissement, Paris, Île-de-France, France métropolitaine, 75013, France"</nowiki><br><br />
<nowiki>osm_address_postcode:en: 75013</nowiki><br><br />
<nowiki>osm_address_city:en: en:Paris</nowiki><br><br />
<nowiki>osm_address_country:en: en:france</nowiki><br><br />
<nowiki>osm_lat:en: 48.8259597</nowiki><br><br />
<nowiki>osm_lon:en: 2.3511541</nowiki><br><br />
== Store brand entries ==<br />
The current implementation of OFF already supports a field for Stores. It is a free text field where the user can enter whatever s/he wants. A variety of entries is the consequence. But most of all it is used to enter the value for the Store brand, i.e. the name of the store as is shown outside the store and on receipts.<br />
<br />
Note that this can also be imported from OSM by means of the receipts. On OSM it is indicated with the tag ''brand''.<br />
<br />
OSM also indicates a link to wikidata (for instance [https://www.wikidata.org/wiki/Q151954 Lidl]).<br />
<br />
There are also ideas how to kickstart a list of store brands from external sources.<br />
<br />
== Lifecycle ==<br />
The lifecycle for the two taxonomies is related, so they will be discussed together.<br />
=== Kickstart ===<br />
The kickstart describes the initial, very first introduction of the taxonomies.<br />
==== Store brands ====<br />
The store brands taxonomy could be started with the current entries in the Stores field. Unfortunately the quality of these current entries seems rather low. It is preferred to start with a high quality list pulled in from external sources, like all [https://www.wikidata.org/wiki/Q18043413 supermarket] chains listed on Wikidata.<br />
<br />
As a subsequent step all existing entries could be mapped to this store brands taxonomy.<br />
<br />
==== Stores ====<br />
The stores taxonomy can initially be pulled from OFF Prices. The data only needs to be formatted in the correct way. The stores information provided by OFF Prices will then be used as a starting point.<br />
<br />
=== Maintenance ===<br />
==== Editing ====<br />
Editing involves changing existing items in the taxonomies.<br />
==== Extending ====<br />
Extending involves adding new items to the taxonomies.<br />
The stores taxonomy needs to be regularly updated from the data entered through [https://prices.openfoodfacts.org/ OFF Prices]. This means any changed values and any added entries/<br />
<br />
== Spinoff ==<br />
Information on stores, operators and owners is not the main goal of OFF. OFF prefers that this is maintained by more specialised other parties. However OFF does gather this information through receipts for instance. Users are encouraged to add this kind of information to OpenStreetMap or wikidata.<br />
<br />
== Use cases ==<br />
<br />
== Discussion points ==<br />
<br />
* What information should be stored by OFF and what can be left to OSM or Wikidata? <br />
* What to be done with shops that go out of business?<br />
<br />
== Note ==<br />
* We need to associate stores with brands that are sold in thoses stores (Auchan for Auchan…)<br />
* We should try to add Wikidata relations (and thus OSM ones) whenever possible<br />
* Chains - if a store is part of a chain with multiple stores it can be added through a wikidata link<br />
<br />
Moved to GitHub: https://github.com/openfoodfacts/openfoodfacts-server/blob/master/taxonomies/stores.txt</div>Aleenehttps://wiki.openfoodfacts.org/index.php?title=Global_stores_taxonomy&diff=20655Global stores taxonomy2024-03-07T09:05:49Z<p>Aleene: /* Store brand */</p>
<hr />
<div>See [[Global taxonomies]] for instructions.<br />
[[Category:Global_Taxonomies]]<br />
== Introduction ==<br />
The stores taxonomy contains a list of locations where products (food products, beauty products, etc.) can be obtained. A related store brands taxonomy describes the brand names (store chains) of the individual stores.<br />
<br />
Most of the data related to these taxonomies is obtained through third parties (Wikidata, OpenStreetMap). The main interest of OFF is the relation between products, stores and brands.<br />
<br />
== Store entries ==<br />
An entry in the taxonomy describes a single location. This taxonomy can combine data pulled from various sources: receipts from prices, osm, wikidata, etc or provided by the user (honour system). OFF should be careful not copy to much data already maintained by other parties. And if data is copied, it is to provide a snapshot in time.<br />
=== Receipts ===<br />
[[File:Receipt example.png|thumb|Example of store information on a receipt]]<br />
The basis could be the receipts that users have added on prices. As all OFF data, any information should be backed up by image proofs. In the case for a store, this could be a receipt. The store information available on the receipt can be extracted to the taxonomy. What can be extracted depends on the receipt. In the example shown here, it is possible to extract the store name, the operator (useful for franchises), the address, phone number, siret, naf and tva. Analysus of more receipts might reveal other country specific information.<br />
Hopefully this information is enough to unambiguously identify a store.<br />
<br />
=== Prices ===<br />
The stores taxonomy can be based on [https://prices.openfoodfacts.org/ OFF Prices]. The receipts corresponding to a shop are entered on Prices. Prices has a unique identifier for each shop, which should be used as a linking pin. In addition Prices offers a link with Openstreetmap, which can be used to pull in additional information. Some of this information is already cached by Prices.<br />
=== Open Street Map ===<br />
All stores are linked to [https://www.openstreetmap.org/ Open Street Map] (OSM) through the unique OSM id. The link refers to a basic object in OSM:<br />
* Node - is used to refer to a single location, like [https://www.openstreetmap.org/node/25213337 BP Service];<br />
* (Closed) Way - is used to refer to a building, like [https://www.openstreetmap.org/way/31348922 IKEA];<br />
* Relation - is used to refer multiple ways used by the shop, like [https://www.openstreetmap.org/relation/1235874 Carrefour];<br />
<br />
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. This can be limited to OSM objects that have the tag ''shop''.<br />
<br />
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.<br />
<br />
=== Example Taxonomy Entry===<br />
An example for an entry / location / store / shop in the taxonomy:<br><br />
<nowiki>store_brand:en: en:Biocoop</nowiki><br><br />
<nowiki>price_id:en: 45</nowiki><br><br />
<nowiki>osm_id:en: 9815975601</nowiki><br><br />
<nowiki>osm_type:en: NODE</nowiki><br><br />
<nowiki>osm_display_name:en: en:"Biocoop, Rue de Tolbiac, Quartier de la Maison-Blanche, Paris 13e Arrondissement, Paris, Île-de-France, France métropolitaine, 75013, France"</nowiki><br><br />
<nowiki>osm_address_postcode:en: 75013</nowiki><br><br />
<nowiki>osm_address_city:en: en:Paris</nowiki><br><br />
<nowiki>osm_address_country:en: en:france</nowiki><br><br />
<nowiki>osm_lat:en: 48.8259597</nowiki><br><br />
<nowiki>osm_lon:en: 2.3511541</nowiki><br><br />
== Store brand entries ==<br />
<br />
== Lifecycle ==<br />
The lifecycle for the two taxonomies is related, so they will be discussed together.<br />
=== Kickstart ===<br />
The kickstart describes the initial, very first introduction of the taxonomies.<br />
==== Store brands ====<br />
The store brands taxonomy could be started with the current entries in the Stores field. Unfortunately the quality of these current entries seems rather low. It is preferred to start with a high quality list pulled in from external sources, like all [https://www.wikidata.org/wiki/Q18043413 supermarket] chains listed on Wikidata.<br />
<br />
As a subsequent step all existing entries could be mapped to this store brands taxonomy.<br />
<br />
==== Stores ====<br />
The stores taxonomy can initially be pulled from OFF Prices. The data only needs to be formatted in the correct way. The stores information provided by OFF Prices will then be used as a starting point.<br />
<br />
=== Maintenance ===<br />
==== Editing ====<br />
Editing involves changing existing items in the taxonomies.<br />
==== Extending ====<br />
Extending involves adding new items to the taxonomies.<br />
The stores taxonomy needs to be regularly updated from the data entered through [https://prices.openfoodfacts.org/ OFF Prices]. This means any changed values and any added entries/<br />
<br />
== Spinoff ==<br />
Information on stores, operators and owners is not the main goal of OFF. OFF prefers that this is maintained by more specialised other parties. However OFF does gather this information through receipts for instance. Users are encouraged to add this kind of information to OpenStreetMap or wikidata.<br />
<br />
== Use cases ==<br />
<br />
== Discussion points ==<br />
<br />
* What information should be stored by OFF and what can be left to OSM or Wikidata? <br />
* What to be done with shops that go out of business?<br />
<br />
== Note ==<br />
* We need to associate stores with brands that are sold in thoses stores (Auchan for Auchan…)<br />
* We should try to add Wikidata relations (and thus OSM ones) whenever possible<br />
* Chains - if a store is part of a chain with multiple stores it can be added through a wikidata link<br />
<br />
Moved to GitHub: https://github.com/openfoodfacts/openfoodfacts-server/blob/master/taxonomies/stores.txt</div>Aleenehttps://wiki.openfoodfacts.org/index.php?title=Global_stores_taxonomy&diff=20654Global stores taxonomy2024-03-07T09:05:16Z<p>Aleene: /* Store entries */</p>
<hr />
<div>See [[Global taxonomies]] for instructions.<br />
[[Category:Global_Taxonomies]]<br />
== Introduction ==<br />
The stores taxonomy contains a list of locations where products (food products, beauty products, etc.) can be obtained. A related store brands taxonomy describes the brand names (store chains) of the individual stores.<br />
<br />
Most of the data related to these taxonomies is obtained through third parties (Wikidata, OpenStreetMap). The main interest of OFF is the relation between products, stores and brands.<br />
<br />
== Store entries ==<br />
An entry in the taxonomy describes a single location. This taxonomy can combine data pulled from various sources: receipts from prices, osm, wikidata, etc or provided by the user (honour system). OFF should be careful not copy to much data already maintained by other parties. And if data is copied, it is to provide a snapshot in time.<br />
=== Receipts ===<br />
[[File:Receipt example.png|thumb|Example of store information on a receipt]]<br />
The basis could be the receipts that users have added on prices. As all OFF data, any information should be backed up by image proofs. In the case for a store, this could be a receipt. The store information available on the receipt can be extracted to the taxonomy. What can be extracted depends on the receipt. In the example shown here, it is possible to extract the store name, the operator (useful for franchises), the address, phone number, siret, naf and tva. Analysus of more receipts might reveal other country specific information.<br />
Hopefully this information is enough to unambiguously identify a store.<br />
<br />
=== Prices ===<br />
The stores taxonomy can be based on [https://prices.openfoodfacts.org/ OFF Prices]. The receipts corresponding to a shop are entered on Prices. Prices has a unique identifier for each shop, which should be used as a linking pin. In addition Prices offers a link with Openstreetmap, which can be used to pull in additional information. Some of this information is already cached by Prices.<br />
=== Open Street Map ===<br />
All stores are linked to [https://www.openstreetmap.org/ Open Street Map] (OSM) through the unique OSM id. The link refers to a basic object in OSM:<br />
* Node - is used to refer to a single location, like [https://www.openstreetmap.org/node/25213337 BP Service];<br />
* (Closed) Way - is used to refer to a building, like [https://www.openstreetmap.org/way/31348922 IKEA];<br />
* Relation - is used to refer multiple ways used by the shop, like [https://www.openstreetmap.org/relation/1235874 Carrefour];<br />
<br />
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. This can be limited to OSM objects that have the tag ''shop''.<br />
<br />
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.<br />
<br />
=== Store brand ===<br />
The current implementation of OFF already supports a field for Stores. It is a free text field where the user can enter whatever s/he wants. A variety of entries is the consequence. But most of all it is used to enter the value for the Store brand, i.e. the name of the store as is shown outside the store and on receipts.<br />
<br />
Note that this can also be imported from OSM by means of the receipts. On OSM it is indicated with the tag ''brand''.<br />
<br />
OSM also indicates a link to wikidata (for instance [https://www.wikidata.org/wiki/Q151954 Lidl]).<br />
<br />
There are also ideas how to kickstart a list of store brands from external sources.<br />
<br />
=== Example Taxonomy Entry===<br />
An example for an entry / location / store / shop in the taxonomy:<br><br />
<nowiki>store_brand:en: en:Biocoop</nowiki><br><br />
<nowiki>price_id:en: 45</nowiki><br><br />
<nowiki>osm_id:en: 9815975601</nowiki><br><br />
<nowiki>osm_type:en: NODE</nowiki><br><br />
<nowiki>osm_display_name:en: en:"Biocoop, Rue de Tolbiac, Quartier de la Maison-Blanche, Paris 13e Arrondissement, Paris, Île-de-France, France métropolitaine, 75013, France"</nowiki><br><br />
<nowiki>osm_address_postcode:en: 75013</nowiki><br><br />
<nowiki>osm_address_city:en: en:Paris</nowiki><br><br />
<nowiki>osm_address_country:en: en:france</nowiki><br><br />
<nowiki>osm_lat:en: 48.8259597</nowiki><br><br />
<nowiki>osm_lon:en: 2.3511541</nowiki><br><br />
== Store brand entries ==<br />
<br />
== Lifecycle ==<br />
The lifecycle for the two taxonomies is related, so they will be discussed together.<br />
=== Kickstart ===<br />
The kickstart describes the initial, very first introduction of the taxonomies.<br />
==== Store brands ====<br />
The store brands taxonomy could be started with the current entries in the Stores field. Unfortunately the quality of these current entries seems rather low. It is preferred to start with a high quality list pulled in from external sources, like all [https://www.wikidata.org/wiki/Q18043413 supermarket] chains listed on Wikidata.<br />
<br />
As a subsequent step all existing entries could be mapped to this store brands taxonomy.<br />
<br />
==== Stores ====<br />
The stores taxonomy can initially be pulled from OFF Prices. The data only needs to be formatted in the correct way. The stores information provided by OFF Prices will then be used as a starting point.<br />
<br />
=== Maintenance ===<br />
==== Editing ====<br />
Editing involves changing existing items in the taxonomies.<br />
==== Extending ====<br />
Extending involves adding new items to the taxonomies.<br />
The stores taxonomy needs to be regularly updated from the data entered through [https://prices.openfoodfacts.org/ OFF Prices]. This means any changed values and any added entries/<br />
<br />
== Spinoff ==<br />
Information on stores, operators and owners is not the main goal of OFF. OFF prefers that this is maintained by more specialised other parties. However OFF does gather this information through receipts for instance. Users are encouraged to add this kind of information to OpenStreetMap or wikidata.<br />
<br />
== Use cases ==<br />
<br />
== Discussion points ==<br />
<br />
* What information should be stored by OFF and what can be left to OSM or Wikidata? <br />
* What to be done with shops that go out of business?<br />
<br />
== Note ==<br />
* We need to associate stores with brands that are sold in thoses stores (Auchan for Auchan…)<br />
* We should try to add Wikidata relations (and thus OSM ones) whenever possible<br />
* Chains - if a store is part of a chain with multiple stores it can be added through a wikidata link<br />
<br />
Moved to GitHub: https://github.com/openfoodfacts/openfoodfacts-server/blob/master/taxonomies/stores.txt</div>Aleenehttps://wiki.openfoodfacts.org/index.php?title=Global_stores_taxonomy&diff=20653Global stores taxonomy2024-03-07T09:04:22Z<p>Aleene: /* Stores */</p>
<hr />
<div>See [[Global taxonomies]] for instructions.<br />
[[Category:Global_Taxonomies]]<br />
== Introduction ==<br />
The stores taxonomy contains a list of locations where products (food products, beauty products, etc.) can be obtained. A related store brands taxonomy describes the brand names (store chains) of the individual stores.<br />
<br />
Most of the data related to these taxonomies is obtained through third parties (Wikidata, OpenStreetMap). The main interest of OFF is the relation between products, stores and brands.<br />
<br />
== Store entries ==<br />
An entry in the taxonomy describes a single location. This taxonomy can combine data pulled from various sources: receipts from prices, osm, wikidata, etc or provided by the user (honour system). OFF should be careful not copy to much data already maintained by other parties. And if data is copied, it is to provide a snapshot in time.<br />
=== Receipts ===<br />
[[File:Receipt example.png|thumb|Example of store information on a receipt]]<br />
The basis could be the receipts that users have added on prices. As all OFF data, any information should be backed up by image proofs. In the case for a store, this could be a receipt. The store information available on the receipt can be extracted to the taxonomy. What can be extracted depends on the receipt. In the example shown here, it is possible to extract the store name, the operator (useful for franchises), the address, phone number, siret, naf and tva. Analysus of more receipts might reveal other country specific information.<br />
Hopefully this information is enough to unambiguously identify a store.<br />
<br />
=== Prices ===<br />
The stores taxonomy can be based on [https://prices.openfoodfacts.org/ OFF Prices]. The receipts corresponding to a shop are entered on Prices. Prices has a unique identifier for each shop, which should be used as a linking pin. In addition Prices offers a link with Openstreetmap, which can be used to pull in additional information. Some of this information is already cached by Prices.<br />
=== Open Street Map ===<br />
All stores are linked to [https://www.openstreetmap.org/ Open Street Map] (OSM) through the unique OSM id. The link refers to a basic object in OSM:<br />
* Node - is used to refer to a single location, like [https://www.openstreetmap.org/node/25213337 BP Service];<br />
* (Closed) Way - is used to refer to a building, like [https://www.openstreetmap.org/way/31348922 IKEA];<br />
* Relation - is used to refer multiple ways used by the shop, like [https://www.openstreetmap.org/relation/1235874 Carrefour];<br />
<br />
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. This can be limited to OSM objects that have the tag ''shop''.<br />
<br />
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.<br />
<br />
=== Store brand ===<br />
The current implementation of OFF already supports a field for Stores. It is a free text field where the user can enter whatever s/he wants. A variety of entries is the consequence. But most of all it is used to enter the value for the Store brand, i.e. the name of the store as is shown outside the store and on receipts.<br />
<br />
Note that this can also be imported from OSM by means of the receipts. On OSM it is indicated with the tag ''brand''.<br />
<br />
OSM also indicates a link to wikidata (for instance [https://www.wikidata.org/wiki/Q151954 Lidl]).<br />
<br />
There are also ideas how to kickstart a list of store brands from external sources.<br />
<br />
=== Example Taxonomy Entry===<br />
An example for an entry / location / store / shop in the taxonomy:<br><br />
<nowiki>store_brand:en: en:Biocoop</nowiki><br><br />
<nowiki>price_id:en: 45</nowiki><br><br />
<nowiki>osm_id:en: 9815975601</nowiki><br><br />
<nowiki>osm_type:en: NODE</nowiki><br><br />
<nowiki>osm_display_name:en: en:"Biocoop, Rue de Tolbiac, Quartier de la Maison-Blanche, Paris 13e Arrondissement, Paris, Île-de-France, France métropolitaine, 75013, France"</nowiki><br><br />
<nowiki>osm_address_postcode:en: 75013</nowiki><br><br />
<nowiki>osm_address_city:en: en:Paris</nowiki><br><br />
<nowiki>osm_address_country:en: en:france</nowiki><br><br />
<nowiki>osm_lat:en: 48.8259597</nowiki><br><br />
<nowiki>osm_lon:en: 2.3511541</nowiki><br><br />
<br />
== Lifecycle ==<br />
The lifecycle for the two taxonomies is related, so they will be discussed together.<br />
=== Kickstart ===<br />
The kickstart describes the initial, very first introduction of the taxonomies.<br />
==== Store brands ====<br />
The store brands taxonomy could be started with the current entries in the Stores field. Unfortunately the quality of these current entries seems rather low. It is preferred to start with a high quality list pulled in from external sources, like all [https://www.wikidata.org/wiki/Q18043413 supermarket] chains listed on Wikidata.<br />
<br />
As a subsequent step all existing entries could be mapped to this store brands taxonomy.<br />
<br />
==== Stores ====<br />
The stores taxonomy can initially be pulled from OFF Prices. The data only needs to be formatted in the correct way. The stores information provided by OFF Prices will then be used as a starting point.<br />
<br />
=== Maintenance ===<br />
==== Editing ====<br />
Editing involves changing existing items in the taxonomies.<br />
==== Extending ====<br />
Extending involves adding new items to the taxonomies.<br />
The stores taxonomy needs to be regularly updated from the data entered through [https://prices.openfoodfacts.org/ OFF Prices]. This means any changed values and any added entries/<br />
<br />
== Spinoff ==<br />
Information on stores, operators and owners is not the main goal of OFF. OFF prefers that this is maintained by more specialised other parties. However OFF does gather this information through receipts for instance. Users are encouraged to add this kind of information to OpenStreetMap or wikidata.<br />
<br />
== Use cases ==<br />
<br />
== Discussion points ==<br />
<br />
* What information should be stored by OFF and what can be left to OSM or Wikidata? <br />
* What to be done with shops that go out of business?<br />
<br />
== Note ==<br />
* We need to associate stores with brands that are sold in thoses stores (Auchan for Auchan…)<br />
* We should try to add Wikidata relations (and thus OSM ones) whenever possible<br />
* Chains - if a store is part of a chain with multiple stores it can be added through a wikidata link<br />
<br />
Moved to GitHub: https://github.com/openfoodfacts/openfoodfacts-server/blob/master/taxonomies/stores.txt</div>Aleenehttps://wiki.openfoodfacts.org/index.php?title=Global_stores_taxonomy&diff=20652Global stores taxonomy2024-03-07T09:00:14Z<p>Aleene: /* Stores */</p>
<hr />
<div>See [[Global taxonomies]] for instructions.<br />
[[Category:Global_Taxonomies]]<br />
== Introduction ==<br />
The stores taxonomy contains a list of locations where products (food products, beauty products, etc.) can be obtained. A related store brands taxonomy describes the brand names (store chains) of the individual stores.<br />
<br />
Most of the data related to these taxonomies is obtained through third parties (Wikidata, OpenStreetMap). The main interest of OFF is the relation between products, stores and brands.<br />
<br />
== Store entries ==<br />
An entry in the taxonomy describes a single location. This taxonomy can combine data pulled from various sources: receipts from prices, osm, wikidata, etc or provided by the user (honour system). OFF should be careful not copy to much data already maintained by other parties. And if data is copied, it is to provide a snapshot in time.<br />
=== Receipts ===<br />
[[File:Receipt example.png|thumb|Example of store information on a receipt]]<br />
The basis could be the receipts that users have added on prices. As all OFF data, any information should be backed up by image proofs. In the case for a store, this could be a receipt. The store information available on the receipt can be extracted to the taxonomy. What can be extracted depends on the receipt. In the example shown here, it is possible to extract the store name, the operator (useful for franchises), the address, phone number, siret, naf and tva. Analysus of more receipts might reveal other country specific information.<br />
Hopefully this information is enough to unambiguously identify a store.<br />
<br />
=== Prices ===<br />
The stores taxonomy can be based on [https://prices.openfoodfacts.org/ OFF Prices]. The receipts corresponding to a shop are entered on Prices. Prices has a unique identifier for each shop, which should be used as a linking pin. In addition Prices offers a link with Openstreetmap, which can be used to pull in additional information. Some of this information is already cached by Prices.<br />
=== Open Street Map ===<br />
All stores are linked to [https://www.openstreetmap.org/ Open Street Map] (OSM) through the unique OSM id. The link refers to a basic object in OSM:<br />
* Node - is used to refer to a single location, like [https://www.openstreetmap.org/node/25213337 BP Service];<br />
* (Closed) Way - is used to refer to a building, like [https://www.openstreetmap.org/way/31348922 IKEA];<br />
* Relation - is used to refer multiple ways used by the shop, like [https://www.openstreetmap.org/relation/1235874 Carrefour];<br />
<br />
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. This can be limited to OSM objects that have the tag ''shop''.<br />
<br />
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.<br />
<br />
=== Store brand ===<br />
The current implementation of OFF already supports a field for Stores. It is a free text field where the user can enter whatever s/he wants. A variety of entries is the consequence. But most of all it is used to enter the value for the Store brand, i.e. the name of the store as is shown outside the store and on receipts.<br />
<br />
Note that this can also be imported from OSM by means of the receipts. On OSM it is indicated with the tag ''brand''.<br />
<br />
OSM also indicates a link to wikidata (for instance [https://www.wikidata.org/wiki/Q151954 Lidl]).<br />
<br />
There are also ideas how to kickstart a list of store brands from external sources.<br />
<br />
=== Example Taxonomy Entry===<br />
An example for an entry / location / store / shop in the taxonomy:<br><br />
<nowiki>store_brand:en: en:Biocoop</nowiki><br><br />
<nowiki>price_id:en: 45</nowiki><br><br />
<nowiki>osm_id:en: 9815975601</nowiki><br><br />
<nowiki>osm_type:en: NODE</nowiki><br><br />
<nowiki>osm_display_name:en: en:"Biocoop, Rue de Tolbiac, Quartier de la Maison-Blanche, Paris 13e Arrondissement, Paris, Île-de-France, France métropolitaine, 75013, France"</nowiki><br><br />
<nowiki>osm_address_postcode:en: 75013</nowiki><br><br />
<nowiki>osm_address_city:en: en:Paris</nowiki><br><br />
<nowiki>osm_address_country:en: en:france</nowiki><br><br />
<nowiki>osm_lat:en: 48.8259597</nowiki><br><br />
<nowiki>osm_lon:en: 2.3511541</nowiki><br><br />
<br />
== Lifecycle ==<br />
The lifecycle for the two taxonomies is related, so they will be discussed together.<br />
=== Kickstart ===<br />
The kickstart describes the initial, very first introduction of the taxonomies.<br />
==== Store brands ====<br />
The store brands taxonomy could be started with the current entries in the Stores field. Unfortunately the quality of these current entries seems rather low. It is preferred to start with a high quality list pulled in from external sources, like all [https://www.wikidata.org/wiki/Q18043413 supermarket] chains listed on Wikidata.<br />
<br />
As a subsequent step all existing entries could be mapped to this store brands taxonomy.<br />
<br />
==== Stores ====<br />
The stores taxonomy can initially be pulled from OFF Prices. The data only needs to be formatted in the correct way.<br />
<br />
=== Maintenance ===<br />
==== Editing ====<br />
Editing involves changing existing items in the taxonomies.<br />
==== Extending ====<br />
Extending involves adding new items to the taxonomies.<br />
The stores taxonomy needs to be regularly updated from the data entered through [https://prices.openfoodfacts.org/ OFF Prices]. This means any changed values and any added entries/<br />
<br />
== Spinoff ==<br />
Information on stores, operators and owners is not the main goal of OFF. OFF prefers that this is maintained by more specialised other parties. However OFF does gather this information through receipts for instance. Users are encouraged to add this kind of information to OpenStreetMap or wikidata.<br />
<br />
== Use cases ==<br />
<br />
== Discussion points ==<br />
<br />
* What information should be stored by OFF and what can be left to OSM or Wikidata? <br />
* What to be done with shops that go out of business?<br />
<br />
== Note ==<br />
* We need to associate stores with brands that are sold in thoses stores (Auchan for Auchan…)<br />
* We should try to add Wikidata relations (and thus OSM ones) whenever possible<br />
* Chains - if a store is part of a chain with multiple stores it can be added through a wikidata link<br />
<br />
Moved to GitHub: https://github.com/openfoodfacts/openfoodfacts-server/blob/master/taxonomies/stores.txt</div>Aleenehttps://wiki.openfoodfacts.org/index.php?title=Global_stores_taxonomy&diff=20651Global stores taxonomy2024-03-07T08:58:29Z<p>Aleene: /* Example Taxonomy Entry */</p>
<hr />
<div>See [[Global taxonomies]] for instructions.<br />
[[Category:Global_Taxonomies]]<br />
== Introduction ==<br />
The stores taxonomy contains a list of locations where products (food products, beauty products, etc.) can be obtained. A related store brands taxonomy describes the brand names (store chains) of the individual stores.<br />
<br />
Most of the data related to these taxonomies is obtained through third parties (Wikidata, OpenStreetMap). The main interest of OFF is the relation between products, stores and brands.<br />
<br />
== Store entries ==<br />
An entry in the taxonomy describes a single location. This taxonomy can combine data pulled from various sources: receipts from prices, osm, wikidata, etc or provided by the user (honour system). OFF should be careful not copy to much data already maintained by other parties. And if data is copied, it is to provide a snapshot in time.<br />
=== Receipts ===<br />
[[File:Receipt example.png|thumb|Example of store information on a receipt]]<br />
The basis could be the receipts that users have added on prices. As all OFF data, any information should be backed up by image proofs. In the case for a store, this could be a receipt. The store information available on the receipt can be extracted to the taxonomy. What can be extracted depends on the receipt. In the example shown here, it is possible to extract the store name, the operator (useful for franchises), the address, phone number, siret, naf and tva. Analysus of more receipts might reveal other country specific information.<br />
Hopefully this information is enough to unambiguously identify a store.<br />
<br />
=== Prices ===<br />
The stores taxonomy can be based on [https://prices.openfoodfacts.org/ OFF Prices]. The receipts corresponding to a shop are entered on Prices. Prices has a unique identifier for each shop, which should be used as a linking pin. In addition Prices offers a link with Openstreetmap, which can be used to pull in additional information. Some of this information is already cached by Prices.<br />
=== Open Street Map ===<br />
All stores are linked to [https://www.openstreetmap.org/ Open Street Map] (OSM) through the unique OSM id. The link refers to a basic object in OSM:<br />
* Node - is used to refer to a single location, like [https://www.openstreetmap.org/node/25213337 BP Service];<br />
* (Closed) Way - is used to refer to a building, like [https://www.openstreetmap.org/way/31348922 IKEA];<br />
* Relation - is used to refer multiple ways used by the shop, like [https://www.openstreetmap.org/relation/1235874 Carrefour];<br />
<br />
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. This can be limited to OSM objects that have the tag ''shop''.<br />
<br />
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.<br />
<br />
=== Store brand ===<br />
The current implementation of OFF already supports a field for Stores. It is a free text field where the user can enter whatever s/he wants. A variety of entries is the consequence. But most of all it is used to enter the value for the Store brand, i.e. the name of the store as is shown outside the store and on receipts.<br />
<br />
Note that this can also be imported from OSM by means of the receipts. On OSM it is indicated with the tag ''brand''.<br />
<br />
OSM also indicates a link to wikidata (for instance [https://www.wikidata.org/wiki/Q151954 Lidl]).<br />
<br />
There are also ideas how to kickstart a list of store brands from external sources.<br />
<br />
=== Example Taxonomy Entry===<br />
An example for an entry / location / store / shop in the taxonomy:<br><br />
<nowiki>store_brand:en: en:Biocoop</nowiki><br><br />
<nowiki>price_id:en: 45</nowiki><br><br />
<nowiki>osm_id:en: 9815975601</nowiki><br><br />
<nowiki>osm_type:en: NODE</nowiki><br><br />
<nowiki>osm_display_name:en: en:"Biocoop, Rue de Tolbiac, Quartier de la Maison-Blanche, Paris 13e Arrondissement, Paris, Île-de-France, France métropolitaine, 75013, France"</nowiki><br><br />
<nowiki>osm_address_postcode:en: 75013</nowiki><br><br />
<nowiki>osm_address_city:en: en:Paris</nowiki><br><br />
<nowiki>osm_address_country:en: en:france</nowiki><br><br />
<nowiki>osm_lat:en: 48.8259597</nowiki><br><br />
<nowiki>osm_lon:en: 2.3511541</nowiki><br><br />
<br />
== Lifecycle ==<br />
The lifecycle for the two taxonomies is related, so they will be discussed together.<br />
=== Kickstart ===<br />
The kickstart describes the initial, very first introduction of the taxonomies.<br />
==== Store brands ====<br />
The store brands taxonomy could be started with the current entries in the Stores field. Unfortunately the quality of these current entries seems rather low. It is preferred to start with a high quality list pulled in from external sources, like all [https://www.wikidata.org/wiki/Q18043413 supermarket] chains listed on Wikidata.<br />
<br />
As a subsequent step all existing entries could be mapped to this store brands taxonomy.<br />
<br />
==== Stores ====<br />
From Prices.<br />
=== Maintenance ===<br />
==== Editing ====<br />
Editing involves changing existing items in the taxonomies.<br />
==== Extending ====<br />
Extending involves adding new items to the taxonomies.<br />
The stores taxonomy needs to be regularly updated from the data entered through [https://prices.openfoodfacts.org/ OFF Prices]. This means any changed values and any added entries/<br />
<br />
== Spinoff ==<br />
Information on stores, operators and owners is not the main goal of OFF. OFF prefers that this is maintained by more specialised other parties. However OFF does gather this information through receipts for instance. Users are encouraged to add this kind of information to OpenStreetMap or wikidata.<br />
<br />
== Use cases ==<br />
<br />
== Discussion points ==<br />
<br />
* What information should be stored by OFF and what can be left to OSM or Wikidata? <br />
* What to be done with shops that go out of business?<br />
<br />
== Note ==<br />
* We need to associate stores with brands that are sold in thoses stores (Auchan for Auchan…)<br />
* We should try to add Wikidata relations (and thus OSM ones) whenever possible<br />
* Chains - if a store is part of a chain with multiple stores it can be added through a wikidata link<br />
<br />
Moved to GitHub: https://github.com/openfoodfacts/openfoodfacts-server/blob/master/taxonomies/stores.txt</div>Aleenehttps://wiki.openfoodfacts.org/index.php?title=Global_stores_taxonomy&diff=20650Global stores taxonomy2024-03-07T08:55:17Z<p>Aleene: /* Store brands */</p>
<hr />
<div>See [[Global taxonomies]] for instructions.<br />
[[Category:Global_Taxonomies]]<br />
== Introduction ==<br />
The stores taxonomy contains a list of locations where products (food products, beauty products, etc.) can be obtained. A related store brands taxonomy describes the brand names (store chains) of the individual stores.<br />
<br />
Most of the data related to these taxonomies is obtained through third parties (Wikidata, OpenStreetMap). The main interest of OFF is the relation between products, stores and brands.<br />
<br />
== Store entries ==<br />
An entry in the taxonomy describes a single location. This taxonomy can combine data pulled from various sources: receipts from prices, osm, wikidata, etc or provided by the user (honour system). OFF should be careful not copy to much data already maintained by other parties. And if data is copied, it is to provide a snapshot in time.<br />
=== Receipts ===<br />
[[File:Receipt example.png|thumb|Example of store information on a receipt]]<br />
The basis could be the receipts that users have added on prices. As all OFF data, any information should be backed up by image proofs. In the case for a store, this could be a receipt. The store information available on the receipt can be extracted to the taxonomy. What can be extracted depends on the receipt. In the example shown here, it is possible to extract the store name, the operator (useful for franchises), the address, phone number, siret, naf and tva. Analysus of more receipts might reveal other country specific information.<br />
Hopefully this information is enough to unambiguously identify a store.<br />
<br />
=== Prices ===<br />
The stores taxonomy can be based on [https://prices.openfoodfacts.org/ OFF Prices]. The receipts corresponding to a shop are entered on Prices. Prices has a unique identifier for each shop, which should be used as a linking pin. In addition Prices offers a link with Openstreetmap, which can be used to pull in additional information. Some of this information is already cached by Prices.<br />
=== Open Street Map ===<br />
All stores are linked to [https://www.openstreetmap.org/ Open Street Map] (OSM) through the unique OSM id. The link refers to a basic object in OSM:<br />
* Node - is used to refer to a single location, like [https://www.openstreetmap.org/node/25213337 BP Service];<br />
* (Closed) Way - is used to refer to a building, like [https://www.openstreetmap.org/way/31348922 IKEA];<br />
* Relation - is used to refer multiple ways used by the shop, like [https://www.openstreetmap.org/relation/1235874 Carrefour];<br />
<br />
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. This can be limited to OSM objects that have the tag ''shop''.<br />
<br />
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.<br />
<br />
=== Store brand ===<br />
The current implementation of OFF already supports a field for Stores. It is a free text field where the user can enter whatever s/he wants. A variety of entries is the consequence. But most of all it is used to enter the value for the Store brand, i.e. the name of the store as is shown outside the store and on receipts.<br />
<br />
Note that this can also be imported from OSM by means of the receipts. On OSM it is indicated with the tag ''brand''.<br />
<br />
OSM also indicates a link to wikidata (for instance [https://www.wikidata.org/wiki/Q151954 Lidl]).<br />
<br />
There are also ideas how to kickstart a list of store brands from external sources.<br />
<br />
=== Example Taxonomy Entry===<br />
An example for an entry / location / store / shop in the taxonomy:<br><br />
<nowiki>store_brand:en: Biocoop</nowiki><br><br />
<nowiki>price_id:en: 45</nowiki><br><br />
<nowiki>osm_id:en: 9815975601</nowiki><br><br />
<nowiki>osm_type:en: NODE</nowiki><br><br />
<nowiki>osm_display_name:en: "Biocoop, Rue de Tolbiac, Quartier de la Maison-Blanche, Paris 13e Arrondissement, Paris, Île-de-France, France métropolitaine, 75013, France"</nowiki><br><br />
<nowiki>osm_address_postcode:en: 75013</nowiki><br><br />
<nowiki>osm_address_city:en: en:Paris</nowiki><br><br />
<nowiki>osm_address_country:en: en:france</nowiki><br><br />
<nowiki>osm_lat:en: 48.8259597</nowiki><br><br />
<nowiki>osm_lon:en: 2.3511541</nowiki><br><br />
<br />
== Lifecycle ==<br />
The lifecycle for the two taxonomies is related, so they will be discussed together.<br />
=== Kickstart ===<br />
The kickstart describes the initial, very first introduction of the taxonomies.<br />
==== Store brands ====<br />
The store brands taxonomy could be started with the current entries in the Stores field. Unfortunately the quality of these current entries seems rather low. It is preferred to start with a high quality list pulled in from external sources, like all [https://www.wikidata.org/wiki/Q18043413 supermarket] chains listed on Wikidata.<br />
<br />
As a subsequent step all existing entries could be mapped to this store brands taxonomy.<br />
<br />
==== Stores ====<br />
From Prices.<br />
=== Maintenance ===<br />
==== Editing ====<br />
Editing involves changing existing items in the taxonomies.<br />
==== Extending ====<br />
Extending involves adding new items to the taxonomies.<br />
The stores taxonomy needs to be regularly updated from the data entered through [https://prices.openfoodfacts.org/ OFF Prices]. This means any changed values and any added entries/<br />
<br />
== Spinoff ==<br />
Information on stores, operators and owners is not the main goal of OFF. OFF prefers that this is maintained by more specialised other parties. However OFF does gather this information through receipts for instance. Users are encouraged to add this kind of information to OpenStreetMap or wikidata.<br />
<br />
== Use cases ==<br />
<br />
== Discussion points ==<br />
<br />
* What information should be stored by OFF and what can be left to OSM or Wikidata? <br />
* What to be done with shops that go out of business?<br />
<br />
== Note ==<br />
* We need to associate stores with brands that are sold in thoses stores (Auchan for Auchan…)<br />
* We should try to add Wikidata relations (and thus OSM ones) whenever possible<br />
* Chains - if a store is part of a chain with multiple stores it can be added through a wikidata link<br />
<br />
Moved to GitHub: https://github.com/openfoodfacts/openfoodfacts-server/blob/master/taxonomies/stores.txt</div>Aleenehttps://wiki.openfoodfacts.org/index.php?title=Global_stores_taxonomy&diff=20649Global stores taxonomy2024-03-07T08:43:43Z<p>Aleene: /* Maintenance */</p>
<hr />
<div>See [[Global taxonomies]] for instructions.<br />
[[Category:Global_Taxonomies]]<br />
== Introduction ==<br />
The stores taxonomy contains a list of locations where products (food products, beauty products, etc.) can be obtained. A related store brands taxonomy describes the brand names (store chains) of the individual stores.<br />
<br />
Most of the data related to these taxonomies is obtained through third parties (Wikidata, OpenStreetMap). The main interest of OFF is the relation between products, stores and brands.<br />
<br />
== Store entries ==<br />
An entry in the taxonomy describes a single location. This taxonomy can combine data pulled from various sources: receipts from prices, osm, wikidata, etc or provided by the user (honour system). OFF should be careful not copy to much data already maintained by other parties. And if data is copied, it is to provide a snapshot in time.<br />
=== Receipts ===<br />
[[File:Receipt example.png|thumb|Example of store information on a receipt]]<br />
The basis could be the receipts that users have added on prices. As all OFF data, any information should be backed up by image proofs. In the case for a store, this could be a receipt. The store information available on the receipt can be extracted to the taxonomy. What can be extracted depends on the receipt. In the example shown here, it is possible to extract the store name, the operator (useful for franchises), the address, phone number, siret, naf and tva. Analysus of more receipts might reveal other country specific information.<br />
Hopefully this information is enough to unambiguously identify a store.<br />
<br />
=== Prices ===<br />
The stores taxonomy can be based on [https://prices.openfoodfacts.org/ OFF Prices]. The receipts corresponding to a shop are entered on Prices. Prices has a unique identifier for each shop, which should be used as a linking pin. In addition Prices offers a link with Openstreetmap, which can be used to pull in additional information. Some of this information is already cached by Prices.<br />
=== Open Street Map ===<br />
All stores are linked to [https://www.openstreetmap.org/ Open Street Map] (OSM) through the unique OSM id. The link refers to a basic object in OSM:<br />
* Node - is used to refer to a single location, like [https://www.openstreetmap.org/node/25213337 BP Service];<br />
* (Closed) Way - is used to refer to a building, like [https://www.openstreetmap.org/way/31348922 IKEA];<br />
* Relation - is used to refer multiple ways used by the shop, like [https://www.openstreetmap.org/relation/1235874 Carrefour];<br />
<br />
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. This can be limited to OSM objects that have the tag ''shop''.<br />
<br />
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.<br />
<br />
=== Store brand ===<br />
The current implementation of OFF already supports a field for Stores. It is a free text field where the user can enter whatever s/he wants. A variety of entries is the consequence. But most of all it is used to enter the value for the Store brand, i.e. the name of the store as is shown outside the store and on receipts.<br />
<br />
Note that this can also be imported from OSM by means of the receipts. On OSM it is indicated with the tag ''brand''.<br />
<br />
OSM also indicates a link to wikidata (for instance [https://www.wikidata.org/wiki/Q151954 Lidl]).<br />
<br />
There are also ideas how to kickstart a list of store brands from external sources.<br />
<br />
=== Example Taxonomy Entry===<br />
An example for an entry / location / store / shop in the taxonomy:<br><br />
<nowiki>store_brand:en: Biocoop</nowiki><br><br />
<nowiki>price_id:en: 45</nowiki><br><br />
<nowiki>osm_id:en: 9815975601</nowiki><br><br />
<nowiki>osm_type:en: NODE</nowiki><br><br />
<nowiki>osm_display_name:en: "Biocoop, Rue de Tolbiac, Quartier de la Maison-Blanche, Paris 13e Arrondissement, Paris, Île-de-France, France métropolitaine, 75013, France"</nowiki><br><br />
<nowiki>osm_address_postcode:en: 75013</nowiki><br><br />
<nowiki>osm_address_city:en: en:Paris</nowiki><br><br />
<nowiki>osm_address_country:en: en:france</nowiki><br><br />
<nowiki>osm_lat:en: 48.8259597</nowiki><br><br />
<nowiki>osm_lon:en: 2.3511541</nowiki><br><br />
<br />
== Lifecycle ==<br />
The lifecycle for the two taxonomies is related, so they will be discussed together.<br />
=== Kickstart ===<br />
The kickstart describes the initial, very first introduction of the taxonomies.<br />
==== Store brands ====<br />
External<br />
==== Stores ====<br />
From Prices.<br />
=== Maintenance ===<br />
==== Editing ====<br />
Editing involves changing existing items in the taxonomies.<br />
==== Extending ====<br />
Extending involves adding new items to the taxonomies.<br />
The stores taxonomy needs to be regularly updated from the data entered through [https://prices.openfoodfacts.org/ OFF Prices]. This means any changed values and any added entries/<br />
<br />
== Spinoff ==<br />
Information on stores, operators and owners is not the main goal of OFF. OFF prefers that this is maintained by more specialised other parties. However OFF does gather this information through receipts for instance. Users are encouraged to add this kind of information to OpenStreetMap or wikidata.<br />
<br />
== Use cases ==<br />
<br />
== Discussion points ==<br />
<br />
* What information should be stored by OFF and what can be left to OSM or Wikidata? <br />
* What to be done with shops that go out of business?<br />
<br />
== Note ==<br />
* We need to associate stores with brands that are sold in thoses stores (Auchan for Auchan…)<br />
* We should try to add Wikidata relations (and thus OSM ones) whenever possible<br />
* Chains - if a store is part of a chain with multiple stores it can be added through a wikidata link<br />
<br />
Moved to GitHub: https://github.com/openfoodfacts/openfoodfacts-server/blob/master/taxonomies/stores.txt</div>Aleenehttps://wiki.openfoodfacts.org/index.php?title=Global_stores_taxonomy&diff=20648Global stores taxonomy2024-03-07T08:42:07Z<p>Aleene: /* Lifecycle */</p>
<hr />
<div>See [[Global taxonomies]] for instructions.<br />
[[Category:Global_Taxonomies]]<br />
== Introduction ==<br />
The stores taxonomy contains a list of locations where products (food products, beauty products, etc.) can be obtained. A related store brands taxonomy describes the brand names (store chains) of the individual stores.<br />
<br />
Most of the data related to these taxonomies is obtained through third parties (Wikidata, OpenStreetMap). The main interest of OFF is the relation between products, stores and brands.<br />
<br />
== Store entries ==<br />
An entry in the taxonomy describes a single location. This taxonomy can combine data pulled from various sources: receipts from prices, osm, wikidata, etc or provided by the user (honour system). OFF should be careful not copy to much data already maintained by other parties. And if data is copied, it is to provide a snapshot in time.<br />
=== Receipts ===<br />
[[File:Receipt example.png|thumb|Example of store information on a receipt]]<br />
The basis could be the receipts that users have added on prices. As all OFF data, any information should be backed up by image proofs. In the case for a store, this could be a receipt. The store information available on the receipt can be extracted to the taxonomy. What can be extracted depends on the receipt. In the example shown here, it is possible to extract the store name, the operator (useful for franchises), the address, phone number, siret, naf and tva. Analysus of more receipts might reveal other country specific information.<br />
Hopefully this information is enough to unambiguously identify a store.<br />
<br />
=== Prices ===<br />
The stores taxonomy can be based on [https://prices.openfoodfacts.org/ OFF Prices]. The receipts corresponding to a shop are entered on Prices. Prices has a unique identifier for each shop, which should be used as a linking pin. In addition Prices offers a link with Openstreetmap, which can be used to pull in additional information. Some of this information is already cached by Prices.<br />
=== Open Street Map ===<br />
All stores are linked to [https://www.openstreetmap.org/ Open Street Map] (OSM) through the unique OSM id. The link refers to a basic object in OSM:<br />
* Node - is used to refer to a single location, like [https://www.openstreetmap.org/node/25213337 BP Service];<br />
* (Closed) Way - is used to refer to a building, like [https://www.openstreetmap.org/way/31348922 IKEA];<br />
* Relation - is used to refer multiple ways used by the shop, like [https://www.openstreetmap.org/relation/1235874 Carrefour];<br />
<br />
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. This can be limited to OSM objects that have the tag ''shop''.<br />
<br />
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.<br />
<br />
=== Store brand ===<br />
The current implementation of OFF already supports a field for Stores. It is a free text field where the user can enter whatever s/he wants. A variety of entries is the consequence. But most of all it is used to enter the value for the Store brand, i.e. the name of the store as is shown outside the store and on receipts.<br />
<br />
Note that this can also be imported from OSM by means of the receipts. On OSM it is indicated with the tag ''brand''.<br />
<br />
OSM also indicates a link to wikidata (for instance [https://www.wikidata.org/wiki/Q151954 Lidl]).<br />
<br />
There are also ideas how to kickstart a list of store brands from external sources.<br />
<br />
=== Example Taxonomy Entry===<br />
An example for an entry / location / store / shop in the taxonomy:<br><br />
<nowiki>store_brand:en: Biocoop</nowiki><br><br />
<nowiki>price_id:en: 45</nowiki><br><br />
<nowiki>osm_id:en: 9815975601</nowiki><br><br />
<nowiki>osm_type:en: NODE</nowiki><br><br />
<nowiki>osm_display_name:en: "Biocoop, Rue de Tolbiac, Quartier de la Maison-Blanche, Paris 13e Arrondissement, Paris, Île-de-France, France métropolitaine, 75013, France"</nowiki><br><br />
<nowiki>osm_address_postcode:en: 75013</nowiki><br><br />
<nowiki>osm_address_city:en: en:Paris</nowiki><br><br />
<nowiki>osm_address_country:en: en:france</nowiki><br><br />
<nowiki>osm_lat:en: 48.8259597</nowiki><br><br />
<nowiki>osm_lon:en: 2.3511541</nowiki><br><br />
<br />
== Lifecycle ==<br />
The lifecycle for the two taxonomies is related, so they will be discussed together.<br />
=== Kickstart ===<br />
The kickstart describes the initial, very first introduction of the taxonomies.<br />
==== Store brands ====<br />
External<br />
==== Stores ====<br />
From Prices.<br />
=== Maintenance ===<br />
The stores taxonomy needs to be regularly updated from the data entered through [https://prices.openfoodfacts.org/ OFF Prices]. This means any changed values and any added entries/<br />
== Spinoff ==<br />
Information on stores, operators and owners is not the main goal of OFF. OFF prefers that this is maintained by more specialised other parties. However OFF does gather this information through receipts for instance. Users are encouraged to add this kind of information to OpenStreetMap or wikidata.<br />
<br />
== Use cases ==<br />
<br />
== Discussion points ==<br />
<br />
* What information should be stored by OFF and what can be left to OSM or Wikidata? <br />
* What to be done with shops that go out of business?<br />
<br />
== Note ==<br />
* We need to associate stores with brands that are sold in thoses stores (Auchan for Auchan…)<br />
* We should try to add Wikidata relations (and thus OSM ones) whenever possible<br />
* Chains - if a store is part of a chain with multiple stores it can be added through a wikidata link<br />
<br />
Moved to GitHub: https://github.com/openfoodfacts/openfoodfacts-server/blob/master/taxonomies/stores.txt</div>Aleenehttps://wiki.openfoodfacts.org/index.php?title=Global_stores_taxonomy&diff=20647Global stores taxonomy2024-03-07T08:33:00Z<p>Aleene: /* Lifecycle */</p>
<hr />
<div>See [[Global taxonomies]] for instructions.<br />
[[Category:Global_Taxonomies]]<br />
== Introduction ==<br />
The stores taxonomy contains a list of locations where products (food products, beauty products, etc.) can be obtained. A related store brands taxonomy describes the brand names (store chains) of the individual stores.<br />
<br />
Most of the data related to these taxonomies is obtained through third parties (Wikidata, OpenStreetMap). The main interest of OFF is the relation between products, stores and brands.<br />
<br />
== Store entries ==<br />
An entry in the taxonomy describes a single location. This taxonomy can combine data pulled from various sources: receipts from prices, osm, wikidata, etc or provided by the user (honour system). OFF should be careful not copy to much data already maintained by other parties. And if data is copied, it is to provide a snapshot in time.<br />
=== Receipts ===<br />
[[File:Receipt example.png|thumb|Example of store information on a receipt]]<br />
The basis could be the receipts that users have added on prices. As all OFF data, any information should be backed up by image proofs. In the case for a store, this could be a receipt. The store information available on the receipt can be extracted to the taxonomy. What can be extracted depends on the receipt. In the example shown here, it is possible to extract the store name, the operator (useful for franchises), the address, phone number, siret, naf and tva. Analysus of more receipts might reveal other country specific information.<br />
Hopefully this information is enough to unambiguously identify a store.<br />
<br />
=== Prices ===<br />
The stores taxonomy can be based on [https://prices.openfoodfacts.org/ OFF Prices]. The receipts corresponding to a shop are entered on Prices. Prices has a unique identifier for each shop, which should be used as a linking pin. In addition Prices offers a link with Openstreetmap, which can be used to pull in additional information. Some of this information is already cached by Prices.<br />
=== Open Street Map ===<br />
All stores are linked to [https://www.openstreetmap.org/ Open Street Map] (OSM) through the unique OSM id. The link refers to a basic object in OSM:<br />
* Node - is used to refer to a single location, like [https://www.openstreetmap.org/node/25213337 BP Service];<br />
* (Closed) Way - is used to refer to a building, like [https://www.openstreetmap.org/way/31348922 IKEA];<br />
* Relation - is used to refer multiple ways used by the shop, like [https://www.openstreetmap.org/relation/1235874 Carrefour];<br />
<br />
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. This can be limited to OSM objects that have the tag ''shop''.<br />
<br />
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.<br />
<br />
=== Store brand ===<br />
The current implementation of OFF already supports a field for Stores. It is a free text field where the user can enter whatever s/he wants. A variety of entries is the consequence. But most of all it is used to enter the value for the Store brand, i.e. the name of the store as is shown outside the store and on receipts.<br />
<br />
Note that this can also be imported from OSM by means of the receipts. On OSM it is indicated with the tag ''brand''.<br />
<br />
OSM also indicates a link to wikidata (for instance [https://www.wikidata.org/wiki/Q151954 Lidl]).<br />
<br />
There are also ideas how to kickstart a list of store brands from external sources.<br />
<br />
=== Example Taxonomy Entry===<br />
An example for an entry / location / store / shop in the taxonomy:<br><br />
<nowiki>store_brand:en: Biocoop</nowiki><br><br />
<nowiki>price_id:en: 45</nowiki><br><br />
<nowiki>osm_id:en: 9815975601</nowiki><br><br />
<nowiki>osm_type:en: NODE</nowiki><br><br />
<nowiki>osm_display_name:en: "Biocoop, Rue de Tolbiac, Quartier de la Maison-Blanche, Paris 13e Arrondissement, Paris, Île-de-France, France métropolitaine, 75013, France"</nowiki><br><br />
<nowiki>osm_address_postcode:en: 75013</nowiki><br><br />
<nowiki>osm_address_city:en: en:Paris</nowiki><br><br />
<nowiki>osm_address_country:en: en:france</nowiki><br><br />
<nowiki>osm_lat:en: 48.8259597</nowiki><br><br />
<nowiki>osm_lon:en: 2.3511541</nowiki><br><br />
<br />
== Lifecycle ==<br />
The lifecycle for the two taxonomies is related, so they will be discussed together.<br />
=== Kickstart ===<br />
The kickstart describes the initial, very first introduction of the taxonomies.<br />
==== Store brands ====<br />
External<br />
==== Stores ====<br />
From Prices.<br />
=== Maintenance ===<br />
The stores taxonomy needs to be regularly updated from the data entered through [https://prices.openfoodfacts.org/ OFF Prices]. This means any changed values and any added entries/<br />
<br />
== Use cases ==<br />
<br />
== Discussion points ==<br />
<br />
* What information should be stored by OFF and what can be left to OSM or Wikidata? <br />
* What to be done with shops that go out of business?<br />
<br />
== Note ==<br />
* We need to associate stores with brands that are sold in thoses stores (Auchan for Auchan…)<br />
* We should try to add Wikidata relations (and thus OSM ones) whenever possible<br />
* Chains - if a store is part of a chain with multiple stores it can be added through a wikidata link<br />
<br />
Moved to GitHub: https://github.com/openfoodfacts/openfoodfacts-server/blob/master/taxonomies/stores.txt</div>Aleenehttps://wiki.openfoodfacts.org/index.php?title=Global_stores_taxonomy&diff=20646Global stores taxonomy2024-03-07T08:24:43Z<p>Aleene: /* Maintenance */</p>
<hr />
<div>See [[Global taxonomies]] for instructions.<br />
[[Category:Global_Taxonomies]]<br />
== Introduction ==<br />
The stores taxonomy contains a list of locations where products (food products, beauty products, etc.) can be obtained. A related store brands taxonomy describes the brand names (store chains) of the individual stores.<br />
<br />
Most of the data related to these taxonomies is obtained through third parties (Wikidata, OpenStreetMap). The main interest of OFF is the relation between products, stores and brands.<br />
<br />
== Store entries ==<br />
An entry in the taxonomy describes a single location. This taxonomy can combine data pulled from various sources: receipts from prices, osm, wikidata, etc or provided by the user (honour system). OFF should be careful not copy to much data already maintained by other parties. And if data is copied, it is to provide a snapshot in time.<br />
=== Receipts ===<br />
[[File:Receipt example.png|thumb|Example of store information on a receipt]]<br />
The basis could be the receipts that users have added on prices. As all OFF data, any information should be backed up by image proofs. In the case for a store, this could be a receipt. The store information available on the receipt can be extracted to the taxonomy. What can be extracted depends on the receipt. In the example shown here, it is possible to extract the store name, the operator (useful for franchises), the address, phone number, siret, naf and tva. Analysus of more receipts might reveal other country specific information.<br />
Hopefully this information is enough to unambiguously identify a store.<br />
<br />
=== Prices ===<br />
The stores taxonomy can be based on [https://prices.openfoodfacts.org/ OFF Prices]. The receipts corresponding to a shop are entered on Prices. Prices has a unique identifier for each shop, which should be used as a linking pin. In addition Prices offers a link with Openstreetmap, which can be used to pull in additional information. Some of this information is already cached by Prices.<br />
=== Open Street Map ===<br />
All stores are linked to [https://www.openstreetmap.org/ Open Street Map] (OSM) through the unique OSM id. The link refers to a basic object in OSM:<br />
* Node - is used to refer to a single location, like [https://www.openstreetmap.org/node/25213337 BP Service];<br />
* (Closed) Way - is used to refer to a building, like [https://www.openstreetmap.org/way/31348922 IKEA];<br />
* Relation - is used to refer multiple ways used by the shop, like [https://www.openstreetmap.org/relation/1235874 Carrefour];<br />
<br />
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. This can be limited to OSM objects that have the tag ''shop''.<br />
<br />
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.<br />
<br />
=== Store brand ===<br />
The current implementation of OFF already supports a field for Stores. It is a free text field where the user can enter whatever s/he wants. A variety of entries is the consequence. But most of all it is used to enter the value for the Store brand, i.e. the name of the store as is shown outside the store and on receipts.<br />
<br />
Note that this can also be imported from OSM by means of the receipts. On OSM it is indicated with the tag ''brand''.<br />
<br />
OSM also indicates a link to wikidata (for instance [https://www.wikidata.org/wiki/Q151954 Lidl]).<br />
<br />
There are also ideas how to kickstart a list of store brands from external sources.<br />
<br />
=== Example Taxonomy Entry===<br />
An example for an entry / location / store / shop in the taxonomy:<br><br />
<nowiki>store_brand:en: Biocoop</nowiki><br><br />
<nowiki>price_id:en: 45</nowiki><br><br />
<nowiki>osm_id:en: 9815975601</nowiki><br><br />
<nowiki>osm_type:en: NODE</nowiki><br><br />
<nowiki>osm_display_name:en: "Biocoop, Rue de Tolbiac, Quartier de la Maison-Blanche, Paris 13e Arrondissement, Paris, Île-de-France, France métropolitaine, 75013, France"</nowiki><br><br />
<nowiki>osm_address_postcode:en: 75013</nowiki><br><br />
<nowiki>osm_address_city:en: en:Paris</nowiki><br><br />
<nowiki>osm_address_country:en: en:france</nowiki><br><br />
<nowiki>osm_lat:en: 48.8259597</nowiki><br><br />
<nowiki>osm_lon:en: 2.3511541</nowiki><br><br />
<br />
== Lifecycle ==<br />
The stores taxonomy needs to be regularly updated from the data entered through [https://prices.openfoodfacts.org/ OFF Prices]. This means any changed values and any added entries/<br />
== Use cases ==<br />
<br />
== Discussion points ==<br />
<br />
* What information should be stored by OFF and what can be left to OSM or Wikidata? <br />
* What to be done with shops that go out of business?<br />
<br />
== Note ==<br />
* We need to associate stores with brands that are sold in thoses stores (Auchan for Auchan…)<br />
* We should try to add Wikidata relations (and thus OSM ones) whenever possible<br />
* Chains - if a store is part of a chain with multiple stores it can be added through a wikidata link<br />
<br />
Moved to GitHub: https://github.com/openfoodfacts/openfoodfacts-server/blob/master/taxonomies/stores.txt</div>Aleenehttps://wiki.openfoodfacts.org/index.php?title=Global_stores_taxonomy&diff=20645Global stores taxonomy2024-03-07T08:24:02Z<p>Aleene: /* Introduction */</p>
<hr />
<div>See [[Global taxonomies]] for instructions.<br />
[[Category:Global_Taxonomies]]<br />
== Introduction ==<br />
The stores taxonomy contains a list of locations where products (food products, beauty products, etc.) can be obtained. A related store brands taxonomy describes the brand names (store chains) of the individual stores.<br />
<br />
Most of the data related to these taxonomies is obtained through third parties (Wikidata, OpenStreetMap). The main interest of OFF is the relation between products, stores and brands.<br />
<br />
== Store entries ==<br />
An entry in the taxonomy describes a single location. This taxonomy can combine data pulled from various sources: receipts from prices, osm, wikidata, etc or provided by the user (honour system). OFF should be careful not copy to much data already maintained by other parties. And if data is copied, it is to provide a snapshot in time.<br />
=== Receipts ===<br />
[[File:Receipt example.png|thumb|Example of store information on a receipt]]<br />
The basis could be the receipts that users have added on prices. As all OFF data, any information should be backed up by image proofs. In the case for a store, this could be a receipt. The store information available on the receipt can be extracted to the taxonomy. What can be extracted depends on the receipt. In the example shown here, it is possible to extract the store name, the operator (useful for franchises), the address, phone number, siret, naf and tva. Analysus of more receipts might reveal other country specific information.<br />
Hopefully this information is enough to unambiguously identify a store.<br />
<br />
=== Prices ===<br />
The stores taxonomy can be based on [https://prices.openfoodfacts.org/ OFF Prices]. The receipts corresponding to a shop are entered on Prices. Prices has a unique identifier for each shop, which should be used as a linking pin. In addition Prices offers a link with Openstreetmap, which can be used to pull in additional information. Some of this information is already cached by Prices.<br />
=== Open Street Map ===<br />
All stores are linked to [https://www.openstreetmap.org/ Open Street Map] (OSM) through the unique OSM id. The link refers to a basic object in OSM:<br />
* Node - is used to refer to a single location, like [https://www.openstreetmap.org/node/25213337 BP Service];<br />
* (Closed) Way - is used to refer to a building, like [https://www.openstreetmap.org/way/31348922 IKEA];<br />
* Relation - is used to refer multiple ways used by the shop, like [https://www.openstreetmap.org/relation/1235874 Carrefour];<br />
<br />
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. This can be limited to OSM objects that have the tag ''shop''.<br />
<br />
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.<br />
<br />
=== Store brand ===<br />
The current implementation of OFF already supports a field for Stores. It is a free text field where the user can enter whatever s/he wants. A variety of entries is the consequence. But most of all it is used to enter the value for the Store brand, i.e. the name of the store as is shown outside the store and on receipts.<br />
<br />
Note that this can also be imported from OSM by means of the receipts. On OSM it is indicated with the tag ''brand''.<br />
<br />
OSM also indicates a link to wikidata (for instance [https://www.wikidata.org/wiki/Q151954 Lidl]).<br />
<br />
There are also ideas how to kickstart a list of store brands from external sources.<br />
<br />
=== Example Taxonomy Entry===<br />
An example for an entry / location / store / shop in the taxonomy:<br><br />
<nowiki>store_brand:en: Biocoop</nowiki><br><br />
<nowiki>price_id:en: 45</nowiki><br><br />
<nowiki>osm_id:en: 9815975601</nowiki><br><br />
<nowiki>osm_type:en: NODE</nowiki><br><br />
<nowiki>osm_display_name:en: "Biocoop, Rue de Tolbiac, Quartier de la Maison-Blanche, Paris 13e Arrondissement, Paris, Île-de-France, France métropolitaine, 75013, France"</nowiki><br><br />
<nowiki>osm_address_postcode:en: 75013</nowiki><br><br />
<nowiki>osm_address_city:en: en:Paris</nowiki><br><br />
<nowiki>osm_address_country:en: en:france</nowiki><br><br />
<nowiki>osm_lat:en: 48.8259597</nowiki><br><br />
<nowiki>osm_lon:en: 2.3511541</nowiki><br><br />
<br />
== Maintenance ==<br />
The stores taxonomy needs to be regularly updated from the data entered through [https://prices.openfoodfacts.org/ OFF Prices]. This means any changed values and any added entries/<br />
<br />
== Discussion points ==<br />
<br />
* What information should be stored by OFF and what can be left to OSM or Wikidata? <br />
* What to be done with shops that go out of business?<br />
<br />
== Note ==<br />
* We need to associate stores with brands that are sold in thoses stores (Auchan for Auchan…)<br />
* We should try to add Wikidata relations (and thus OSM ones) whenever possible<br />
* Chains - if a store is part of a chain with multiple stores it can be added through a wikidata link<br />
<br />
Moved to GitHub: https://github.com/openfoodfacts/openfoodfacts-server/blob/master/taxonomies/stores.txt</div>Aleenehttps://wiki.openfoodfacts.org/index.php?title=Global_stores_taxonomy&diff=20644Global stores taxonomy2024-03-06T17:55:37Z<p>Aleene: /* Store brand */</p>
<hr />
<div>See [[Global taxonomies]] for instructions.<br />
[[Category:Global_Taxonomies]]<br />
== Introduction ==<br />
The stores taxonomy contains a list of locations where products (food products, beauty products, etc.) can be obtained.<br />
<br />
== Store entries ==<br />
An entry in the taxonomy describes a single location. This taxonomy can combine data pulled from various sources: receipts from prices, osm, wikidata, etc or provided by the user (honour system). OFF should be careful not copy to much data already maintained by other parties. And if data is copied, it is to provide a snapshot in time.<br />
=== Receipts ===<br />
[[File:Receipt example.png|thumb|Example of store information on a receipt]]<br />
The basis could be the receipts that users have added on prices. As all OFF data, any information should be backed up by image proofs. In the case for a store, this could be a receipt. The store information available on the receipt can be extracted to the taxonomy. What can be extracted depends on the receipt. In the example shown here, it is possible to extract the store name, the operator (useful for franchises), the address, phone number, siret, naf and tva. Analysus of more receipts might reveal other country specific information.<br />
Hopefully this information is enough to unambiguously identify a store.<br />
<br />
=== Prices ===<br />
The stores taxonomy can be based on [https://prices.openfoodfacts.org/ OFF Prices]. The receipts corresponding to a shop are entered on Prices. Prices has a unique identifier for each shop, which should be used as a linking pin. In addition Prices offers a link with Openstreetmap, which can be used to pull in additional information. Some of this information is already cached by Prices.<br />
=== Open Street Map ===<br />
All stores are linked to [https://www.openstreetmap.org/ Open Street Map] (OSM) through the unique OSM id. The link refers to a basic object in OSM:<br />
* Node - is used to refer to a single location, like [https://www.openstreetmap.org/node/25213337 BP Service];<br />
* (Closed) Way - is used to refer to a building, like [https://www.openstreetmap.org/way/31348922 IKEA];<br />
* Relation - is used to refer multiple ways used by the shop, like [https://www.openstreetmap.org/relation/1235874 Carrefour];<br />
<br />
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. This can be limited to OSM objects that have the tag ''shop''.<br />
<br />
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.<br />
<br />
=== Store brand ===<br />
The current implementation of OFF already supports a field for Stores. It is a free text field where the user can enter whatever s/he wants. A variety of entries is the consequence. But most of all it is used to enter the value for the Store brand, i.e. the name of the store as is shown outside the store and on receipts.<br />
<br />
Note that this can also be imported from OSM by means of the receipts. On OSM it is indicated with the tag ''brand''.<br />
<br />
OSM also indicates a link to wikidata (for instance [https://www.wikidata.org/wiki/Q151954 Lidl]).<br />
<br />
There are also ideas how to kickstart a list of store brands from external sources.<br />
<br />
=== Example Taxonomy Entry===<br />
An example for an entry / location / store / shop in the taxonomy:<br><br />
<nowiki>store_brand:en: Biocoop</nowiki><br><br />
<nowiki>price_id:en: 45</nowiki><br><br />
<nowiki>osm_id:en: 9815975601</nowiki><br><br />
<nowiki>osm_type:en: NODE</nowiki><br><br />
<nowiki>osm_display_name:en: "Biocoop, Rue de Tolbiac, Quartier de la Maison-Blanche, Paris 13e Arrondissement, Paris, Île-de-France, France métropolitaine, 75013, France"</nowiki><br><br />
<nowiki>osm_address_postcode:en: 75013</nowiki><br><br />
<nowiki>osm_address_city:en: en:Paris</nowiki><br><br />
<nowiki>osm_address_country:en: en:france</nowiki><br><br />
<nowiki>osm_lat:en: 48.8259597</nowiki><br><br />
<nowiki>osm_lon:en: 2.3511541</nowiki><br><br />
<br />
== Maintenance ==<br />
The stores taxonomy needs to be regularly updated from the data entered through [https://prices.openfoodfacts.org/ OFF Prices]. This means any changed values and any added entries/<br />
<br />
== Discussion points ==<br />
<br />
* What information should be stored by OFF and what can be left to OSM or Wikidata? <br />
* What to be done with shops that go out of business?<br />
<br />
== Note ==<br />
* We need to associate stores with brands that are sold in thoses stores (Auchan for Auchan…)<br />
* We should try to add Wikidata relations (and thus OSM ones) whenever possible<br />
* Chains - if a store is part of a chain with multiple stores it can be added through a wikidata link<br />
<br />
Moved to GitHub: https://github.com/openfoodfacts/openfoodfacts-server/blob/master/taxonomies/stores.txt</div>Aleenehttps://wiki.openfoodfacts.org/index.php?title=Global_stores_taxonomy&diff=20643Global stores taxonomy2024-03-06T17:53:41Z<p>Aleene: /* Store brand */</p>
<hr />
<div>See [[Global taxonomies]] for instructions.<br />
[[Category:Global_Taxonomies]]<br />
== Introduction ==<br />
The stores taxonomy contains a list of locations where products (food products, beauty products, etc.) can be obtained.<br />
<br />
== Store entries ==<br />
An entry in the taxonomy describes a single location. This taxonomy can combine data pulled from various sources: receipts from prices, osm, wikidata, etc or provided by the user (honour system). OFF should be careful not copy to much data already maintained by other parties. And if data is copied, it is to provide a snapshot in time.<br />
=== Receipts ===<br />
[[File:Receipt example.png|thumb|Example of store information on a receipt]]<br />
The basis could be the receipts that users have added on prices. As all OFF data, any information should be backed up by image proofs. In the case for a store, this could be a receipt. The store information available on the receipt can be extracted to the taxonomy. What can be extracted depends on the receipt. In the example shown here, it is possible to extract the store name, the operator (useful for franchises), the address, phone number, siret, naf and tva. Analysus of more receipts might reveal other country specific information.<br />
Hopefully this information is enough to unambiguously identify a store.<br />
<br />
=== Prices ===<br />
The stores taxonomy can be based on [https://prices.openfoodfacts.org/ OFF Prices]. The receipts corresponding to a shop are entered on Prices. Prices has a unique identifier for each shop, which should be used as a linking pin. In addition Prices offers a link with Openstreetmap, which can be used to pull in additional information. Some of this information is already cached by Prices.<br />
=== Open Street Map ===<br />
All stores are linked to [https://www.openstreetmap.org/ Open Street Map] (OSM) through the unique OSM id. The link refers to a basic object in OSM:<br />
* Node - is used to refer to a single location, like [https://www.openstreetmap.org/node/25213337 BP Service];<br />
* (Closed) Way - is used to refer to a building, like [https://www.openstreetmap.org/way/31348922 IKEA];<br />
* Relation - is used to refer multiple ways used by the shop, like [https://www.openstreetmap.org/relation/1235874 Carrefour];<br />
<br />
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. This can be limited to OSM objects that have the tag ''shop''.<br />
<br />
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.<br />
<br />
=== Store brand ===<br />
The current implementation of OFF already supports a field for Stores. It is a free text field where the user can enter whatever s/he wants. A variety of entries is the consequence. But most of all it is used to enter the value for the Store brand, i.e. the name of the store as is shown outside the store and on receipts. <br />
There are also ideas how to kickstart a list of store brands from external sources. Note that this can also be imported from OSM by means of the receipts. On OSM it is indicated with the tag ''brand''.<br />
<br />
=== Example Taxonomy Entry===<br />
An example for an entry / location / store / shop in the taxonomy:<br><br />
<nowiki>store_brand:en: Biocoop</nowiki><br><br />
<nowiki>price_id:en: 45</nowiki><br><br />
<nowiki>osm_id:en: 9815975601</nowiki><br><br />
<nowiki>osm_type:en: NODE</nowiki><br><br />
<nowiki>osm_display_name:en: "Biocoop, Rue de Tolbiac, Quartier de la Maison-Blanche, Paris 13e Arrondissement, Paris, Île-de-France, France métropolitaine, 75013, France"</nowiki><br><br />
<nowiki>osm_address_postcode:en: 75013</nowiki><br><br />
<nowiki>osm_address_city:en: en:Paris</nowiki><br><br />
<nowiki>osm_address_country:en: en:france</nowiki><br><br />
<nowiki>osm_lat:en: 48.8259597</nowiki><br><br />
<nowiki>osm_lon:en: 2.3511541</nowiki><br><br />
<br />
== Maintenance ==<br />
The stores taxonomy needs to be regularly updated from the data entered through [https://prices.openfoodfacts.org/ OFF Prices]. This means any changed values and any added entries/<br />
<br />
== Discussion points ==<br />
<br />
* What information should be stored by OFF and what can be left to OSM or Wikidata? <br />
* What to be done with shops that go out of business?<br />
<br />
== Note ==<br />
* We need to associate stores with brands that are sold in thoses stores (Auchan for Auchan…)<br />
* We should try to add Wikidata relations (and thus OSM ones) whenever possible<br />
* Chains - if a store is part of a chain with multiple stores it can be added through a wikidata link<br />
<br />
Moved to GitHub: https://github.com/openfoodfacts/openfoodfacts-server/blob/master/taxonomies/stores.txt</div>Aleenehttps://wiki.openfoodfacts.org/index.php?title=Global_stores_taxonomy&diff=20642Global stores taxonomy2024-03-06T17:37:26Z<p>Aleene: /* Example Taxonomy Entry */</p>
<hr />
<div>See [[Global taxonomies]] for instructions.<br />
[[Category:Global_Taxonomies]]<br />
== Introduction ==<br />
The stores taxonomy contains a list of locations where products (food products, beauty products, etc.) can be obtained.<br />
<br />
== Store entries ==<br />
An entry in the taxonomy describes a single location. This taxonomy can combine data pulled from various sources: receipts from prices, osm, wikidata, etc or provided by the user (honour system). OFF should be careful not copy to much data already maintained by other parties. And if data is copied, it is to provide a snapshot in time.<br />
=== Receipts ===<br />
[[File:Receipt example.png|thumb|Example of store information on a receipt]]<br />
The basis could be the receipts that users have added on prices. As all OFF data, any information should be backed up by image proofs. In the case for a store, this could be a receipt. The store information available on the receipt can be extracted to the taxonomy. What can be extracted depends on the receipt. In the example shown here, it is possible to extract the store name, the operator (useful for franchises), the address, phone number, siret, naf and tva. Analysus of more receipts might reveal other country specific information.<br />
Hopefully this information is enough to unambiguously identify a store.<br />
<br />
=== Prices ===<br />
The stores taxonomy can be based on [https://prices.openfoodfacts.org/ OFF Prices]. The receipts corresponding to a shop are entered on Prices. Prices has a unique identifier for each shop, which should be used as a linking pin. In addition Prices offers a link with Openstreetmap, which can be used to pull in additional information. Some of this information is already cached by Prices.<br />
=== Open Street Map ===<br />
All stores are linked to [https://www.openstreetmap.org/ Open Street Map] (OSM) through the unique OSM id. The link refers to a basic object in OSM:<br />
* Node - is used to refer to a single location, like [https://www.openstreetmap.org/node/25213337 BP Service];<br />
* (Closed) Way - is used to refer to a building, like [https://www.openstreetmap.org/way/31348922 IKEA];<br />
* Relation - is used to refer multiple ways used by the shop, like [https://www.openstreetmap.org/relation/1235874 Carrefour];<br />
<br />
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. This can be limited to OSM objects that have the tag ''shop''.<br />
<br />
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.<br />
<br />
=== Store brand ===<br />
The current implementation of OFF already supports a field for Stores. It is a free text field where the user can enter whatever s/he wants. A variety of entries is the consequence. But most of all it is used to enter the value for the Store brand, i.e. the name of the store as is shown outside the store and on receipts.<br />
<br />
=== Example Taxonomy Entry===<br />
An example for an entry / location / store / shop in the taxonomy:<br><br />
<nowiki>store_brand:en: Biocoop</nowiki><br><br />
<nowiki>price_id:en: 45</nowiki><br><br />
<nowiki>osm_id:en: 9815975601</nowiki><br><br />
<nowiki>osm_type:en: NODE</nowiki><br><br />
<nowiki>osm_display_name:en: "Biocoop, Rue de Tolbiac, Quartier de la Maison-Blanche, Paris 13e Arrondissement, Paris, Île-de-France, France métropolitaine, 75013, France"</nowiki><br><br />
<nowiki>osm_address_postcode:en: 75013</nowiki><br><br />
<nowiki>osm_address_city:en: en:Paris</nowiki><br><br />
<nowiki>osm_address_country:en: en:france</nowiki><br><br />
<nowiki>osm_lat:en: 48.8259597</nowiki><br><br />
<nowiki>osm_lon:en: 2.3511541</nowiki><br><br />
<br />
== Maintenance ==<br />
The stores taxonomy needs to be regularly updated from the data entered through [https://prices.openfoodfacts.org/ OFF Prices]. This means any changed values and any added entries/<br />
<br />
== Discussion points ==<br />
<br />
* What information should be stored by OFF and what can be left to OSM or Wikidata? <br />
* What to be done with shops that go out of business?<br />
<br />
== Note ==<br />
* We need to associate stores with brands that are sold in thoses stores (Auchan for Auchan…)<br />
* We should try to add Wikidata relations (and thus OSM ones) whenever possible<br />
* Chains - if a store is part of a chain with multiple stores it can be added through a wikidata link<br />
<br />
Moved to GitHub: https://github.com/openfoodfacts/openfoodfacts-server/blob/master/taxonomies/stores.txt</div>Aleenehttps://wiki.openfoodfacts.org/index.php?title=Global_stores_taxonomy&diff=20641Global stores taxonomy2024-03-06T17:37:07Z<p>Aleene: /* Open Street Map */</p>
<hr />
<div>See [[Global taxonomies]] for instructions.<br />
[[Category:Global_Taxonomies]]<br />
== Introduction ==<br />
The stores taxonomy contains a list of locations where products (food products, beauty products, etc.) can be obtained.<br />
<br />
== Store entries ==<br />
An entry in the taxonomy describes a single location. This taxonomy can combine data pulled from various sources: receipts from prices, osm, wikidata, etc or provided by the user (honour system). OFF should be careful not copy to much data already maintained by other parties. And if data is copied, it is to provide a snapshot in time.<br />
=== Receipts ===<br />
[[File:Receipt example.png|thumb|Example of store information on a receipt]]<br />
The basis could be the receipts that users have added on prices. As all OFF data, any information should be backed up by image proofs. In the case for a store, this could be a receipt. The store information available on the receipt can be extracted to the taxonomy. What can be extracted depends on the receipt. In the example shown here, it is possible to extract the store name, the operator (useful for franchises), the address, phone number, siret, naf and tva. Analysus of more receipts might reveal other country specific information.<br />
Hopefully this information is enough to unambiguously identify a store.<br />
<br />
=== Prices ===<br />
The stores taxonomy can be based on [https://prices.openfoodfacts.org/ OFF Prices]. The receipts corresponding to a shop are entered on Prices. Prices has a unique identifier for each shop, which should be used as a linking pin. In addition Prices offers a link with Openstreetmap, which can be used to pull in additional information. Some of this information is already cached by Prices.<br />
=== Open Street Map ===<br />
All stores are linked to [https://www.openstreetmap.org/ Open Street Map] (OSM) through the unique OSM id. The link refers to a basic object in OSM:<br />
* Node - is used to refer to a single location, like [https://www.openstreetmap.org/node/25213337 BP Service];<br />
* (Closed) Way - is used to refer to a building, like [https://www.openstreetmap.org/way/31348922 IKEA];<br />
* Relation - is used to refer multiple ways used by the shop, like [https://www.openstreetmap.org/relation/1235874 Carrefour];<br />
<br />
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. This can be limited to OSM objects that have the tag ''shop''.<br />
<br />
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.<br />
<br />
=== Store brand ===<br />
The current implementation of OFF already supports a field for Stores. It is a free text field where the user can enter whatever s/he wants. A variety of entries is the consequence. But most of all it is used to enter the value for the Store brand, i.e. the name of the store as is shown outside the store and on receipts.<br />
<br />
=== Example Taxonomy Entry===<br />
An example for an entry / location / store / shop in the taxonomy:<br><br />
<nowiki>name:en: Biocoop</nowiki><br><br />
<nowiki>price_id:en: 45</nowiki><br><br />
<nowiki>osm_id:en: 9815975601</nowiki><br><br />
<nowiki>osm_type:en: NODE</nowiki><br><br />
<nowiki>osm_display_name:en: "Biocoop, Rue de Tolbiac, Quartier de la Maison-Blanche, Paris 13e Arrondissement, Paris, Île-de-France, France métropolitaine, 75013, France"</nowiki><br><br />
<nowiki>osm_address_postcode:en: 75013</nowiki><br><br />
<nowiki>osm_address_city:en: en:Paris</nowiki><br><br />
<nowiki>osm_address_country:en: en:france</nowiki><br><br />
<nowiki>osm_lat:en: 48.8259597</nowiki><br><br />
<nowiki>osm_lon:en: 2.3511541</nowiki><br><br />
<br />
== Maintenance ==<br />
The stores taxonomy needs to be regularly updated from the data entered through [https://prices.openfoodfacts.org/ OFF Prices]. This means any changed values and any added entries/<br />
<br />
== Discussion points ==<br />
<br />
* What information should be stored by OFF and what can be left to OSM or Wikidata? <br />
* What to be done with shops that go out of business?<br />
<br />
== Note ==<br />
* We need to associate stores with brands that are sold in thoses stores (Auchan for Auchan…)<br />
* We should try to add Wikidata relations (and thus OSM ones) whenever possible<br />
* Chains - if a store is part of a chain with multiple stores it can be added through a wikidata link<br />
<br />
Moved to GitHub: https://github.com/openfoodfacts/openfoodfacts-server/blob/master/taxonomies/stores.txt</div>Aleenehttps://wiki.openfoodfacts.org/index.php?title=Global_stores_taxonomy&diff=20640Global stores taxonomy2024-03-06T17:32:47Z<p>Aleene: /* Example Taxonomy Entry */</p>
<hr />
<div>See [[Global taxonomies]] for instructions.<br />
[[Category:Global_Taxonomies]]<br />
== Introduction ==<br />
The stores taxonomy contains a list of locations where products (food products, beauty products, etc.) can be obtained.<br />
<br />
== Store entries ==<br />
An entry in the taxonomy describes a single location. This taxonomy can combine data pulled from various sources: receipts from prices, osm, wikidata, etc or provided by the user (honour system). OFF should be careful not copy to much data already maintained by other parties. And if data is copied, it is to provide a snapshot in time.<br />
=== Receipts ===<br />
[[File:Receipt example.png|thumb|Example of store information on a receipt]]<br />
The basis could be the receipts that users have added on prices. As all OFF data, any information should be backed up by image proofs. In the case for a store, this could be a receipt. The store information available on the receipt can be extracted to the taxonomy. What can be extracted depends on the receipt. In the example shown here, it is possible to extract the store name, the operator (useful for franchises), the address, phone number, siret, naf and tva. Analysus of more receipts might reveal other country specific information.<br />
Hopefully this information is enough to unambiguously identify a store.<br />
<br />
=== Prices ===<br />
The stores taxonomy can be based on [https://prices.openfoodfacts.org/ OFF Prices]. The receipts corresponding to a shop are entered on Prices. Prices has a unique identifier for each shop, which should be used as a linking pin. In addition Prices offers a link with Openstreetmap, which can be used to pull in additional information. Some of this information is already cached by Prices.<br />
=== Open Street Map ===<br />
All stores are linked to [https://www.openstreetmap.org/ Open Street Map] (OSM) through the unique OSM id. The link refers to a basic object in OSM:<br />
* Node - is used to refer to a single location, like [https://www.openstreetmap.org/node/25213337 BP Service];<br />
* (Closed) Way - is used to refer to a building, like [https://www.openstreetmap.org/way/31348922 IKEA];<br />
* Relation - is used to refer multiple ways used by the shop, like [https://www.openstreetmap.org/relation/1235874 Carrefour];<br />
<br />
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. This can be limited to OSM objects that have the tag ''shop''.<br />
<br />
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.<br />
<br />
=== Example Taxonomy Entry===<br />
An example for an entry / location / store / shop in the taxonomy:<br><br />
<nowiki>name:en: Biocoop</nowiki><br><br />
<nowiki>price_id:en: 45</nowiki><br><br />
<nowiki>osm_id:en: 9815975601</nowiki><br><br />
<nowiki>osm_type:en: NODE</nowiki><br><br />
<nowiki>osm_display_name:en: "Biocoop, Rue de Tolbiac, Quartier de la Maison-Blanche, Paris 13e Arrondissement, Paris, Île-de-France, France métropolitaine, 75013, France"</nowiki><br><br />
<nowiki>osm_address_postcode:en: 75013</nowiki><br><br />
<nowiki>osm_address_city:en: en:Paris</nowiki><br><br />
<nowiki>osm_address_country:en: en:france</nowiki><br><br />
<nowiki>osm_lat:en: 48.8259597</nowiki><br><br />
<nowiki>osm_lon:en: 2.3511541</nowiki><br><br />
<br />
== Maintenance ==<br />
The stores taxonomy needs to be regularly updated from the data entered through [https://prices.openfoodfacts.org/ OFF Prices]. This means any changed values and any added entries/<br />
<br />
== Discussion points ==<br />
<br />
* What information should be stored by OFF and what can be left to OSM or Wikidata? <br />
* What to be done with shops that go out of business?<br />
<br />
== Note ==<br />
* We need to associate stores with brands that are sold in thoses stores (Auchan for Auchan…)<br />
* We should try to add Wikidata relations (and thus OSM ones) whenever possible<br />
* Chains - if a store is part of a chain with multiple stores it can be added through a wikidata link<br />
<br />
Moved to GitHub: https://github.com/openfoodfacts/openfoodfacts-server/blob/master/taxonomies/stores.txt</div>Aleenehttps://wiki.openfoodfacts.org/index.php?title=Global_stores_taxonomy&diff=20632Global stores taxonomy2024-03-06T12:30:43Z<p>Aleene: /* Example Taxonomy Entry */</p>
<hr />
<div>See [[Global taxonomies]] for instructions.<br />
[[Category:Global_Taxonomies]]<br />
== Introduction ==<br />
The stores taxonomy contains a list of locations where products (food products, beauty products, etc.) can be obtained.<br />
<br />
== Store entries ==<br />
An entry in the taxonomy describes a single location. This taxonomy can combine data pulled from various sources: receipts from prices, osm, wikidata, etc or provided by the user (honour system). OFF should be careful not copy to much data already maintained by other parties. And if data is copied, it is to provide a snapshot in time.<br />
=== Receipts ===<br />
[[File:Receipt example.png|thumb|Example of store information on a receipt]]<br />
The basis could be the receipts that users have added on prices. As all OFF data, any information should be backed up by image proofs. In the case for a store, this could be a receipt. The store information available on the receipt can be extracted to the taxonomy. What can be extracted depends on the receipt. In the example shown here, it is possible to extract the store name, the operator (useful for franchises), the address, phone number, siret, naf and tva. Analysus of more receipts might reveal other country specific information.<br />
Hopefully this information is enough to unambiguously identify a store.<br />
<br />
=== Prices ===<br />
The stores taxonomy can be based on [https://prices.openfoodfacts.org/ OFF Prices]. The receipts corresponding to a shop are entered on Prices. Prices has a unique identifier for each shop, which should be used as a linking pin. In addition Prices offers a link with Openstreetmap, which can be used to pull in additional information. Some of this information is already cached by Prices.<br />
=== Open Street Map ===<br />
All stores are linked to [https://www.openstreetmap.org/ Open Street Map] (OSM) through the unique OSM id. The link refers to a basic object in OSM:<br />
* Node - is used to refer to a single location, like [https://www.openstreetmap.org/node/25213337 BP Service];<br />
* (Closed) Way - is used to refer to a building, like [https://www.openstreetmap.org/way/31348922 IKEA];<br />
* Relation - is used to refer multiple ways used by the shop, like [https://www.openstreetmap.org/relation/1235874 Carrefour];<br />
<br />
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. This can be limited to OSM objects that have the tag ''shop''.<br />
<br />
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.<br />
<br />
=== Example Taxonomy Entry===<br />
An example for an entry / location / store / shop in the taxonomy:<br />
<nowiki>name:en: Biocoop</nowiki><br><br />
<nowiki>price_id:en: 45</nowiki><br><br />
<nowiki>osm_id:en: 9815975601</nowiki><br><br />
<nowiki>osm_type:en: NODE</nowiki><br><br />
<nowiki>osm_display_name:en: "Biocoop, Rue de Tolbiac, Quartier de la Maison-Blanche, Paris 13e Arrondissement, Paris, Île-de-France, France métropolitaine, 75013, France"</nowiki><br><br />
<nowiki>osm_address_postcode:en: 75013</nowiki><br><br />
<nowiki>osm_address_city:en: en:Paris</nowiki><br><br />
<nowiki>osm_address_country:en: en:france</nowiki><br><br />
<nowiki>osm_lat:en: 48.8259597</nowiki><br><br />
<nowiki>osm_lon:en: 2.3511541</nowiki><br><br />
<br />
== Maintenance ==<br />
The stores taxonomy needs to be regularly updated from the data entered through [https://prices.openfoodfacts.org/ OFF Prices]. This means any changed values and any added entries/<br />
<br />
== Discussion points ==<br />
<br />
* What information should be stored by OFF and what can be left to OSM or Wikidata? <br />
* What to be done with shops that go out of business?<br />
<br />
== Note ==<br />
* We need to associate stores with brands that are sold in thoses stores (Auchan for Auchan…)<br />
* We should try to add Wikidata relations (and thus OSM ones) whenever possible<br />
* Chains - if a store is part of a chain with multiple stores it can be added through a wikidata link<br />
<br />
Moved to GitHub: https://github.com/openfoodfacts/openfoodfacts-server/blob/master/taxonomies/stores.txt</div>Aleenehttps://wiki.openfoodfacts.org/index.php?title=Global_stores_taxonomy&diff=20631Global stores taxonomy2024-03-06T12:29:20Z<p>Aleene: /* Example */</p>
<hr />
<div>See [[Global taxonomies]] for instructions.<br />
[[Category:Global_Taxonomies]]<br />
== Introduction ==<br />
The stores taxonomy contains a list of locations where products (food products, beauty products, etc.) can be obtained.<br />
<br />
== Store entries ==<br />
An entry in the taxonomy describes a single location. This taxonomy can combine data pulled from various sources: receipts from prices, osm, wikidata, etc or provided by the user (honour system). OFF should be careful not copy to much data already maintained by other parties. And if data is copied, it is to provide a snapshot in time.<br />
=== Receipts ===<br />
[[File:Receipt example.png|thumb|Example of store information on a receipt]]<br />
The basis could be the receipts that users have added on prices. As all OFF data, any information should be backed up by image proofs. In the case for a store, this could be a receipt. The store information available on the receipt can be extracted to the taxonomy. What can be extracted depends on the receipt. In the example shown here, it is possible to extract the store name, the operator (useful for franchises), the address, phone number, siret, naf and tva. Analysus of more receipts might reveal other country specific information.<br />
Hopefully this information is enough to unambiguously identify a store.<br />
<br />
=== Prices ===<br />
The stores taxonomy can be based on [https://prices.openfoodfacts.org/ OFF Prices]. The receipts corresponding to a shop are entered on Prices. Prices has a unique identifier for each shop, which should be used as a linking pin. In addition Prices offers a link with Openstreetmap, which can be used to pull in additional information. Some of this information is already cached by Prices.<br />
=== Open Street Map ===<br />
All stores are linked to [https://www.openstreetmap.org/ Open Street Map] (OSM) through the unique OSM id. The link refers to a basic object in OSM:<br />
* Node - is used to refer to a single location, like [https://www.openstreetmap.org/node/25213337 BP Service];<br />
* (Closed) Way - is used to refer to a building, like [https://www.openstreetmap.org/way/31348922 IKEA];<br />
* Relation - is used to refer multiple ways used by the shop, like [https://www.openstreetmap.org/relation/1235874 Carrefour];<br />
<br />
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. This can be limited to OSM objects that have the tag ''shop''.<br />
<br />
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.<br />
<br />
=== Example Taxonomy Entry===<br />
An example for an entry / location / store / shop in the taxonomy:<br />
<nowiki>name:en: Biocoop</nowiki><br><br />
<nowiki>osm_id:en: 9815975601</nowiki><br><br />
<nowiki>osm_type:en: NODE</nowiki><br><br />
<nowiki>price_id:en: 45</nowiki><br><br />
<nowiki>osm_display_name:en: "Biocoop, Rue de Tolbiac, Quartier de la Maison-Blanche, Paris 13e Arrondissement, Paris, Île-de-France, France métropolitaine, 75013, France"</nowiki><br><br />
<nowiki>osm_address_postcode:en: 75013</nowiki><br><br />
<nowiki>osm_address_city:en: en:Paris</nowiki><br><br />
<nowiki>osm_address_country:en: en:france</nowiki><br><br />
<nowiki>osm_lat:en: 48.8259597</nowiki><br><br />
<nowiki>osm_lon:en: 2.3511541</nowiki><br><br />
<br />
== Maintenance ==<br />
The stores taxonomy needs to be regularly updated from the data entered through [https://prices.openfoodfacts.org/ OFF Prices]. This means any changed values and any added entries/<br />
<br />
== Discussion points ==<br />
<br />
* What information should be stored by OFF and what can be left to OSM or Wikidata? <br />
* What to be done with shops that go out of business?<br />
<br />
== Note ==<br />
* We need to associate stores with brands that are sold in thoses stores (Auchan for Auchan…)<br />
* We should try to add Wikidata relations (and thus OSM ones) whenever possible<br />
* Chains - if a store is part of a chain with multiple stores it can be added through a wikidata link<br />
<br />
Moved to GitHub: https://github.com/openfoodfacts/openfoodfacts-server/blob/master/taxonomies/stores.txt</div>Aleenehttps://wiki.openfoodfacts.org/index.php?title=Global_stores_taxonomy&diff=20630Global stores taxonomy2024-03-06T12:25:48Z<p>Aleene: /* Open Street Map integration */</p>
<hr />
<div>See [[Global taxonomies]] for instructions.<br />
[[Category:Global_Taxonomies]]<br />
== Introduction ==<br />
The stores taxonomy contains a list of locations where products (food products, beauty products, etc.) can be obtained.<br />
<br />
== Store entries ==<br />
An entry in the taxonomy describes a single location. This taxonomy can combine data pulled from various sources: receipts from prices, osm, wikidata, etc or provided by the user (honour system). OFF should be careful not copy to much data already maintained by other parties. And if data is copied, it is to provide a snapshot in time.<br />
=== Receipts ===<br />
[[File:Receipt example.png|thumb|Example of store information on a receipt]]<br />
The basis could be the receipts that users have added on prices. As all OFF data, any information should be backed up by image proofs. In the case for a store, this could be a receipt. The store information available on the receipt can be extracted to the taxonomy. What can be extracted depends on the receipt. In the example shown here, it is possible to extract the store name, the operator (useful for franchises), the address, phone number, siret, naf and tva. Analysus of more receipts might reveal other country specific information.<br />
Hopefully this information is enough to unambiguously identify a store.<br />
<br />
=== Prices ===<br />
The stores taxonomy can be based on [https://prices.openfoodfacts.org/ OFF Prices]. The receipts corresponding to a shop are entered on Prices. Prices has a unique identifier for each shop, which should be used as a linking pin. In addition Prices offers a link with Openstreetmap, which can be used to pull in additional information. Some of this information is already cached by Prices.<br />
=== Open Street Map ===<br />
All stores are linked to [https://www.openstreetmap.org/ Open Street Map] (OSM) through the unique OSM id. The link refers to a basic object in OSM:<br />
* Node - is used to refer to a single location, like [https://www.openstreetmap.org/node/25213337 BP Service];<br />
* (Closed) Way - is used to refer to a building, like [https://www.openstreetmap.org/way/31348922 IKEA];<br />
* Relation - is used to refer multiple ways used by the shop, like [https://www.openstreetmap.org/relation/1235874 Carrefour];<br />
<br />
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. This can be limited to OSM objects that have the tag ''shop''.<br />
<br />
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.<br />
<br />
=== Example ===<br />
An example for an entry / location / store / shop in the taxonomy:<br />
osm_id:en: [[Tel:9815975601|9815975601]]<br><br />
<nowiki>osm_type:en: NODE</nowiki><br><br />
<nowiki>price_id:en: 45</nowiki><br><br />
<nowiki>osm_name:en: Biocoop</nowiki><br><br />
<nowiki>osm_display_name:en: "Biocoop, Rue de Tolbiac, Quartier de la Maison-Blanche, Paris 13e Arrondissement, Paris, Île-de-France, France métropolitaine, 75013, France"</nowiki><br><br />
<nowiki>osm_address_postcode:en: 75013</nowiki><br><br />
<nowiki>osm_address_city:en: en:Paris</nowiki><br><br />
<nowiki>osm_address_country:en: en:france</nowiki><br><br />
<nowiki>osm_lat:en: 48.8259597</nowiki><br><br />
<nowiki>osm_lon:en: 2.3511541</nowiki><br><br />
<br />
== Maintenance ==<br />
The stores taxonomy needs to be regularly updated from the data entered through [https://prices.openfoodfacts.org/ OFF Prices]. This means any changed values and any added entries/<br />
<br />
== Discussion points ==<br />
<br />
* What information should be stored by OFF and what can be left to OSM or Wikidata? <br />
* What to be done with shops that go out of business?<br />
<br />
== Note ==<br />
* We need to associate stores with brands that are sold in thoses stores (Auchan for Auchan…)<br />
* We should try to add Wikidata relations (and thus OSM ones) whenever possible<br />
* Chains - if a store is part of a chain with multiple stores it can be added through a wikidata link<br />
<br />
Moved to GitHub: https://github.com/openfoodfacts/openfoodfacts-server/blob/master/taxonomies/stores.txt</div>Aleenehttps://wiki.openfoodfacts.org/index.php?title=Global_stores_taxonomy&diff=20629Global stores taxonomy2024-03-06T11:23:02Z<p>Aleene: /* Open Street Map integration */</p>
<hr />
<div>See [[Global taxonomies]] for instructions.<br />
[[Category:Global_Taxonomies]]<br />
== Introduction ==<br />
The stores taxonomy contains a list of locations where products (food products, beauty products, etc.) can be obtained.<br />
<br />
== Store entries ==<br />
An entry in the taxonomy describes a single location. This taxonomy can combine data pulled from various sources: receipts from prices, osm, wikidata, etc or provided by the user (honour system). OFF should be careful not copy to much data already maintained by other parties. And if data is copied, it is to provide a snapshot in time.<br />
=== Receipts ===<br />
[[File:Receipt example.png|thumb|Example of store information on a receipt]]<br />
The basis could be the receipts that users have added on prices. As all OFF data, any information should be backed up by image proofs. In the case for a store, this could be a receipt. The store information available on the receipt can be extracted to the taxonomy. What can be extracted depends on the receipt. In the example shown here, it is possible to extract the store name, the operator (useful for franchises), the address, phone number, siret, naf and tva. Analysus of more receipts might reveal other country specific information.<br />
Hopefully this information is enough to unambiguously identify a store.<br />
<br />
=== Prices ===<br />
The stores taxonomy can be based on [https://prices.openfoodfacts.org/ OFF Prices]. The receipts corresponding to a shop are entered on Prices. Prices has a unique identifier for each shop, which should be used as a linking pin. In addition Prices offers a link with Openstreetmap, which can be used to pull in additional information. Some of this information is already cached by Prices.<br />
=== Open Street Map integration ===<br />
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:<br />
* Node - is used to refer to a single location, like [https://www.openstreetmap.org/node/25213337 BP Service];<br />
* Way - is used to refer to a building, like [https://www.openstreetmap.org/way/31348922 IKEA];<br />
* Relation - is used to refer multiple ways used by the shop, like [https://www.openstreetmap.org/relation/1235874 Carrefour];<br />
<br />
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. This can be limited to OSM objects that have the tag ''shop''.<br />
<br />
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.<br />
<br />
=== Example ===<br />
An example for an entry / location / store / shop in the taxonomy:<br />
osm_id:en: [[Tel:9815975601|9815975601]]<br><br />
<nowiki>osm_type:en: NODE</nowiki><br><br />
<nowiki>price_id:en: 45</nowiki><br><br />
<nowiki>osm_name:en: Biocoop</nowiki><br><br />
<nowiki>osm_display_name:en: "Biocoop, Rue de Tolbiac, Quartier de la Maison-Blanche, Paris 13e Arrondissement, Paris, Île-de-France, France métropolitaine, 75013, France"</nowiki><br><br />
<nowiki>osm_address_postcode:en: 75013</nowiki><br><br />
<nowiki>osm_address_city:en: en:Paris</nowiki><br><br />
<nowiki>osm_address_country:en: en:france</nowiki><br><br />
<nowiki>osm_lat:en: 48.8259597</nowiki><br><br />
<nowiki>osm_lon:en: 2.3511541</nowiki><br><br />
<br />
== Maintenance ==<br />
The stores taxonomy needs to be regularly updated from the data entered through [https://prices.openfoodfacts.org/ OFF Prices]. This means any changed values and any added entries/<br />
<br />
== Discussion points ==<br />
<br />
* What information should be stored by OFF and what can be left to OSM or Wikidata? <br />
* What to be done with shops that go out of business?<br />
<br />
== Note ==<br />
* We need to associate stores with brands that are sold in thoses stores (Auchan for Auchan…)<br />
* We should try to add Wikidata relations (and thus OSM ones) whenever possible<br />
* Chains - if a store is part of a chain with multiple stores it can be added through a wikidata link<br />
<br />
Moved to GitHub: https://github.com/openfoodfacts/openfoodfacts-server/blob/master/taxonomies/stores.txt</div>Aleenehttps://wiki.openfoodfacts.org/index.php?title=Global_stores_taxonomy&diff=20628Global stores taxonomy2024-03-06T11:22:42Z<p>Aleene: /* Prices */</p>
<hr />
<div>See [[Global taxonomies]] for instructions.<br />
[[Category:Global_Taxonomies]]<br />
== Introduction ==<br />
The stores taxonomy contains a list of locations where products (food products, beauty products, etc.) can be obtained.<br />
<br />
== Store entries ==<br />
An entry in the taxonomy describes a single location. This taxonomy can combine data pulled from various sources: receipts from prices, osm, wikidata, etc or provided by the user (honour system). OFF should be careful not copy to much data already maintained by other parties. And if data is copied, it is to provide a snapshot in time.<br />
=== Receipts ===<br />
[[File:Receipt example.png|thumb|Example of store information on a receipt]]<br />
The basis could be the receipts that users have added on prices. As all OFF data, any information should be backed up by image proofs. In the case for a store, this could be a receipt. The store information available on the receipt can be extracted to the taxonomy. What can be extracted depends on the receipt. In the example shown here, it is possible to extract the store name, the operator (useful for franchises), the address, phone number, siret, naf and tva. Analysus of more receipts might reveal other country specific information.<br />
Hopefully this information is enough to unambiguously identify a store.<br />
<br />
=== Prices ===<br />
The stores taxonomy can be based on [https://prices.openfoodfacts.org/ OFF Prices]. The receipts corresponding to a shop are entered on Prices. Prices has a unique identifier for each shop, which should be used as a linking pin. In addition Prices offers a link with Openstreetmap, which can be used to pull in additional information. Some of this information is already cached by Prices.<br />
=== Open Street Map integration ===<br />
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:<br />
* Node - is used to refer to a single location, like [https://www.openstreetmap.org/node/25213337 BP Service];<br />
* Way - is used to refer to a building, like [https://www.openstreetmap.org/way/31348922 IKEA];<br />
* Relation - is used to refer multiple ways used by the shop, like [https://www.openstreetmap.org/relation/1235874 Carrefour];<br />
<br />
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. This can be limited to OSM objects that have the tag ''shop''.<br />
<br />
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.<br />
<br />
=== Example ===<br />
An example for an entry / location / store / shop in the taxonomy:<br />
osm_id:en: [[Tel:9815975601|9815975601]]<br><br />
<nowiki>osm_type:en: NODE</nowiki><br><br />
<nowiki>price_id:en: 45</nowiki><br><br />
<nowiki>osm_name:en: Biocoop</nowiki><br><br />
<nowiki>osm_display_name:en: "Biocoop, Rue de Tolbiac, Quartier de la Maison-Blanche, Paris 13e Arrondissement, Paris, Île-de-France, France métropolitaine, 75013, France"</nowiki><br><br />
<nowiki>osm_address_postcode:en: 75013</nowiki><br><br />
<nowiki>osm_address_city:en: en:Paris</nowiki><br><br />
<nowiki>osm_address_country:en: en:france</nowiki><br><br />
<nowiki>osm_lat:en: 48.8259597</nowiki><br><br />
<nowiki>osm_lon:en: 2.3511541</nowiki><br><br />
<br />
== Open Street Map integration ==<br />
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:<br />
* Node - is used to refer to a single location, like [https://www.openstreetmap.org/node/25213337 BP Service];<br />
* Way - is used to refer to a building, like [https://www.openstreetmap.org/way/31348922 IKEA];<br />
* Relation - is used to refer multiple ways used by the shop, like [https://www.openstreetmap.org/relation/1235874 Carrefour];<br />
<br />
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. This can be limited to OSM objects that have the tag ''shop''.<br />
<br />
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.<br />
<br />
== Maintenance ==<br />
The stores taxonomy needs to be regularly updated from the data entered through [https://prices.openfoodfacts.org/ OFF Prices]. This means any changed values and any added entries/<br />
<br />
== Discussion points ==<br />
<br />
* What information should be stored by OFF and what can be left to OSM or Wikidata? <br />
* What to be done with shops that go out of business?<br />
<br />
== Note ==<br />
* We need to associate stores with brands that are sold in thoses stores (Auchan for Auchan…)<br />
* We should try to add Wikidata relations (and thus OSM ones) whenever possible<br />
* Chains - if a store is part of a chain with multiple stores it can be added through a wikidata link<br />
<br />
Moved to GitHub: https://github.com/openfoodfacts/openfoodfacts-server/blob/master/taxonomies/stores.txt</div>Aleenehttps://wiki.openfoodfacts.org/index.php?title=Global_stores_taxonomy&diff=20627Global stores taxonomy2024-03-06T11:21:42Z<p>Aleene: /* Prices */</p>
<hr />
<div>See [[Global taxonomies]] for instructions.<br />
[[Category:Global_Taxonomies]]<br />
== Introduction ==<br />
The stores taxonomy contains a list of locations where products (food products, beauty products, etc.) can be obtained.<br />
<br />
== Store entries ==<br />
An entry in the taxonomy describes a single location. This taxonomy can combine data pulled from various sources: receipts from prices, osm, wikidata, etc or provided by the user (honour system). OFF should be careful not copy to much data already maintained by other parties. And if data is copied, it is to provide a snapshot in time.<br />
=== Receipts ===<br />
[[File:Receipt example.png|thumb|Example of store information on a receipt]]<br />
The basis could be the receipts that users have added on prices. As all OFF data, any information should be backed up by image proofs. In the case for a store, this could be a receipt. The store information available on the receipt can be extracted to the taxonomy. What can be extracted depends on the receipt. In the example shown here, it is possible to extract the store name, the operator (useful for franchises), the address, phone number, siret, naf and tva. Analysus of more receipts might reveal other country specific information.<br />
Hopefully this information is enough to unambiguously identify a store.<br />
<br />
=== Prices ===<br />
The stores taxonomy can be based on [https://prices.openfoodfacts.org/ OFF Prices]. The receipts corresponding to a shop are entered on Prices. Prices has a unique identifier for each shop, which should be used as a linking pin. In addition Prices offers a link with Openstreetmap, which can be used to pull in additional information. Some of this information is already cached by Prices.<br />
<br />
=== Example ===<br />
An example for an entry / location / store / shop in the taxonomy:<br />
osm_id:en: [[Tel:9815975601|9815975601]]<br><br />
<nowiki>osm_type:en: NODE</nowiki><br><br />
<nowiki>price_id:en: 45</nowiki><br><br />
<nowiki>osm_name:en: Biocoop</nowiki><br><br />
<nowiki>osm_display_name:en: "Biocoop, Rue de Tolbiac, Quartier de la Maison-Blanche, Paris 13e Arrondissement, Paris, Île-de-France, France métropolitaine, 75013, France"</nowiki><br><br />
<nowiki>osm_address_postcode:en: 75013</nowiki><br><br />
<nowiki>osm_address_city:en: en:Paris</nowiki><br><br />
<nowiki>osm_address_country:en: en:france</nowiki><br><br />
<nowiki>osm_lat:en: 48.8259597</nowiki><br><br />
<nowiki>osm_lon:en: 2.3511541</nowiki><br><br />
<br />
== Open Street Map integration ==<br />
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:<br />
* Node - is used to refer to a single location, like [https://www.openstreetmap.org/node/25213337 BP Service];<br />
* Way - is used to refer to a building, like [https://www.openstreetmap.org/way/31348922 IKEA];<br />
* Relation - is used to refer multiple ways used by the shop, like [https://www.openstreetmap.org/relation/1235874 Carrefour];<br />
<br />
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. This can be limited to OSM objects that have the tag ''shop''.<br />
<br />
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.<br />
<br />
== Maintenance ==<br />
The stores taxonomy needs to be regularly updated from the data entered through [https://prices.openfoodfacts.org/ OFF Prices]. This means any changed values and any added entries/<br />
<br />
== Discussion points ==<br />
<br />
* What information should be stored by OFF and what can be left to OSM or Wikidata? <br />
* What to be done with shops that go out of business?<br />
<br />
== Note ==<br />
* We need to associate stores with brands that are sold in thoses stores (Auchan for Auchan…)<br />
* We should try to add Wikidata relations (and thus OSM ones) whenever possible<br />
* Chains - if a store is part of a chain with multiple stores it can be added through a wikidata link<br />
<br />
Moved to GitHub: https://github.com/openfoodfacts/openfoodfacts-server/blob/master/taxonomies/stores.txt</div>Aleenehttps://wiki.openfoodfacts.org/index.php?title=Global_stores_taxonomy&diff=20626Global stores taxonomy2024-03-06T11:17:20Z<p>Aleene: /* Prices */</p>
<hr />
<div>See [[Global taxonomies]] for instructions.<br />
[[Category:Global_Taxonomies]]<br />
== Introduction ==<br />
The stores taxonomy contains a list of locations where products (food products, beauty products, etc.) can be obtained.<br />
<br />
== Store entries ==<br />
An entry in the taxonomy describes a single location. This taxonomy can combine data pulled from various sources: receipts from prices, osm, wikidata, etc or provided by the user (honour system). OFF should be careful not copy to much data already maintained by other parties. And if data is copied, it is to provide a snapshot in time.<br />
=== Receipts ===<br />
[[File:Receipt example.png|thumb|Example of store information on a receipt]]<br />
The basis could be the receipts that users have added on prices. As all OFF data, any information should be backed up by image proofs. In the case for a store, this could be a receipt. The store information available on the receipt can be extracted to the taxonomy. What can be extracted depends on the receipt. In the example shown here, it is possible to extract the store name, the operator (useful for franchises), the address, phone number, siret, naf and tva. Analysus of more receipts might reveal other country specific information.<br />
Hopefully this information is enough to unambiguously identify a store.<br />
<br />
=== Prices ===<br />
The stores taxonomy can be based on [https://prices.openfoodfacts.org/ OFF Prices]<br />
<br />
=== Example ===<br />
An example for an entry / location / store / shop in the taxonomy:<br />
osm_id:en: [[Tel:9815975601|9815975601]]<br><br />
<nowiki>osm_type:en: NODE</nowiki><br><br />
<nowiki>price_id:en: 45</nowiki><br><br />
<nowiki>osm_name:en: Biocoop</nowiki><br><br />
<nowiki>osm_display_name:en: "Biocoop, Rue de Tolbiac, Quartier de la Maison-Blanche, Paris 13e Arrondissement, Paris, Île-de-France, France métropolitaine, 75013, France"</nowiki><br><br />
<nowiki>osm_address_postcode:en: 75013</nowiki><br><br />
<nowiki>osm_address_city:en: en:Paris</nowiki><br><br />
<nowiki>osm_address_country:en: en:france</nowiki><br><br />
<nowiki>osm_lat:en: 48.8259597</nowiki><br><br />
<nowiki>osm_lon:en: 2.3511541</nowiki><br><br />
<br />
== Open Street Map integration ==<br />
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:<br />
* Node - is used to refer to a single location, like [https://www.openstreetmap.org/node/25213337 BP Service];<br />
* Way - is used to refer to a building, like [https://www.openstreetmap.org/way/31348922 IKEA];<br />
* Relation - is used to refer multiple ways used by the shop, like [https://www.openstreetmap.org/relation/1235874 Carrefour];<br />
<br />
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. This can be limited to OSM objects that have the tag ''shop''.<br />
<br />
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.<br />
<br />
== Maintenance ==<br />
The stores taxonomy needs to be regularly updated from the data entered through [https://prices.openfoodfacts.org/ OFF Prices]. This means any changed values and any added entries/<br />
<br />
== Discussion points ==<br />
<br />
* What information should be stored by OFF and what can be left to OSM or Wikidata? <br />
* What to be done with shops that go out of business?<br />
<br />
== Note ==<br />
* We need to associate stores with brands that are sold in thoses stores (Auchan for Auchan…)<br />
* We should try to add Wikidata relations (and thus OSM ones) whenever possible<br />
* Chains - if a store is part of a chain with multiple stores it can be added through a wikidata link<br />
<br />
Moved to GitHub: https://github.com/openfoodfacts/openfoodfacts-server/blob/master/taxonomies/stores.txt</div>Aleenehttps://wiki.openfoodfacts.org/index.php?title=Global_stores_taxonomy&diff=20625Global stores taxonomy2024-03-06T10:51:07Z<p>Aleene: /* Receipts */</p>
<hr />
<div>See [[Global taxonomies]] for instructions.<br />
[[Category:Global_Taxonomies]]<br />
== Introduction ==<br />
The stores taxonomy contains a list of locations where products (food products, beauty products, etc.) can be obtained.<br />
<br />
== Store entries ==<br />
An entry in the taxonomy describes a single location. This taxonomy can combine data pulled from various sources: receipts from prices, osm, wikidata, etc or provided by the user (honour system). OFF should be careful not copy to much data already maintained by other parties. And if data is copied, it is to provide a snapshot in time.<br />
=== Receipts ===<br />
[[File:Receipt example.png|thumb|Example of store information on a receipt]]<br />
The basis could be the receipts that users have added on prices. As all OFF data, any information should be backed up by image proofs. In the case for a store, this could be a receipt. The store information available on the receipt can be extracted to the taxonomy. What can be extracted depends on the receipt. In the example shown here, it is possible to extract the store name, the operator (useful for franchises), the address, phone number, siret, naf and tva. Analysus of more receipts might reveal other country specific information.<br />
Hopefully this information is enough to unambiguously identify a store.<br />
<br />
=== Prices ===<br />
The possible fields used follow the data structure used by [https://prices.openfoodfacts.org/ OFF Prices] and describes a single location:<br />
* id - a unique identifier (as defined by OFF Prices)<br />
* osm_id - the corresponding node(only?) in OpenStreetMap<br />
* name - a long name<br />
* postcode - the postcode<br />
* city - the city<br />
* country - the country tag<br />
* lat - the latitude<br />
* lon - the longitude<br />
<br />
=== Example ===<br />
An example for an entry / location / store / shop in the taxonomy:<br />
osm_id:en: [[Tel:9815975601|9815975601]]<br><br />
<nowiki>osm_type:en: NODE</nowiki><br><br />
<nowiki>price_id:en: 45</nowiki><br><br />
<nowiki>osm_name:en: Biocoop</nowiki><br><br />
<nowiki>osm_display_name:en: "Biocoop, Rue de Tolbiac, Quartier de la Maison-Blanche, Paris 13e Arrondissement, Paris, Île-de-France, France métropolitaine, 75013, France"</nowiki><br><br />
<nowiki>osm_address_postcode:en: 75013</nowiki><br><br />
<nowiki>osm_address_city:en: en:Paris</nowiki><br><br />
<nowiki>osm_address_country:en: en:france</nowiki><br><br />
<nowiki>osm_lat:en: 48.8259597</nowiki><br><br />
<nowiki>osm_lon:en: 2.3511541</nowiki><br><br />
<br />
== Open Street Map integration ==<br />
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:<br />
* Node - is used to refer to a single location, like [https://www.openstreetmap.org/node/25213337 BP Service];<br />
* Way - is used to refer to a building, like [https://www.openstreetmap.org/way/31348922 IKEA];<br />
* Relation - is used to refer multiple ways used by the shop, like [https://www.openstreetmap.org/relation/1235874 Carrefour];<br />
<br />
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. This can be limited to OSM objects that have the tag ''shop''.<br />
<br />
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.<br />
<br />
== Maintenance ==<br />
The stores taxonomy needs to be regularly updated from the data entered through [https://prices.openfoodfacts.org/ OFF Prices]. This means any changed values and any added entries/<br />
<br />
== Discussion points ==<br />
<br />
* What information should be stored by OFF and what can be left to OSM or Wikidata? <br />
* What to be done with shops that go out of business?<br />
<br />
== Note ==<br />
* We need to associate stores with brands that are sold in thoses stores (Auchan for Auchan…)<br />
* We should try to add Wikidata relations (and thus OSM ones) whenever possible<br />
* Chains - if a store is part of a chain with multiple stores it can be added through a wikidata link<br />
<br />
Moved to GitHub: https://github.com/openfoodfacts/openfoodfacts-server/blob/master/taxonomies/stores.txt</div>Aleenehttps://wiki.openfoodfacts.org/index.php?title=Global_stores_taxonomy&diff=20624Global stores taxonomy2024-03-06T10:48:20Z<p>Aleene: /* Proofs */</p>
<hr />
<div>See [[Global taxonomies]] for instructions.<br />
[[Category:Global_Taxonomies]]<br />
== Introduction ==<br />
The stores taxonomy contains a list of locations where products (food products, beauty products, etc.) can be obtained.<br />
<br />
== Store entries ==<br />
An entry in the taxonomy describes a single location. This taxonomy can combine data pulled from various sources: receipts from prices, osm, wikidata, etc or provided by the user (honour system). OFF should be careful not copy to much data already maintained by other parties. And if data is copied, it is to provide a snapshot in time.<br />
=== Receipts ===<br />
[[File:Receipt example.png|thumb|Example of store information on a receipt]]<br />
The basis could be the receipts that users have added on prices. As all OFF data, any information should be backed up by image proofs. In the case for a store, this could be a receipt. The store information available on the receipt can be extracted to the taxonomy. What can be extracted depends on the receipt. In the example shown here, it is possible to extract the store name, the operator (useful for franchises), the address, phone number, siret, naf and tva. Hopefully this information is enough to unambiguously identify a store.<br />
=== Prices ===<br />
The possible fields used follow the data structure used by [https://prices.openfoodfacts.org/ OFF Prices] and describes a single location:<br />
* id - a unique identifier (as defined by OFF Prices)<br />
* osm_id - the corresponding node(only?) in OpenStreetMap<br />
* name - a long name<br />
* postcode - the postcode<br />
* city - the city<br />
* country - the country tag<br />
* lat - the latitude<br />
* lon - the longitude<br />
<br />
=== Example ===<br />
An example for an entry / location / store / shop in the taxonomy:<br />
osm_id:en: [[Tel:9815975601|9815975601]]<br><br />
<nowiki>osm_type:en: NODE</nowiki><br><br />
<nowiki>price_id:en: 45</nowiki><br><br />
<nowiki>osm_name:en: Biocoop</nowiki><br><br />
<nowiki>osm_display_name:en: "Biocoop, Rue de Tolbiac, Quartier de la Maison-Blanche, Paris 13e Arrondissement, Paris, Île-de-France, France métropolitaine, 75013, France"</nowiki><br><br />
<nowiki>osm_address_postcode:en: 75013</nowiki><br><br />
<nowiki>osm_address_city:en: en:Paris</nowiki><br><br />
<nowiki>osm_address_country:en: en:france</nowiki><br><br />
<nowiki>osm_lat:en: 48.8259597</nowiki><br><br />
<nowiki>osm_lon:en: 2.3511541</nowiki><br><br />
<br />
== Open Street Map integration ==<br />
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:<br />
* Node - is used to refer to a single location, like [https://www.openstreetmap.org/node/25213337 BP Service];<br />
* Way - is used to refer to a building, like [https://www.openstreetmap.org/way/31348922 IKEA];<br />
* Relation - is used to refer multiple ways used by the shop, like [https://www.openstreetmap.org/relation/1235874 Carrefour];<br />
<br />
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. This can be limited to OSM objects that have the tag ''shop''.<br />
<br />
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.<br />
<br />
== Maintenance ==<br />
The stores taxonomy needs to be regularly updated from the data entered through [https://prices.openfoodfacts.org/ OFF Prices]. This means any changed values and any added entries/<br />
<br />
== Discussion points ==<br />
<br />
* What information should be stored by OFF and what can be left to OSM or Wikidata? <br />
* What to be done with shops that go out of business?<br />
<br />
== Note ==<br />
* We need to associate stores with brands that are sold in thoses stores (Auchan for Auchan…)<br />
* We should try to add Wikidata relations (and thus OSM ones) whenever possible<br />
* Chains - if a store is part of a chain with multiple stores it can be added through a wikidata link<br />
<br />
Moved to GitHub: https://github.com/openfoodfacts/openfoodfacts-server/blob/master/taxonomies/stores.txt</div>Aleenehttps://wiki.openfoodfacts.org/index.php?title=Global_stores_taxonomy&diff=20623Global stores taxonomy2024-03-06T10:42:04Z<p>Aleene: /* Store entries */</p>
<hr />
<div>See [[Global taxonomies]] for instructions.<br />
[[Category:Global_Taxonomies]]<br />
== Introduction ==<br />
The stores taxonomy contains a list of locations where products (food products, beauty products, etc.) can be obtained.<br />
<br />
== Store entries ==<br />
An entry in the taxonomy describes a single location. This taxonomy can combine data pulled from various sources: receipts from prices, osm, wikidata, etc or provided by the user (honour system). OFF should be careful not copy to much data already maintained by other parties. And if data is copied, it is to provide a snapshot in time.<br />
=== Proofs ===<br />
[[File:Receipt example.png|thumb|Example of store information on a receipt]]<br />
The basis could be the receipts that users have added on prices. As all OFF data, any information should be backed up by image proofs. In the case for a store, this could be a receipt. The store information available on the receipt can be extracted to the taxonomy. Hopefully this information is enough to unambiguously identify a store.<br />
=== Prices ===<br />
The possible fields used follow the data structure used by [https://prices.openfoodfacts.org/ OFF Prices] and describes a single location:<br />
* id - a unique identifier (as defined by OFF Prices)<br />
* osm_id - the corresponding node(only?) in OpenStreetMap<br />
* name - a long name<br />
* postcode - the postcode<br />
* city - the city<br />
* country - the country tag<br />
* lat - the latitude<br />
* lon - the longitude<br />
<br />
=== Example ===<br />
An example for an entry / location / store / shop in the taxonomy:<br />
<nowiki>osm_id:en: 9815975601</nowiki><br><br />
<nowiki>osm_type:en: NODE</nowiki><br><br />
<nowiki>price_id:en: 45</nowiki><br><br />
<nowiki>osm_name:en: Biocoop</nowiki><br><br />
<nowiki>osm_display_name:en: "Biocoop, Rue de Tolbiac, Quartier de la Maison-Blanche, Paris 13e Arrondissement, Paris, Île-de-France, France métropolitaine, 75013, France"</nowiki><br><br />
<nowiki>osm_address_postcode:en: 75013</nowiki><br><br />
<nowiki>osm_address_city:en: en:Paris</nowiki><br><br />
<nowiki>osm_address_country:en: en:france</nowiki><br><br />
<nowiki>osm_lat:en: 48.8259597</nowiki><br><br />
<nowiki>osm_lon:en: 2.3511541</nowiki><br><br />
<br />
== Open Street Map integration ==<br />
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:<br />
* Node - is used to refer to a single location, like [https://www.openstreetmap.org/node/25213337 BP Service];<br />
* Way - is used to refer to a building, like [https://www.openstreetmap.org/way/31348922 IKEA];<br />
* Relation - is used to refer multiple ways used by the shop, like [https://www.openstreetmap.org/relation/1235874 Carrefour];<br />
<br />
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. This can be limited to OSM objects that have the tag ''shop''.<br />
<br />
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.<br />
<br />
== Maintenance ==<br />
The stores taxonomy needs to be regularly updated from the data entered through [https://prices.openfoodfacts.org/ OFF Prices]. This means any changed values and any added entries/<br />
<br />
== Discussion points ==<br />
<br />
* What information should be stored by OFF and what can be left to OSM or Wikidata? <br />
* What to be done with shops that go out of business?<br />
<br />
== Note ==<br />
* We need to associate stores with brands that are sold in thoses stores (Auchan for Auchan…)<br />
* We should try to add Wikidata relations (and thus OSM ones) whenever possible<br />
* Chains - if a store is part of a chain with multiple stores it can be added through a wikidata link<br />
<br />
Moved to GitHub: https://github.com/openfoodfacts/openfoodfacts-server/blob/master/taxonomies/stores.txt</div>Aleene