Documentation OEDB

Concepts généraux, référence technique de l'API REST, instructions de déploiement et présentation des pages de l'éditeur https://edit.oedb.cipherbliss.com.

Concepts
Quoi / Où / Quand
Format GeoJSON
Schéma PostgreSQL
Flux de données
Cluster de réplication
Sources de données
API REST
Lancer l'API
Pages éditeur
Archives

Concepts généraux

OpenEventDatabase répond à un manque : partager des informations spatio-temporelles de type « quoi / où / quand ». OpenStreetMap couvre le « quoi » et le « où », mais pas le « quand » ni l'historique d'évènements ponctuels ou récurrents.

Itinéraire temps réel

Un calcul d'itinéraire peut intégrer bouchons, travaux, météo ou incidents pour passer d'une appli passive à une appli temps réel.

Que faire ce week-end ?

Spectacles, activités, horaires de ciné — trouver un loisir proche de chez soi à partir d'évènements géolocalisés.

Mémoire territoriale

Conserver des évènements historiques, d'anciens tracés de routes, champs de bataille, découpages administratifs…

Les trois dimensions d'un évènement

Dans tous les cas d'usage, trois informations sont nécessaires :

Quoi Description sémantique : type (what), nature temporelle (scheduled, forecast, unscheduled), famille (culture, transport, météo…), importance.

Où Composante géographique : point lat/lon, géométrie GeoJSON, lien vers un référentiel (where:osm, where:wikidata).

Quand Temporalité ISO 8601 : instant, intervalle, récurrence ; mots-clés relatifs (today, next7days…).

Le projet propose une base spatio-temporelle ouverte pour échanger ces triplets, alimentée manuellement ou via des extracteurs automatisés depuis des sources ouvertes.

Format de données

L'API manipule des GeoJSON FeatureCollection. Chaque évènement est une Feature avec une géométrie et des propriétés métier.

{
  "type": "FeatureCollection",
  "features": [{
    "type": "Feature",
    "geometry": { "type": "Point", "coordinates": [2.35, 48.86] },
    "properties": {
      "what": "culture.other",
      "type": "scheduled",
      "label": "Concert en plein air",
      "start": "2026-07-17T20:00:00Z",
      "stop": "2026-07-17T23:00:00Z"
    }
  }]
}

Schéma PostgreSQL

Base PostgreSQL avec PostGIS. Les géométries sont mutualisées dans geo ; les métadonnées évènement (label, description, source…) vivent dans events_tags (JSONB). Les suppressions sont archivées dans events_deleted. Les tables extractor_* alimentent le monitoring local des extracteurs.

Tables

Table	Rôle
`events`	Évènements actifs
`geo`	Géométries partagées (hash, geom PostGIS)
`events_deleted`	Archive des évènements supprimés
`extractor_registry`	Catalogue des extracteurs
`extractor_runs`	Historique d'exécution des extracteurs

events.events_geo référence geo.hash (FK). Index SP-GiST sur events_what / events_when, GIST sur geo.geom. Définition SQL : setup.sql et migrations/.

Flux de données

Les extracteurs collectent les évènements sur les sites sources et les publient dans l'API officielle. Des dumps locaux en sont tirés : dump Postgres sur le serveur de la base, et dumps GeoJSON récupérés progressivement depuis l'API (au plus 60 requêtes par nuit). Ils alimentent chaque nuit une base en lecture seule, servie par api.vibrisse.fr, que le frontend Vibrisse interroge quand l'API officielle ne répond pas.

Cluster de réplication

Plusieurs serveurs, chez des hébergeurs différents, gardent chacun une copie des dumps GeoJSON de l'historique et une base en lecture seule reconstruite à partir d'eux. Ils s'échangent les dumps en pair à pair : chaque nœud interroge tous les autres et récupère ce qui lui manque ou ce qui est plus récent. Le cluster survit à la perte de n'importe quel nœud, et même de l'API officielle, tant qu'une copie subsiste.

Rôles

Un seul nœud collecteur (deux au plus) récupère l'historique auprès de l'API officielle avec le rattrapage progressif (make backfill, au plus 60 requêtes par nuit) : ajouter des nœuds n'alourdit pas la prod. Les autres nœuds sont des miroirs qui ne parlent qu'aux autres nœuds (make peers-sync). Tous servent leurs dumps publics (/db/dumps) et leur API lecture seule.

Initialiser un nœud

git clone https://source.cipherbliss.com/tykayn/oedb-backend && cd oedb-backend
python3 -m venv venv && . venv/bin/activate && pip install -r requirements.txt

# Base en lecture seule et rôles Postgres (doc/readonly_replica.md)
sudo -u postgres psql -v sync_password='…' -v reader_password='…' \
  -f server_config/readonly_replica_setup.sql

# .env.readonly-sync : un miroir n'a pas de base principale
REPLICA_SOURCE=geojson
OEDB_PEERS=https://noeud-a.example.org https://noeud-c.example.org

# Première récupération auprès des pairs, puis construction de la base
python3 scripts/sync_dumps_from_peers.py --dry-run
python3 scripts/sync_dumps_from_peers.py --max-files 1000
make readonly-sync

# Service (server_config/oedb-readonly-uwsgi.service) + Caddy sur le domaine du nœud,
# puis ajouter son URL à OEDB_PEERS sur les autres nœuds
curl -s https://noeud-b.example.org/replica/status

Crons d'un nœud

# Collecteur uniquement : rattrapage depuis l'API officielle
10 2 * * *   cd /srv/oedb-backend && make backfill      >> dumps/cron_backfill.log 2>&1
# Tous les nœuds : échange avec les pairs (décaler la minute d'un nœud à l'autre)
25 */6 * * * cd /srv/oedb-backend && make peers-sync    >> dumps/cron_peers.log 2>&1
# Tous les nœuds : reconstruction de la base en lecture seule
45 3 * * *   cd /srv/oedb-backend && make readonly-sync >> dumps/cron_readonly_sync.log 2>&1

Confiance entre nœuds

Seuls circulent les dumps GeoJSON publics : jamais de .pgdump, de .sql ni de secret. La liste des pairs (OEDB_PEERS) est choisie par chaque administrateur. Chaque dump reçu est vérifié : origine (l'API officielle), période cohérente avec son nom, nombre d'évènements, date d'export, absence de tag sensible ; les refus sont journalisés. La modification d'un évènement signé reste détectable par tout lecteur, quel que soit le nœud qui l'a servi.

Répartir le secours du frontend

Le frontend n'a qu'une URL de secours : Caddy la répartit entre les nœuds et écarte celui qui ne répond plus, grâce au contrôle de /replica/status (server_config/api.vibrisse.cluster.caddy).

Procédure complète, retrait d'un nœud et cas d'un nœud compromis : doc/cluster_replication.md.

Sources de données

Extracteurs automatisés alimentant OEDB depuis des jeux de données ouverts, avec la ou les catégories what qu'ils produisent. Catalogue : extractors/extractors_catalog.json. Les types homogènes portent aussi le tag what:wikidata, lien vers l'item Wikidata correspondant.

Source	Catégories what	Type Wikidata	Notes
Accidents corporels de la circulation routière individuels (France métropolitaine et DOM-TOM) `extractors/onisr_accidents_extractor.py`	`traffic.accident`	collision routière `Q9687`	Source : fichiers BAAC (Bulletin d'Analyse d'Accident Corporel) publiés annuellement par l'ONISR sur data.gouv.fr — la même donnée nationale que celle utilisée par la cartographie interactive : https://www.onisr.securite-routiere.gouv.fr/cartographie-des-accidents-metropole-dom-tom
Accidents et échecs de lancements de fusées `extractors/space_launch_failures_extractor.py`	`space.launch.failure`	échec de lancement `Q99654400`
Acteurs et actrices de cinéma célèbres (Wikidata) `extractors/film_actors_person_extractor.py`	`person`		Source : Wikidata (P569 naissance, P570 décès) + liste curée. Chaque personne = un évènement `person` du jour de naissance au jour de décès. Pas de date de fin si la personne est encore en vie.
Adoptions / promulgations de lois françaises `extractors/law_adoptions_extractor.py`	`justice.law`	promulgation `Q446780`
Affaires et scandales médiatico-politiques célèbres `extractors/famous_scandals_extractor.py`	`justice.scandal`	scandale `Q192909`	Source : liste curée (Watergate, affaire Dreyfus, affaire Fillon/Penelopegate, Panama Papers, Dieselgate…) — pas d'API externe, données factuelles stables.
Agenda Couture (tricot / broderie / dentelle) `extractors/agenda_couture_extractor.py`	`culture.knitting`	tricot `Q193188`	Source : https://www.agenda-couture.com/ (composant Joomla RSEventsPro).
Agenda Militant Indépendant `extractors/agenda_militant_extractor.py`	`culture.other`		Sources : - flux RSS public : https://www.agendamilitant.org/rss.xml - page détail de chaque évènement pour récupérer date/heure/lieu
Agenda de Saint-Quentin-en-Yvelines (OpenAgenda) `extractors/openagenda_sqy_extractor.py`	`culture.other`		Source : https://openagenda.com/fr/sqy (agenda UID 60701331), flux RSS OpenAgenda officiel — ~400 évènements, dates ISO8601 et géolocalisation natives, pas de pagination ni de géocodage à faire (même famille de source que openagenda_nantes.py).
Agenda de l'office de tourisme Dieppe-Normandie `extractors/dieppetourisme_agenda_extractor.py`	`culture.other`		Source : https://www.dieppetourisme.com/agenda/tout-lagenda/ (~17 pages)
Agenda de l'office de tourisme Le Havre Etretat Normandie Tourisme `extractors/lehavretourisme_agenda_extractor.py`	`culture.other`		Source : https://www.lehavre-etretat-tourisme.com/agenda/tout-lagenda/ (~26 pages)
Agenda de l'office de tourisme de Strasbourg (Visit Strasbourg) `extractors/strasbourg_tourisme_agenda_extractor.py`	`culture.other`		Source : https://www.visitstrasbourg.fr/agenda/ (peu de pages : ~50 évènements mis en avant au total, pagination via `?brpa=N` sur l'URL de listing elle-même — pas de composant JS requis, entièrement rendu côté serveur, contrairement à `lehavretourisme_agenda_extractor.py`)
Agenda de l'office de tourisme de Toulouse (Toulouse Tourisme) `extractors/toulouse_tourisme_agenda_extractor.py`	`culture.other`		Source : liste des fiches évènement via le sitemap XML dédié du site https://www.toulouse-tourisme.com/agenda-sitemap.xml https://www.toulouse-tourisme.com/agenda-sitemap2.xml (~1860 URLs `/agenda/<slug>/`, passées et futures)
Agenda de la Communauté d'agglomération Paris - Vallée de la Marne `extractors/agglo_pvm_extractor.py`	`culture.arts` `culture.music` `culture.other` `community.event`		Source : https://www.agglo-pvm.fr/actualites-agenda/agenda (CMS TYPO3, ~52 pages, ~614 fiches). Dates lues depuis l'export iCalendar public de chaque fiche (calendar.ics), pas de parsing de texte libre. Géolocalisation par nom de lieu (LOCATION ical) géocodé via addok/Nominatim.
Agenda de la Communauté d'agglomération de Cergy-Pontoise (13 Comme Une) `extractors/cergypontoise_13commeune_extractor.py`	`culture.other` `culture.music` `culture.arts` `community.event`		Source : https://13commeune.fr/recherche/evenements/ (magazine web officiel de l'agglomération, CMS WordPress, ~5 pages, ~113 fiches). Géolocalisation exacte lue directement dans l'URL de la carte OpenStreetMap embarquée par fiche (paramètre marker=lat,lon), pas de géocodage nécessaire.
Agenda des Royal Parks de Londres (Hyde Park, Kensington Gardens, Regent's Park, Green Park, St James's Park, Greenwich Park, Richmond Park, Bushy Park) `extractors/royal_parks_events_extractor.py`	`culture.other`		Source : Liste : https://www.royalparks.org.uk/whats-on?page=N (pagination jusqu'à page vide, ~19 fiches/page) Détail : <script type="application/ld+json"> de type Event (name, description, startDate, endDate) + panneau `.m-key-info__items` (item dont le texte correspond exactement à un des 8 parcs -> utilisé pour la géolocalisation, coordonnées fixes par parc, pas de géocodage nécessaire)
Agenda des sorties de la Ville de Vauréal (Val-d'Oise) `extractors/vaureal_agenda_extractor.py`	`culture.other` `community.event` `culture.arts` `culture.music`		Source : https://vaureal.fr/ca-bouge/agenda-des-sorties (~4 pages, CMS Drupal, HTML serveur). Une feature OEDB par occurrence (une fiche peut en avoir plusieurs, texte libre très hétérogène — voir parse_date_item). Géolocalisation par adresse de la fiche (bibliothèque, Agora, mairie...), certains évènements se déroulant hors de Vauréal (ex. Pontoise).
Agenda du Cerema (évènements à venir et passés) `extractors/cerema_events_extractor.py`	`community.event` `education.training`		Source : https://www.cerema.fr/fr/evenements (~7 pages à venir) et /fr/evenements/passe (~145 pages, ~1 740 fiches depuis 2012), site Drupal. Dates structurées du listing, précisées par la fiche (horaires « De 9h30 à 17h00 », adresse Drupal structurée). Webinaires / formations à distance -> online=yes. Géocodage adresse puis code postal+ville puis ville via addok/Nominatim. Fiches d'évènements terminés mises en cache définitivement.
Agenda « Sortir dans l'Aube » `extractors/sortirdanslaube_extractor.py`	`culture.other`		Source : https://sortirdanslaube.com/evenements/ (agenda local, département de l'Aube, WordPress avec custom post type `evenements`).
Agendas officiels de grandes métropoles et villes moyennes (Europe + Amérique du Nord + Suisse) `extractors/metropolis_events_extractor.py`	`culture.other`		Source : portails/API open data publiés par les métropoles elles-mêmes (ou par leur opérateur culturel/touristique officiel) — pas de flux RSS ou d'accès Apidae direct trouvé pour ces villes, mais un format tout aussi machine-lisible et officiel (données ouvertes municipales) :
Alertes FR-Alert (SAIP) `extractors/fralert_extractor.py`	`hazard.alert`	alerte aux populations `Q17012118`	Source : https://fr-alert.gouv.fr/les-alertes — système officiel d'alerte de population du Ministère de l'Intérieur (cell broadcast). La page annonce un export JSON, mais celui-ci est déclenché par un clic JS (`alert_export.js`) : il POST la liste des identifiants actuellement affichés vers `/export-alert` et télécharge la réponse comme fichier. Pas besoin de navigateur pour autant : la page `/…
Arrêtés de circulation (API DiaLog) `extractors/dialog_regulations_extractor.py`	`traffic.legal`		Source : export public DATEX II de l'API DiaLog (Ministère de la Transition écologique / Fabrique numérique) — la même donnée que la liste https://dialog.beta.gouv.fr/regulations (arrêtés municipaux/départementaux/ préfectoraux publiés : limitations de vitesse, interdictions d'accès, stationnement interdit, alternats, dépassement interdit…).
Avis de marchés publics (BOAMP) `extractors/boamp_extractor.py`	`economy.procurement.tender`	call for tenders (appel d'offres) `Q96414476`	Source : plateforme OpenDataSoft du BOAMP (Bulletin officiel des annonces de marchés publics), DILA — API Explore v2.1, publique, sans clé :
BODACC (Bulletin officiel des annonces civiles et commerciales) `extractors/bodacc_extractor.py`	`economy.company.bodacc`		Source : plateforme OpenDataSoft du BODACC, DILA — API Explore v2.1, publique, sans clé (même famille de plateforme que boamp_extractor.py) :
Canicules en France (chronologie Vie publique) `extractors/france_heatwaves_extractor.py`	`weather.heat`	canicule `Q215864`	Source : - Chronologie 2003-2026 des principales canicules en France https://www.vie-publique.fr/eclairage/303797-chronologie-des-canicules-en-france-depuis-2003
Catalogue détaillé de jeux vidéo « cultes » (moins mainstream que les gros blockbusters), et de leurs suites, `extractors/classic_games_catalog_extractor.py`	`culture.games.classic_release`
Centrales et barrages (nucléaire, charbon, gaz, hydroélectrique, STEP, éolien, solaire) `extractors/wikidata_power_plants_extractor.py`	`energy.construction.coal` `energy.construction.gas` `energy.construction.hydro` `energy.construction.nuclear` `energy.construction.solar` `energy.construction.wind`
Ciné-Mailles (Studio des Ursulines, Paris 5e) `extractors/cine_mailles_extractor.py`	`culture.knitting`	tricot `Q193188`	Source : https://www.studiodesursulines.com/ — ciné-club mensuel co-organisé avec le Club Crochet Tricot Paris (tricoter/crocheter pendant une projection, lumières tamisées, bar à tisanes/sirops dès 19h). La page dédiée (`/rendez-vous/cine-mailles/`) n'annonce qu'une seule édition à la fois en texte libre (pas de JSON-LD Event) et n'est pas toujours à jour ; la source fiable est le programme he…
Commission Nationale du Débat Public (CNDP) — agenda `extractors/debat_public_extractor.py`	`politics.public_debate`	débat public `Q14850922`	Source : https://www.debatpublic.fr/projet-accelerateur-particules/agenda Scrape la liste paginée (status=1 passés, status=2 tous) puis chaque fiche pour récupérer date, heure, lieu, description.
Comptage annuel des morts de la route par mode de transport (France, Espagne) `extractors/road_deaths_extractor.py`	`counting.road_deaths`		Source : liste curée à partir des bilans officiels publiés par l'ONISR (France) et la DGT (Espagne) — pas d'API externe, chiffres officiels sourcés individuellement par entrée (voir source_url dans le fichier curé).
Construction et mise en production de data centers, dans le monde entier, depuis 2000 `extractors/datacenters_construction_extractor.py`	`infrastructure.construction.datacenter`		Source : Wikidata (SPARQL), instances de « data center » (Q671224) et de ses sous-classes (colocation, HPC, micro data center, data center IA...). Même principe que `wikidata_power_plants_extractor.py` : deux dates possibles existent sur les fiches Wikidata, avec une couverture très inégale d'une fiche à l'autre —
Construction et mise en service de lignes de train à grande vitesse (LGV / high-speed rail), en Europe, en Asie et aux États-Unis `extractors/highspeed_rail_construction_extractor.py`	`transport.construction.rail.highspeed`		Source : Wikidata (SPARQL). Attention au bon QID, vérifié avant de coder via `wbsearchentities` : - `Q1311958` (piste suivie initialement d'après l'intitulé "à vérifier" de la consigne) est en réalité "railway tunnel" (tunnel ferroviaire) — une confusion à éviter, ce QID n'a rien à voir avec la grande vitesse. - `Q858485` = "high-speed railway line", la bonne entité : une ligne indi…
Contribateliers de Nantes (saison 2026-2027) `extractors/contribateliers_nantes_extractor.py`	`culture.hacking.meetup`	meet-up `Q3304140`	Source : sujet du forum OSM France annonçant le calendrier de la saison, une soirée mensuelle d'échange libre (OpenStreetMap, Panoramax, Wikipédia, Wikidata) à l'Hyperlien (Île de Nantes) : https://forum.openstreetmap.fr/t/contribateliers-de-nantes-saison-2026-2027/46418
Coupures de courant / blackouts majeurs (monde) `extractors/power_outages_extractor.py`	`energy.outage.blackout`	panne de courant `Q828827`	Source : Wikidata (SPARQL) — instances de « power outage » (Q828827) et de ses sous-classes. Couverture limitée aux coupures assez notables pour avoir une fiche Wikidata (grands blackouts nationaux/régionaux) : ce n'est pas un flux temps réel d'incidents réseau (pour ça, voir `nuclear_monitor_extractor.py` côté indisponibilités de production, ou le TP ENTSO-E côté transport — non branché ici, A…
Dates de lancement de projets FLOSS autour d'OpenStreetMap `extractors/osm_floss_projects_extractor.py`	`culture.floss.project`		Sources : - Données curées (osm_floss_projects.json) : Osmose, Vespucci, ProjetDuMois, Panoramax, AskAngela, MapYourGrid - Option --fetch-github : complète la date de création des dépôts GitHub listés
Dates historiques scolaires (programme) `extractors/school_history_dates_extractor.py`	`history.milestone`		Source : données curées (school_history_dates.json) — programme d'histoire scolaire.
Décomptes annuels des décès attribuables à la chaleur (Santé publique France, plateforme Odissé) `extractors/heat_mortality_extractor.py`	`counting.heat_deaths`		Source : API publique Opendatasoft (ODS v2.1) de Santé publique France, sans clé d'authentification requise :
Décomptes annuels des tués sur la route (INSEE, API BDM) `extractors/insee_road_deaths_extractor.py`	`counting.road_deaths`		Source : API publique SDMX de l'INSEE (Banque de Données Macro-économiques), sans clé d'authentification requise :
Décomptes cumulés des points de charge / bornes de recharge en France `extractors/ev_charging_milestones_extractor.py`	`counting.ev_charging_points`		Source : même fichier consolidé national IRVE que irve_charging_stations_extractor.py (data.gouv.fr, schéma etalab/schema-irve-statique v2.3.1) : https://www.data.gouv.fr/datasets/fichier-consolide-des-bornes-de-recharge-pour-vehicules-electriques/
Démosphère (réseau d'agendas militants) `extractors/demosphere_extractor.py`	`society.demonstration`	manifestation `Q175331`	Sources : flux RSS+GeoRSS `events.xml` de chaque instance Démosphère (une instance = une ville/région, logiciel commun) pour la date/le lieu/le thème, complétés par `events.ics` (mêmes UID que les liens RSS) pour une adresse texte plus riche via le champ LOCATION.
Extracteur Nuclear Monitor (indisponibilités nucléaires EDF) `extractors/nuclear_monitor_extractor.py`	`energy.nuclear.unavailability`		Sources : - Historique / terminées : /unavailabilities/finished/ - À venir : /unavailabilities/next/
Extracteur des incendies signalés sur feuxdeforet.fr `extractors/feuxdeforet_extractor.py`	`hazard.fire`	feu de végétation `Q169950`
Extracteur des journées mondiales/internationales. Source: https://www.journee-mondiale.com/les-journees-mondiales.htm `extractors/world_days_extractor.py`	`culture.arts`		Source: https://www.journee-mondiale.com/les-journees-mondiales.htm
Extracteur des vacances scolaires en France (par zones A/B/C et Corse) + jours fériés. Sources: - Vacances scolaires (ICS): https://www.data.gouv.fr/api/1/datasets/r/e5f40fbc-7a84-4c4a-94e4-55ac4299b222 - Jours fériés: https://calendrier.api.gouv.fr/jours-feries.json `extractors/fr_holidays_extractor.py`	`time.holidays`	vacances scolaires `Q1514190`	Sources: - Vacances scolaires (ICS): https://www.data.gouv.fr/api/1/datasets/r/e5f40fbc-7a84-4c4a-94e4-55ac4299b222 - Jours fériés: https://calendrier.api.gouv.fr/jours-feries.json
Extracteur trafic par tronçons — Bison Futé TIPI DATEX II (QTV-DIR / TRAFICOLOR-DIR) `extractors/trafic_dir_extractor.py`	`traffic.incident`		Sources : http://tipi.bison-fute.gouv.fr/bison-fute-ouvert/publicationsDIR/QTV-DIR/qtvDir.xml http://tipi.bison-fute.gouv.fr/bison-fute-ouvert/publicationsDIR/QTV-DIR/refDir.csv
Festivals de bande dessinée et de culture japonaise en France `extractors/comics_festivals_extractor.py`	`culture.comics_festival`	festival de bande dessinée `Q3070220`	Source : liste curée à partir d'articles de presse et de Wikipédia — pas d'API externe, chaque édition individuellement sourcée (`source_url`).
Festivals de cerf-volant (Dieppe, Berck-sur-Mer) `extractors/kite_festivals_extractor.py`	`culture.kite_festival`	festival de cerf-volant `Q131087460`
Festivals, salons et conventions de jeux de société (Subverti) `extractors/subverti_game_festivals_extractor.py`	`culture.games`		Source : https://subverti.com/fr/maps/festivals/ — carte/liste participative d'environ 800 festivals de jeux de société en France (et quelques pays limitrophes). Page HTML classique, entièrement rendue côté serveur : tous les festivals sont présents d'entrée dans le DOM, un par `<li class="fest__item">`, sous forme d'attributs `data-*` (nom, ville, département/pays, latitude, longitude, dates d…
Forums / journées des associations (France entière) `extractors/journees_associations_extractor.py`	`culture.other`		Source : jeu OpenDataSoft national « Public events - OpenAgenda » https://public.opendatasoft.com/explore/dataset/evenements-publics-openagenda/ (agrégat national de tous les évènements publics publiés sur OpenAgenda), filtré ici par mots-clés de titre plutôt que par commune (contrairement à `rouen_dieppe_events_extractor.py`, qui interroge le même jeu mais restreint à Rouen/Dieppe) : "forum de…
Féminicides recensés par #NousToutes `extractors/feminicides_noustoutes_extractor.py`	`counting.feminicide`	féminicide `Q1342425`	Source : jeu de données ouvert (Licence Ouverte 2.0) publié par #NousToutes sur data.gouv.fr, « Décompte et recensement des féminicides » : https://www.data.gouv.fr/datasets/decompte-et-recensement-des-feminicides
Fêtes / journées nationales des pays d'Europe `extractors/national_days_europe_extractor.py`	`culture.national_day`	fête nationale `Q57598`
Fêtes et festivals médiévaux en France `extractors/medieval_festivals_extractor.py`	`culture.medieval_festival`	fête médiévale `Q673514`	Source : Mediefest (https://mediefest.org), agenda dédié aux fêtes médiévales, marchés et spectacles historiques en France (Provins, Cidre et Dragon, Sedan, Talmont, Cordes-sur-Ciel…). API publique REST « The Events Calendar » (plugin WordPress standard), sans clé requise : `/wp-json/tribe/events/v1/events`.
Fêtes et manifestations (DATAtourisme) `extractors/datatourisme_extractor.py`	`culture`		Source : API de recherche interne (Elasticsearch) du portail explore.datatourisme.fr, filtrée sur le type "/Fête et manifestation" ET sur une date de fin d'occurrence >= --since (2026-01-01 par défaut) :
Fêtes religieuses (PDF Académie de Paris / Éducation nationale) `extractors/fr_grandes_fetes_religieuses_pdf_extractor.py`	`religious`	fête religieuse `Q130748394`
Fêtes religieuses multi-traditions `extractors/religious_holidays_extractor.py`	`religious`	fête religieuse `Q130748394`	Sources : - Chrétien (calcul) : Pâques et fêtes mobiles, fêtes fixes (Noël, Assomption…) - Islam : API Aladhan (gToHCalendar) — jours marqués holidays - Judaïsme : API Hebcal — fêtes majeures (yomtov / subcat major)
Grandes manifestations et mobilisations sociales en France `extractors/french_demonstrations_extractor.py`	`society.demonstration`	manifestation `Q175331`	Source : liste curée à partir d'articles de presse et de sources officielles (ministère de l'Intérieur, syndicats) — pas d'API externe, faits stables et sourcés individuellement dans extractors_catalog / le fichier curé.
Grands évènements nautiques/maritimes français (Vendée Globe, Route du Rhum, The Ocean Race...) `extractors/grands_evenements_nautiques.py`	`sport.voile.course_autour_du_monde`	course au large `Q19952562`	Liste curée (pas de source unique scrapable). Pour les courses point-à-point/autour du monde, une géométrie de parcours (LineString/MultiLineString) est publiée via `great_circle_route_geometry` (utils_extractor_common.py) : tracé grand-cercle approximatif entre points de passage officiels (départ/arrivée, caps), PAS le tracé réel suivi par les concurrents.
Indymedia Nantes (agenda militant) `extractors/indymedia_nantes_extractor.py`	`society.demonstration`	manifestation `Q175331`	Source : pages HTML paginées de l'archive publique des évènements (`/events/archive/` puis `/events/archive/page/N/`), thème WordPress imcpress — titre, tags (`post_tag`/`place_tag`), date/heure et lieu texte sont lus directement dans la liste (pas de fetch de la page de détail par évènement, pour rester léger vu le volume : ~900 pages d'archive).
Interconnexions électriques transfrontalières (mise en service) `extractors/grid_interconnections_extractor.py`	`energy.grid.interconnection`		Source : Wikidata (SPARQL) — instances de « electrical interconnector » (Q48970589) : lignes/câbles HVDC ou HVAC reliant les réseaux électriques de deux pays (Kontek, NorNed, IFA 2000, NordLink…). Couverture volontairement restreinte : une trentaine d'interconnexions notables ont une fiche Wikidata avec date de construction (P571) et/ou d'ouverture (P1619) ; les raccordements d'interconnexion i…
Jalons biographiques d'acteurs et cinéastes `extractors/film_actors_milestones_extractor.py`	`culture.film.actor`		Source : Wikidata (P569 naissance, P570 décès) + liste curée.
Jalons du jeu vidéo et du jeu de cartes moderne `extractors/gaming_milestones_extractor.py`	`culture.gaming.console_hits` `culture.gaming.console_release` `culture.gaming.steam_release` `culture.gaming.tcg_release`
Jeu de Go : tournois et animations (FFG) `extractors/ffg_go_extractor.py`	`culture.games.go`	compétition de go `Q21163366`	Source : https://ffg.jeudego.org/evenements/cal.php — flux iCalendar officiel de la Fédération Française de Go (1979 à aujourd'hui + ~1 an, publié par défaut sur une fenêtre autour d'aujourd'hui via --days-back/--days-ahead). Pas de LOCATION dans le flux : la ville est extraite heuristiquement du titre (SUMMARY), en échouant volontairement plutôt que de deviner sur les titres trop libres — voir le commentaire de tête de fichier.
Journées européennes du patrimoine `extractors/heritage_days_extractor.py`	`culture.heritage_days`	Journées européennes du patrimoine `Q1575593`
Jours fériés publics multi-pays `extractors/public_holidays_extractor.py`	`time.daylight.holiday`	jour férié `Q1197685`	Sources : - Nager.Date v3 : https://date.nager.at/api/v3/PublicHolidays/{year}/{country} - France (optionnel) : https://calendrier.api.gouv.fr/jours-feries/metropole/{year}.json
Lois autorisant le mariage entre personnes de même genre par pays `extractors/same_sex_marriage_laws_extractor.py`	`justice.reform`		Sources : - Données curées (same_sex_marriage_laws.json) avec références Wikidata - Complément Wikidata SPARQL (instances « mariage homosexuel en… » avec date P580)
Marchés publics attribués — Données Essentielles de la Commande Publique (DECP) `extractors/decp_extractor.py`	`economy.procurement.award`	contrat administratif `Q529458`	Source : jeu de données "decp_augmente" (ODS, data.economie.gouv.fr), consolidation des DECP transmises par les acheteurs publics — API Explore v2.1, publique, sans clé :
Meetup.com `extractors/meetup_extractor.py`	`culture.meetup`	meet-up `Q3304140`
Mises en production futures de réacteurs de puissance et de SMR/AMR `extractors/nuclear_forecast_extractor.py`	`energy.construction.nuclear`		Source : liste curée (nuclear_forecast_milestones.json), sourcée individuellement par entrée (presse spécialisée / annonces officielles des opérateurs, voir source_url) — aucune API n'expose ces dates prévisionnelles (GeoNuclearData, utilisé par nuclear_reactors_lifecycle_extractor.py, liste bien des réacteurs "Under Construction" mais sans aucune date de mise en service prévisionnelle : `opera…
Mises en service de stations de recharge pour véhicules électriques `extractors/irve_charging_stations_extractor.py`	`energy.construction.ev_charging`		Source : Base nationale des IRVE (Infrastructures de Recharge pour Véhicules Électriques), fichier consolidé quotidien, data.gouv.fr / transport.data.gouv.fr, Licence Ouverte. Schéma etalab/schema-irve-statique v2.3.1. https://www.data.gouv.fr/datasets/fichier-consolide-des-bornes-de-recharge-pour-vehicules-electriques/
Mises en service — parcs éoliens et fermes solaires (maille fine, France) `extractors/renewable_construction_extractor.py`	`energy.construction.solar` `energy.construction.wind`		Source : Registre national RNAé (RTE / ODRÉ). Seules les installations ≥ 36 kW sont publiées individuellement ; les entrées « Agrégation des installations de moins de 36 kW » sont exclues.
Mises en service — stations de métro, lignes de métro, gares desservies par la grande vitesse (TGV/OUIGO/Lyria/Eurostar…) en France `extractors/train_stations_extractor.py`	`transport.line.metro` `transport.station.metro` `transport.station.tgv`
Ouvertures programmées des ponts mobiles du port de Dieppe `extractors/dieppe_movable_bridges_extractor.py`	`trafic.change.bridge.toggle`
Parutions d'ouvrages majeurs de sociologie `extractors/sociology_publications_extractor.py`	`culture.book`		Source : liste curée à partir de dates de publication consensuelles (éditeurs, bibliographies académiques) — pas d'API externe, faits stables. Dates spot-vérifiées (Bourdieu, Hill Collins, Delphy, Hochschild) via recherche avant intégration.
Permanences des "maisons du vélo mobiles" Véligo Location (Île-de-France Mobilités) `extractors/veligo_location_mobile_extractor.py`	`transport.cycling.veligo_permanence`
Premières sorties cinéma Studio Ghibli `extractors/studio_ghibli_film_releases_extractor.py`	`culture.film.release`	date de sortie (film) `Q5449034`
Premières sorties cinéma de Steven Spielberg `extractors/spielberg_film_releases_extractor.py`	`culture.film.release`	date de sortie (film) `Q5449034`
Programmes de conférences FLOSS au format Pentabarf/Frab « schedule.xml » (le format lu nativement par l'application Giggity — agenda de conférence hors-ligne pour Android/F-Droid, https://giggity.leetle.de/) `extractors/giggity_extractor.py`	`culture.floss.talk`	présentation `Q604733`
Programmes de conférences FLOSS publiés sur des instances Pretalx `extractors/pretalx_extractor.py`	`culture.floss.talk`	présentation `Q604733`	Source : export public « schedule.xml » (format Pentabarf/Frab) de chaque évènement Pretalx — aucune clé API requise, disponible dès que l'organisation publie son programme.
Projets PCRS (Plan de Corps de Rue Simplifié) `extractors/pcrs_projects_extractor.py`	`infrastructure.geodata.pcrs`		Source : export CSV public de la démarche de suivi PCRS (pcrs.beta.gouv.fr), catalogué sur data.gouv.fr sous l'organisation "pcrs-beta-gouv-fr" (https://www.data.gouv.fr/organizations/pcrs-beta-gouv-fr/datasets, dataset « Inventaire des projets PCRS »). Fetch direct de la source (comme `dialog_regulations_extractor.py` avec dialog.beta.gouv.fr) plutôt que de passer par l'API catalogue data.gouv…
Publications de fanzines MéluZine `extractors/meluzine_fanzines_extractor.py`	`culture.book`		Source : - Index : POST admin-ajax.php (grille Elementor Essential Addons, catégorie fanzines) - Fiches : pages individuelles (ex. https://meluzine.org/keiden-tome-01/)
Publie les 5 évènements démo wildlife.observation.* dans OEDB `extractors/wildlife_observation_demo_extractor.py`	`wildlife.observation`
Publie ou met à jour les 3 évènements démo session.ev.charging dans OEDB `extractors/ev_charging_demo_extractor.py`	`session.ev.charging`
Rencontres locales récurrentes du Chaos Computer Club ("Chaostreffs"/"Erfa-Kreise") `extractors/ccc_chaostreffs_extractor.py`	`culture.hacking.meetup`	meet-up `Q3304140`	Source : https://www.ccc.de/de/regional ("Termine" — page HTML statique, pas d'API/JSON/ICS trouvée malgré recherche, cf. session de mise en place). Cette page liste de vraies dates individuelles (pas une règle en prose) pour ~90 groupes locaux, mais seulement sur une fenêtre glissante d'environ 6 semaines (vérifié en pratique, 16/08/2026 : dates du 17/08/2026 au 26/09/2026). Pas de source uniq…
Restrictions d'usage de l'eau liées aux baisses sévères de niveau des cours d'eau (étiages) en France `extractors/river_low_water_restrictions_extractor.py`	`hydrology.river.low_water_restriction`		Source : API publique VigiEau (https://api.vigieau.gouv.fr, aucune clé — succède à Propluvia), alimentée quotidiennement à partir des arrêtés-cadre « sécheresse » préfectoraux. Deux appels par département qualifiant : - `GET /api/departements` : niveau de gravité maximum par département et par type de ressource (`niveauGraviteSupMax` = eaux superficielles, c-à-d cours d'eau — celui utilisé ici…
Restrictions de refroidissement (rejets thermiques / prélèvements d'eau) des centrales nucléaires françaises, décidées par l'ASNR `extractors/asn_nuclear_cooling_restrictions_extractor.py`	`energy.nuclear.cooling_restriction`		Source : flux RSS des actualités de l'Autorité de sûreté nucléaire et de radioprotection — https://www.asnr.fr/actualites/feed (public, aucune clé), filtré par mot-clé (thermique, canicule, sécheresse, rejet, débit, refroidissement, prélèvement). Aucune API dédiée aux dérogations thermiques trouvée : les décisions individuelles (ex. n° 2026-DC-052) sont publiées au Journal officiel/Légifrance,…
Répertoire des débats et consultations publics (vie-publique.fr / DILA) `extractors/consultations_publiques_extractor.py`	`politics.public_consultation`	concertation `Q2991722`	Source : flux RSS national, mis à jour quotidiennement, listant les consultations publiques en cours (projets de décret/arrêté, etc.) :
Sciences et histoire `extractors/history_science_extractor.py`	`science.discover`		Sources : - Jalons historiques curés (ADN, laser, Amérique, greffe du cœur, batailles, droits…) - Wikidata P575 (découvertes scientifiques) - Wikidata batailles (P31=battle, P585/P580, filtre sitelinks)
Séismes (USGS, couverture mondiale) `extractors/usgs_earthquakes_extractor.py`	`weather.earthquake`	séisme `Q7944`	Source : service FDSN Event de l'USGS Earthquake Hazards Program (https://earthquake.usgs.gov/fdsnws/event/1/query), sans clé, couverture mondiale. Filtré par défaut sur magnitude >= 4.5.
Séismes au Japon (JMA, détail local + intensité shindo) `extractors/jma_japan_earthquakes_extractor.py`	`weather.earthquake`	séisme `Q7944`	Source : liste officielle de l'Agence météorologique japonaise (JMA), sans clé (https://www.jma.go.jp/bosai/quake/data/list.json). Complémentaire de usgs_earthquakes_extractor (échelle Mj propre au Japon, intensité ressentie shindo 1-7 sans équivalent USGS) — recouvrement attendu et accepté sur les séismes japonais notables, deux sources indépendantes. Filtré par défaut sur magnitude >= 3.0 (--min-intensity en alternative, sur l'échelle shindo).
Séismes en Europe / Méditerranée (EMSC) `extractors/emsc_earthquakes_extractor.py`	`weather.earthquake`	séisme `Q7944`	Source : service FDSN Event de l'European-Mediterranean Seismological Centre, sans clé (https://www.seismicportal.eu/fdsnws/event/1/query), même protocole que usgs_earthquakes_extractor. Filtré par défaut sur une bbox Europe élargie + pourtour méditerranéen/nord-africain (Maroc, Algérie, Tunisie, Libye, Égypte inclus — pas de source régionale équivalente trouvée pour l'Afrique subsaharienne). Magnitude >= 3.0 par défaut. Recouvrement attendu et accepté avec USGS/JMA sur les séismes notables.
Séismes en Indonésie (BMKG, intensité ressentie MMI) `extractors/bmkg_indonesia_earthquakes_extractor.py`	`weather.earthquake`	séisme `Q7944`	Source : flux JSON publics BMKG (Badan Meteorologi, Klimatologi, dan Geofisika), sans clé mais nécessitant des en-têtes de type navigateur (https://data.bmkg.go.id/DataMKG/TEWS/gempaterkini.json + gempadirasakan.json — 15 dernières entrées chacun, pas d'historique interrogeable). Le flux "ressenti" (gempadirasakan) descend sous le seuil M>=4.5 de USGS et apporte l'intensité ressentie par localité (échelle MMI), sans équivalent USGS. Recouvrement attendu et accepté sur les séismes notables.
Thèses de doctorat soutenues en France (theses.fr, ABES) `extractors/theses_fr_extractor.py`	`education.thesis`	soutenance de thèse `Q116744737`	Source : API publique de recherche de theses.fr (Agence Bibliographique de l'Enseignement Supérieur), sans clé d'authentification requise :
Tournois d'échecs homologués (FFE) `extractors/ffe_chess_extractor.py`	`culture.games.chess`	tournoi d'échecs `Q2210277`	Source : https://www.echecs.asso.fr/Calendrier.aspx — calendrier officiel d'homologation de la Fédération Française des Échecs.
Tournois de bridge (European Bridge League) `extractors/bridge_events_extractor.py`	`culture.cards.bridge`		Source : https://www.eurobridge.org/events/ — calendrier de tournois de l'EBL (European Bridge League). Faible volume (~6 évènements à venir au moment de l'écriture) : couvre les grands tournois internationaux affiliés à l'EBL, pas les compétitions de club.
Travaux et incidents ferroviaires + transports IDF (RER, métro, tram, bus, TER, TGV, Intercités) `extractors/sncf_rail_disruptions_extractor.py`	`transport.railway.work`		Sources : - SIRI SX Lite (SNCF Voyageurs — TER, Intercités, TGV/OUIGO au niveau national, temps réel, aucune clé requise) : https://proxy.transport.data.gouv.fr/resource/sncf-siri-lite-situation-exchange Republié par https://ressources.data.sncf.com/explore/dataset/temps-reel-siri-sx-lite/ ; l'ancien jeu « Interceptions programmées sur ligne » (travaux, agrégé par ligne/semaine, utilisé par le…
Zones et dates de "Paris Respire" (fermeture de voies à la circulation) `extractors/paris_respire_extractor.py`	`traffic.pedestrianization`	Journée sans voiture `Q753154`	Source : la couche "Secteurs" du service ArcGIS publié par la Ville de Paris et utilisé par l'application officielle https://capgeo.maps.arcgis.com/apps/instant/basic/index.html?appid=a60e05b97e48466ab5d76754773a9a1a ("Paris Respire") : https://capgeo2.paris.fr/public/rest/services/DVD/DVD_Paris_Respire/MapServer/1
Épisodes de vigilance météorologique canicule par département (Météo-France) `extractors/meteo_france_vigilance_extractor.py`	`hazard.heatwave`	canicule `Q215864`	Source : flux public Vigilance archivé de Météo-France, sans clé, publié sur data.gouv.fr et hébergé sur files.data.gouv.fr :
Étapes de chantier déjà réalisées des paires de réacteurs EPR2 (Penly, Bugey) `extractors/epr2_construction_extractor.py`	`energy.construction.nuclear`
Étapes du Tour de France 2026 (hommes) et du Tour de France Femmes 2026 `extractors/tour_de_france_2026_extractor.py`	`sport.cycling.tour_de_france`	Tour de France `Q33881`
États des dossiers réglementaires (ASN) et prototypes des startups françaises de petits réacteurs modulaires (SMR/AMR) `extractors/french_smr_startups_extractor.py`	`energy.nuclear.smr_status`		Source : jalons curés (`french_smr_startups_milestones.json`) — aucune API ni page de suivi structurée trouvée côté ASN/ASNR pour l'avancement des projets SMR par porteur (contrairement aux arrêts programmés du parc existant, cf. `nuclear_monitor_extractor.py`). Les étapes du processus « d'examen amont » ASN (1. veille prospective, 2. examen préalable, 3. pré-instruction, 4. demande de décr…
Évènements Magic: The Gathering (Melee.gg) `extractors/mtg_events_extractor.py`	`culture.cards.magic_the_gathering`	tournoi (Magic: The Gathering) `Q2461450`	Source : https://melee.gg — plateforme de gestion de tournois utilisée par de nombreuses boutiques/clubs pour organiser leurs évènements Magic: The Gathering (drafts, scellés, Commander, Standard, Modern, Legacy...), Pokémon, Star Wars Unlimited, Lorcana, etc.
Évènements associatifs de Bordeaux `extractors/bordeaux_associations_extractor.py`	`culture.other`		Sources : 1. Agenda des assos — https://associations.bordeaux.fr/agenda (plateforme municipale, JSON géolocalisé + fiches HTML) 2. OpenAgenda Bordeaux Métropole (option --also-met-agenda) https://datahub.bordeaux-metropole.fr/explore/dataset/met_agenda/
Évènements astronomiques et de météo spatiale notables (1926-2026) `extractors/astronomical_events_extractor.py`	`space.eclipse.solar`	éclipse solaire `Q3887`
Évènements autour de la géomatique/données géospatiales et du hacking `extractors/europe_geo_hacking_events_extractor.py`	`culture.floss.tal`
Évènements autour des logiciels et projets libres en Espagne `extractors/spain_floss_events_extractor.py`	`culture.floss.tal`
Évènements autour des logiciels libres et des données ouvertes au Japon `extractors/japan_floss_opendata_events_extractor.py`	`culture.floss.tal`
Évènements autour des logiciels libres et des données ouvertes au Royaume-Uni `extractors/uk_floss_opendata_events_extractor.py`	`culture.floss.tal`
Évènements autour des logiciels libres et des données ouvertes en Suisse `extractors/switzerland_floss_opendata_events_extractor.py`	`culture.floss.tal`
Évènements culturels Grand Paris Sud (Essonne / Seine-et-Marne sud) `extractors/grand_paris_sud_culture_extractor.py`	`culture.other`		Source : OpenDataSoft « evenements » — jeu data.gouv.fr https://www.data.gouv.fr/datasets/evenements-de-grand-paris-sud Ressource GeoJSON : 940d69ec-ae39-4c0d-8f8f-861825f9104a
Évènements municipaux de Rouen et Dieppe `extractors/rouen_dieppe_events_extractor.py`	`culture.other`		Source : jeu OpenDataSoft national « Public events - OpenAgenda » https://public.opendatasoft.com/explore/dataset/evenements-publics-openagenda/ (agrégat national de tous les évènements publics publiés sur OpenAgenda, filtré ici sur `location_city` = Rouen / Dieppe)
Évènements sportifs `extractors/sport_events_extractor.py`	`sport.hikin`		Sources : 1. `rando_essonne` — https://randoevasion91.fr (programme détaillé : date, heure, lieu, distance, durée) 2. `rando_idf` — https://www.ffrandonnee-idf.fr/événements (agenda régional FFRandonnée Île-de-France, plusieurs clubs/CDRP, moins détaillé : pas d'heure ni de distance, localisation au département) 3. `cevennes` — https://destination.cevennes-parcnational.fr (API Geotrek…
Évènements vélo associatifs (FR/CH/BE) `extractors/cycling_associations_extractor.py`	`sport.cycling.other`

API REST

Base URL de production : https://api.openeventdatabase.org. L'éditeur Angular consomme la même API via le préfixe /api sur edit.oedb.cipherbliss.com.

Endpoints principaux

Méthode	Chemin	Description
GET	`/event`	Liste d'évènements (filtres query string)
POST	`/event`	Création d'un évènement (GeoJSON Feature)
GET/PUT/DELETE	`/event/{id}`	Lecture, mise à jour, suppression
GET	`/event/search`	Recherche spatiale avancée (géométrie POST)
GET	`/stats`	Statistiques agrégées
GET	`/rss`	Flux RSS des 200 derniers évènements
GET	`/db/dumps`	Liste des archives (instance locale)
POST	`/db/dumps/create`	Génère un dump SQL + GeoJSON

Paramètres de requête `GET /event`

Paramètre	Format	Description
`what`	string	Filtre par catégorie (préfixe), ex. `traffic.accident`
`when`	ISO8601 / mot-clé	`now`, `today`, `last7days`, `next30days`…
`start / stop`	ISO8601 / mot-clé	Plage temporelle (évènements qui chevauchent l'intervalle)
`bbox`	lon,lat,lon,lat	Boîte englobante (Est, Sud, Ouest, Nord)
`near`	lon,lat[,m]	Proximité d'un point ; distance max en mètres (défaut 1 m)
`polyline`	encodée	Évènements le long d'un itinéraire ; `buffer` en mètres
`type`	scheduled \| forecast \| unscheduled	Nature temporelle de l'évènement
`limit`	entier	Nombre max de résultats (défaut 200)
`offset`	entier	Pagination (si supportée par l'instance)
`geom`	full \| only \| nombre	Niveau de détail géométrique dans la réponse
`where:osm`	id OSM	Filtre par référentiel OpenStreetMap
`where:wikidata`	Q-id	Filtre par entité Wikidata
`tag`	expression, répétable	Filtre sur les tags : `clé`, `!clé`, `clé=v`, `clé=a\|b`, `clé~texte`, `clé>=5`, `clé=a..b` (backend local et réplique)
`tag_mode`	all \| any	Combinaison des filtres `tag` : ET (défaut) ou OU
`after / before`	id d'évènement	Pagination par curseur (ordre de création), voir `cursor` dans la réponse

Exemples

# Alertes météo actives à une date
GET https://api.openeventdatabase.org/event?when=2026-07-15T12:00:00Z&what=weather.alert

# Accidents près de Paris (10 km, 10 dernières minutes)
GET https://api.openeventdatabase.org/event?what=traffic.accident&near=2.3522,48.8566,10000&when=last10minutes

# Conférences sur une plage temporelle
GET https://api.openeventdatabase.org/event?what=culture&start=2026-01-01&stop=2026-12-31&limit=50

# Évènements dans une bbox (France métropolitaine approx.)
GET https://api.openeventdatabase.org/event?bbox=-5.0,41.0,10.0,52.0&geom=full

Bac à sable interactif : Swagger Petstore (spec swagger.json sur la forge). Instance locale avec UI intégrée : /swagger. Détail des paramètres : doc/api_query_params.md.

Lancer l'API

Prérequis : PostgreSQL/PostGIS, Python 3, variables d'environnement (.env).

Docker (recommandé)

cp .env.example .env
docker-compose up -d
# API disponible sur http://localhost:8080

Installation locale

python3 -m venv venv && source venv/bin/activate
pip install -r requirements.txt
bash setup_db.sh
python3 backend.py
# ou : uwsgi --http :8080 --wsgi-file backend.py --callable app

Variables d'environnement

Variable	Rôle
`DB_NAME`, `DB_HOST`, `DB_USER`	Connexion PostgreSQL
`POSTGRES_PASSWORD`	Mot de passe base
`CLIENT_ID`, `CLIENT_SECRET`	OAuth (édition sécurisée)

Synchroniser des archives depuis l'API publique

python3 extractors/oedb_sync_extractor.py --mode sync \
  --since 2026-01-01 --until 2026-01-31 \
  --batch-size 1000 --no-dry-run --output-dir dumps

python3 scripts/generate_landing_html.py

Pages de l'éditeur

L'éditeur cartographique Angular est servi sur https://edit.oedb.cipherbliss.com. Il permet de visualiser, filtrer, créer et contrôler la qualité des évènements OEDB.

Route	Page	Description
/	Accueil / carte	Carte principale, filtres par type what, bascule carte/tableau, recherche.
/event/create	Créer un évènement	Formulaire de création avec géolocalisation et presets de catégories.
/agenda	Agenda	Vue calendrier (mois, semaine, jour) des évènements.
/unlocated-events	Événements non localisés	Liste des évènements sans coordonnées valides à corriger.
/quality-control	Contrôle qualité	Détection d'anomalies et validation des données.
/jardinage	Jardinage (anti-spam)	Contrôle qualité thématique pour évènements suspects de spam.
/batch-edit	Modification en masse	Édition groupée de plusieurs évènements.
/events-docs	Events docs	Exploration des types what, presets et propriétés attendues.
/research	Research	Recherche avancée et exploration des jeux de données.
/nouvelles-categories	Nouvelles catégories	Suivi des types what émergents.
/stats	Statistiques	Comptages et tendances (proxy vers l'API /stats).
/demo	Hub démos	Index des démos thématiques alimentées par extracteurs.
/demo/ev-charging	Démo recharge VE	Sessions de recharge véhicule électrique.
/demo/wildlife-observations	Démo faune	Observations animales (cerfs, sangliers, lucioles, hérissons, grenouilles).
/demo/laws	Démo lois adoptées	Textes promulgués ou adoptés (CLAIR.vote).
/demo/science	Démo découvertes	Dates de découvertes scientifiques Wikidata.
/demo/space-launches	Démo lancements	Lancements spatiaux Launch Library 2.
/demo/bordeaux-associations	Démo assos Bordeaux	Agenda associatif bordelais.
/demo/renewable-construction	Démo éolien / solaire	Chantiers renouvelables (ODRÉ RNAé).
/extractors-monitor	Suivi extracteurs	Historique des runs d'extracteurs (JSON statique extractors-monitor.json).
/dumps	Archives dumps	Liste des snapshots GeoJSON/SQL (instance locale).

Ouvrir l'éditeur →

Archives de dumps

Snapshots GeoJSON et SQL générés par l'extracteur de synchronisation et par POST /db/dumps/create. Regroupés par année lorsque le nom de fichier contient une période (oedb_YYYYMM_…).

Aucun dump disponible pour le moment.