spb/resto-ka

1# OpenStreetMap (découverte) — connecteur `osm`23_Fiche générée automatiquement par `scripts/gen_connector_docs.py` le 2026-08-18 06:06 — ne pas éditer à la main, régénérer._45**État : actif** · Palier (tier) : 4 · Backend : direct · Restos actifs : 13969/1396967## Description de la source89Connecteur de DÉCOUVERTE OpenStreetMap (Palier 4) — TOUS les établissements où l'on mange au Québec : restaurants, fast-foods, cafés, bars/pubs, crèmeries, foires alimentaires, boulangeries- pâtisseries. C'est la couche « exhaustivité » de Resto·Ka : des milliers de fiches (nom, adresse, GPS, cuisine, horaires, contact), SANS menu — les connecteurs de menus (UEAT…) viennent s'y greffer par déduplication. Mode d'extraction : API Overpass (miroirs publics, requêtes par type d'établissement, aire administrative « Québec » 3600061549). Base légale : données © contributeurs OpenStreetMap, licence ODbL — attribution affichée sur le site (pages Sources et pied de page). Politesse : 1 requête par type, timeout large, miroirs en rotation. Contexte de prix produit : AUCUN (pas de menu — fiche de découverte).1011- **Plateforme** : overpass · **Site** : https://www.openstreetmap.org12- **Extraction (registre)** : API Overpass (aire administrative Québec), nœuds + chemins : restaurant, fast_food, cafe, bar, pub, ice_cream, food_court, bakery, pastry — nom, adresse, GPS, cuisine, horaires, contact. Pas de menus (couche d'exhaustivité, les connecteurs de menus s'y greffent par déduplication).13- **Contexte de prix** : —14- **Module** : `restoka/connectors/osm.py` — `OsmConnector`1516## Accès1718- **Type d'accès** : API Overpass (OpenStreetMap)19- **Endpoint de base** : https://overpass.kumi.systems/api/interpreter20- **URLs du module** : https://overpass.kumi.systems/api/interpreter · https://overpass-api.de/api/interpreter · https://overpass.private.coffee/api/interpreter · https://overpass.osm.jp/api/interpreter21- **Pagination** : itération sur 4 racines (constante `MIRRORS`)22- **Backend anti-bot / rendu** : requests direct (session UA RestoKaBot, throttling poli)23- **Politesse** : 3.0 s entre requêtes, timeout 240 s, UA `RestoKaBot/1.0 (+https://www.resto-ka.com/bot)`24- **Authentification** : aucune — accès public/anonyme2526## Champs récupérés → schéma cible2728Le connecteur alimente la table `restaurants` (et `menus` le cas échéant). Complétude mesurée en SQL sur les 13969 fiches actives ; exemple tiré d'une ligne réelle de la BD.2930| Colonne `restaurants` | Contenu | Renseignée (actives) | Exemple réel |31|---|---|---|---|32| `name` | Nom de l'établissement | 100 % | Piazza Romana |33| `chain` | Chaîne / bannière | 21 % | — |34| `cuisines` | Cuisines (JSON, taxonomie §6.1) | 100 % | ["autre"] |35| `establishment_type` | Type d'établissement | 100 % | restaurant |36| `price_range` | Fourchette de prix | 0 % | — |37| `address` | Adresse civique | 53 % | — |38| `city` | Ville | 34 % | — |39| `region` | Région administrative | 100 % | Montréal |40| `postal_code` | Code postal | 28 % | — |41| `lat` | GPS (lat/lng) | 100 % | 45.4287676 |42| `phone` | Téléphone | 25 % | — |43| `website` | Site web | 24 % | — |44| `hours` | Horaires structurés (JSON) | 21 % | {} |45| `services` | Services (JSON) | 100 % | ["salle"] |46| `dietary_options` | Options alimentaires (JSON) | 5 % | [] |47| `images` | Photos (JSON) | 0 % | — |48| `url` | URL de la fiche source | 100 % | https://www.openstreetmap.org/node/112637139 |4950**Menus** : 13 menus rattachés (728 items, 1 contexte(s) de prix, dernière capture 2026-08-18T10:05:33Z) — table `menus` (sections → items → options, prix CAD).5152## Fréquence & budget5354- **Cadence déclarée (registre)** : mensuel55- **Cadence observée** (médiane sync_log) : ≈ 30 min56- **Dernier passage OK** : 2026-08-18 03:12 — 8616 trouvées, +20 / ~1687 / -05758## Volumétrie & complétude5960- **Fiches en BD** : 13969 au total, **13969 actives**61- **Première ingestion** : 2026-08-17 · **Dernière observation** : 2026-08-1862- **Complétude clé (actives)** : GPS 100 % · adresse 53 % · cuisines 100 % · horaires 21 % · site web 24 %63- **Runs journalisés (60 derniers)** : 6, dont 0 en erreur6465## Erreurs connues & dépannage6667Aucune erreur dans les 60 derniers runs journalisés.6869Rejouer la source seule : `python3 run.py sync osm` · vérifier `sync_log` (`SELECT * FROM sync_log WHERE source='osm' ORDER BY ts DESC LIMIT 5;`).7071## Licence, attribution & conditions7273- **Cadre d'accès (registre, `acces_legal`)** : Données © contributeurs OpenStreetMap, licence ODbL — attribution affichée (pages Sources et pied de page). API Overpass publique, requêtes espacées, miroirs en rotation.74- **Licence** : ODbL — « Données © contributeurs OpenStreetMap » ; attribution affichée sur les pages Sources et le pied de page de Resto-Ka.75- Retrait sur demande : contact@spboucher.ai.7677## Historique7879- 2026-08-17 — premières fiches de la source ingérées dans la BD.80- 2026-08-18 — vague d'enrichissement : standardisation de la documentation des connecteurs (fiche générée par `scripts/gen_connector_docs.py`).81