{
    "product": "openagenda_wine_events",
    "status": "sample_retrieved",
    "generated_at": "2026-07-06T18:01:30+00:00",
    "source_name": "OpenAgenda public events",
    "producer": "OpenAgenda",
    "dataset_identifier": "evenements-publics-openagenda",
    "data_gouv_url": "https://www.data.gouv.fr/datasets/evenements-geolocalises-et-opendata",
    "api_documentation_url": "https://developers.openagenda.com/",
    "opendatasoft_metadata_url": "https://public.opendatasoft.com/api/explore/v2.1/catalog/datasets/evenements-publics-openagenda",
    "sample_query_url": "https://public.opendatasoft.com/api/explore/v2.1/catalog/datasets/evenements-publics-openagenda/records?limit=20&timezone=Europe%2FParis&q=vin%20OR%20vignoble%20OR%20degustation%20OR%20oenologie%20OR%20gastronomie",
    "recommended_threshold": 35,
    "source_files": [
        {
            "key": "data_gouv_metadata",
            "path": "sources/openagenda-public-events-datagouv.json",
            "description": "Metadonnees data.gouv du jeu Evenements geolocalises et OpenData."
        },
        {
            "key": "opendatasoft_metadata",
            "path": "sources/openagenda-public-events-metadata.json",
            "description": "Schema Opendatasoft du dataset evenements-publics-openagenda."
        },
        {
            "key": "wine_keyword_sample",
            "path": "sources/openagenda-wine-events-sample.json",
            "description": "Echantillon API filtre par mots-cles vin, vignoble, degustation, oenologie et gastronomie."
        }
    ],
    "matching_terms": [
        "vin",
        "vins",
        "vignoble",
        "vignobles",
        "degustation",
        "dégustation",
        "oenologie",
        "œnologie",
        "cave",
        "caves",
        "chai",
        "chais",
        "viticulture",
        "vigneron",
        "vigneronne",
        "vendanges",
        "route des vins",
        "foire aux vins",
        "salon des vins",
        "accords mets vins",
        "gastronomie"
    ],
    "schema": [
        {
            "column": "event_uid",
            "description": "Identifiant OpenAgenda stable si disponible."
        },
        {
            "column": "title",
            "description": "Titre public de l evenement."
        },
        {
            "column": "description",
            "description": "Description courte nettoyee."
        },
        {
            "column": "event_url",
            "description": "URL canonique OpenAgenda."
        },
        {
            "column": "start_at",
            "description": "Date et heure de debut."
        },
        {
            "column": "end_at",
            "description": "Date et heure de fin."
        },
        {
            "column": "updated_at",
            "description": "Date de mise a jour OpenAgenda."
        },
        {
            "column": "location_name",
            "description": "Nom du lieu."
        },
        {
            "column": "address",
            "description": "Adresse du lieu."
        },
        {
            "column": "city",
            "description": "Commune."
        },
        {
            "column": "postal_code",
            "description": "Code postal."
        },
        {
            "column": "insee_code",
            "description": "Code INSEE commune."
        },
        {
            "column": "department",
            "description": "Departement."
        },
        {
            "column": "region",
            "description": "Region."
        },
        {
            "column": "lat",
            "description": "Latitude WGS84."
        },
        {
            "column": "lon",
            "description": "Longitude WGS84."
        },
        {
            "column": "origin_agenda",
            "description": "Agenda producteur."
        },
        {
            "column": "status_label",
            "description": "Statut programme, annule, reporte si renseigne."
        },
        {
            "column": "wine_relevance_score",
            "description": "Score de pertinence vin/oenotourisme calcule par mots-cles."
        },
        {
            "column": "matched_terms",
            "description": "Termes vin/gastronomie trouves."
        },
        {
            "column": "kpi_use",
            "description": "Usage KPI recommande."
        },
        {
            "column": "source_url",
            "description": "URL source OpenAgenda ou data.gouv."
        },
        {
            "column": "normalized_at",
            "description": "Horodatage de normalisation."
        }
    ],
    "kpis": [
        {
            "key": "wine_event_signal",
            "label": "Signal evenementiel vin",
            "definition": "Nombre et densite d evenements OpenAgenda lies au vin, vignoble, degustation ou gastronomie.",
            "user_need": "Expliquer les pics de demande et enrichir les pages territoire avec un contexte vivant.",
            "aggregation": "Compter les evenements par territoire et periode, puis ponderer par pertinence vin.",
            "caveat": "OpenAgenda depend des agendas contributeurs : couverture non exhaustive et classification variable."
        },
        {
            "key": "territory_activation_score",
            "label": "Score activation territoire",
            "definition": "Signal composite indiquant si un territoire anime son offre vin/tourisme par des evenements visibles.",
            "user_need": "Comparer les territoires au-dela de l offre statique.",
            "aggregation": "Combiner nombre d evenements pertinents, fraicheur, diversite agendas et localisation.",
            "caveat": "Un territoire peu present dans OpenAgenda peut avoir des evenements hors plateforme."
        },
        {
            "key": "tourism_demand_context",
            "label": "Contexte demande touristique",
            "definition": "Evenements qui contextualisent la demande touristique autour des destinations vin.",
            "user_need": "Raconter pourquoi une periode ou un lieu peut generer plus d interet.",
            "aggregation": "Associer les evenements par commune, departement ou proximite a la page territoire.",
            "caveat": "Ce KPI ne mesure pas la frequentation reelle de l evenement."
        }
    ],
    "exports": {
        "json": "/api/get_openagenda_wine_events.php?format=json",
        "markdown": "/api/get_openagenda_wine_events.php?format=md",
        "csv": "/api/get_openagenda_wine_events.php?format=csv"
    },
    "normalizer": "scripts/normalize_openagenda_wine_events.php",
    "input_template": "sources/openagenda-wine-events-input-template.csv",
    "normalized_target": "sources/openagenda-wine-events-normalized.csv",
    "publication_caveat": "OpenAgenda est une source evenementielle contributive : ne pas inferer une exhaustivite territoriale ou une frequentation reelle sans source complementaire."
}