> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://documentation.ma-cantine.agriculture.gouv.fr/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Réutiliser les données ma cantine

### En bref
* Les données de *ma cantine* sont ouvertes et réutilisables, et nous sommes ravis qu'elles soient reprises dans des projets d'intérêt public.
* *ma cantine* met à disposition deux jeux de données ouverts : le **Registre National des Cantines** (qui existe, où, de quel type) et les **Résultats de campagnes de télédéclaration** (ce que chaque établissement a déclaré).
* **Les données d'achats des établissements sont confidentielles.** **_ma cantine_** **ne publie que des pourcentages.**
* Ces pourcentages sont exacts pour chaque établissement, mais **ils ne peuvent pas être additionnés ni moyennés** pour obtenir un taux sur un territoire.
* Pour obtenir un taux fiable sur un territoire, un secteur ou un autre périmètre, utilisez [l'Observatoire EGalim](https://ma-cantine.agriculture.gouv.fr/v2/observatoire) ou son[ API Statistiques](https://ma-cantine.agriculture.gouv.fr/swagger-ui/#/Statistiques). Ils calculent le pourcentage en interne et ne livrent que le résultat.

### 1. Les sources disponibles et leurs usages
| Votre besoin | Source adaptée | Pourquoi |
| ---- | ---- | ---- |
| Savoir **quels établissements existent**, où ils se situent, de quel type ils sont | [Jeu de données « Registre National des Cantines »](https://www.data.gouv.fr/datasets/registre-national-des-cantines) | Le registre recense les établissements inscrits sur ma cantine. Il ne contient pas de résultats d'achats. |
| Afficher le résultat **d'un établissement précis** | [Jeu de données « Résultats de campagnes de télédéclaration des cantines »](https://www.data.gouv.fr/datasets/resultats-de-campagnes-de-teledeclaration-des-cantines) | Le pourcentage d'un établissement se lit tel quel. |
| Obtenir **un taux sur un périmètre** (commune, territoire, secteur, etc.) | [Observatoire EGalim en restauration collective](https://ma-cantine.agriculture.gouv.fr/v2/observatoire) | Le pourcentage est calculé à partir des totaux d'achats du périmètre. |
| **Automatiser** la récupération de ces taux dans votre outil | [API Statistiques](https://ma-cantine.agriculture.gouv.fr/swagger-ui/#/Statistiques) | Idem |

### 2. Le Registre National des Cantines : à quoi il sert, et ses limites
Le registre répond à la question « quels établissements de restauration collective sont inscrits sur ma cantine ? ». Il est utile pour cartographier les établissements d'un territoire ou compter les établissements par type ou par secteur.
⇒ Consulter le [Jeu de données « Registre National des Cantines »](https://www.data.gouv.fr/datasets/registre-national-des-cantines)

### 3. Résultats de campagnes de télédéclaration des cantines : à quoi il sert, et ses limites
Ce jeu de données publie, pour chaque établissement ayant télédéclaré, les pourcentages qu'il a déclarés lors d'une campagne. Il sert à afficher **le résultat d'un établissement précis** ou comparer **un établissement à lui-même** d'une campagne à l'autre.
Limites :
* **Les pourcentages ne s'agrègent pas.** Il est impossible de les additionner ni de les moyenner pour obtenir un taux sur un territoire. Un pourcentage ne dit rien du poids de l'établissement :
| Établissement | Achats totaux (€ HT) | Achats bio (€ HT) | Part de bio |
| ---- | ---- | ---- | ---- |
| A | 10 000 | 5 000 | 50 % |
| B | 1 000 000 | 100 000 | 10 % |
* Moyenne des pourcentages (erronée) : (50 + 10) / 2 = **30 %**
* Taux réel du périmètre : 105 000 / 1 010 000 = **environ 10,4 %**
Le calcul correct est pondéré par les montants d'achats. Ces montants sont confidentiels et absents du jeu de données.
* **Seuls les établissements ayant télédéclaré figurent dans le jeu.** Les résultats ne reflètent donc pas tous les établissements inscrits au registre.
* **Les données sont déclaratives** et rattachées à une année de campagne. Indiquez toujours l'année et la source.
* Évitez de vous basez sur le nombres de couvert pour les télédéclaration antérieur à la télédéclaration 2027
⇒ Consulter le [Jeu de données « Résultats de campagnes de télédéclaration des cantines »](https://www.data.gouv.fr/datasets/resultats-de-campagnes-de-teledeclaration-des-cantines)

### 4. L'API Statistiques
L'API Statistiques donne accès, par programme, aux **pourcentages calculés par l**[**'Observatoire EGalim**](https://ma-cantine.agriculture.gouv.fr/v2/observatoire). Pour un périmètre donné, ma cantine calcule le taux à partir des totaux d'achats des établissements concernés, puis ne renvoie que le résultat. Les montants d'achats ne sortent jamais.
Elle est utile pour obtenir un taux sur un périmètre (territoire, secteur, etc.) ou si vous voulez actualiser automatiquement ces taux, par exemple à chaque campagne ou pour de nombreux territoires.

**Exemple de réutilisation :** l'Écolab publie [le taux d'approvisionnement en produits biologiques par commune](https://ecologie.data.gouv.fr/indicators/taux-dapprovisionnement-en-produits-biologiques-dans-la-restauration-collective) (tous secteurs confondus) en interrogeant cette API.
⇒ Consulter l’[API Statistiques](https://ma-cantine.agriculture.gouv.fr/swagger-ui/#/Statistiques)

| Un projet de réutilisation, une question sur nos données, ou simplement l'envie de nous montrer ce que vous en avez fait ? [Contactez-nous via notre formulaire](https://ma-cantine.agriculture.gouv.fr/v2/contact) : nous aimons savoir où, comment et pour qui ces données sont utiles.