# OpenStreetMap (découverte) — connecteur osm

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.

État : actif · Palier (tier) : 4 · Backend : direct · Restos actifs : 13969/13969

# Description de la source

Connecteur 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).

• Plateforme : overpass · Site : https://www.openstreetmap.org
• 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).
• Contexte de prix : —
• Module : restoka/connectors/osm.py — OsmConnector

# Accès

• Type d'accès : API Overpass (OpenStreetMap)
• Endpoint de base : https://overpass.kumi.systems/api/interpreter
• 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/interpreter
• Pagination : itération sur 4 racines (constante MIRRORS)
• Backend anti-bot / rendu : requests direct (session UA RestoKaBot, throttling poli)
• Politesse : 3.0 s entre requêtes, timeout 240 s, UA RestoKaBot/1.0 (+https://www.resto-ka.com/bot)
• Authentification : aucune — accès public/anonyme

# Champs récupérés → schéma cible

Le 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.

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).

# Fréquence & budget

• Cadence déclarée (registre) : mensuel
• Cadence observée (médiane sync_log) : ≈ 30 min
• Dernier passage OK : 2026-08-18 03:12 — 8616 trouvées, +20 / ~1687 / -0

# Volumétrie & complétude

• Fiches en BD : 13969 au total, 13969 actives
• Première ingestion : 2026-08-17 · Dernière observation : 2026-08-18
• Complétude clé (actives) : GPS 100 % · adresse 53 % · cuisines 100 % · horaires 21 % · site web 24 %
• Runs journalisés (60 derniers) : 6, dont 0 en erreur

# Erreurs connues & dépannage

Aucune erreur dans les 60 derniers runs journalisés.

Rejouer 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;).

# Licence, attribution & conditions

• 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.
• Licence : ODbL — « Données © contributeurs OpenStreetMap » ; attribution affichée sur les pages Sources et le pied de page de Resto-Ka.
• Retrait sur demande : contact@spboucher.ai.

# Historique

• 2026-08-17 — premières fiches de la source ingérées dans la BD.
• 2026-08-18 — vague d'enrichissement : standardisation de la documentation des connecteurs (fiche générée par scripts/gen_connector_docs.py).