Guide pratiche

Pubblica dati aperti comprensibili e documentati

I dati scaricabili non sono ancora dati comprensibili. Un riutilizzatore deve sapere chi l'ha prodotto, cosa copre, cosa esclude e come interpretare i suoi campi.

vedere il metodo

Illustrazione — Pubblica dati aperti comprensibili e documentati
Illustrazione generata dall’IA

Stabilire provenienza e portata

Descrivere il produttore, il metodo di raccolta, il periodo di tempo e la copertura geografica o tematica. distinguere le date di estrazione, aggiornamento e misurazione. Un file pubblicato oggi può descrivere una misurazione precedente; La pubblicazione non cambia l'anno di riferimento.

Indica le aree mancanti e i valori approssimativi in cui la fonte le identifica. Non colmare una lacuna con una stima non rivelata. La guida alla documentazione di data.gouv.fr affronta il contesto di produzione, la struttura e le possibili incongruenze.

Fornisci un dizionario e un esempio

Spiega ogni campo, unità, tipo, valore mancante e codice di riferimento. Fornire un piccolo esempio leggibile coerente con il set di dati completo. dove gli identificatori si uniscono a tabelle, relazioni di documenti e righe potenzialmente impareggiabili.

distinguere le entità dalle loro etichette. Un comune può avere diversi codici postali e un prodotto diverse varianti. La documentazione dovrebbe aiutare a prevenire l'aggregazione o la deduplicazione ingannevole che rimuova una relazione utile.

Per dati geografici documentare riferimento e ordine delle coordinate, non solo il formato. RFC 7946 definisce GeoJSON con WGS 84 e gradi decimali; i primi due valori sono longitudine e latitudine. Nell’esercizio fittizio, Point [2.35,48.86] non deve diventare [48.86,2.35]. Entrambi gli array sono JSON leggibile con numeri plausibili: la sola verifica sintattica non rileva lo scambio.

Distinguere un’entità non localizzata da un punto noto. In una Feature GeoJSON non localizzata geometry può essere null; non equivale a un Point con coordinate nulle né a sostituire un valore ignoto con [0,0], una posizione reale. Descrivere inoltre ingresso osservato, indirizzo geocodificato o centro calcolato, con provenienza e data. Aggiungere decimali non rende più certa una stima.

Scorri la tabella orizzontalmente per leggere tutte le colonne. Con la tastiera, porta il focus sulla tabella e usa i tasti freccia.

Esercizio fittizio: controllare il significato oltre il JSON leggibile
CasoInterpretazioneControllo utile
Point · coordinates: [2.35,48.86]Longitudine 2.35; latitudine 48.86Confrontare con i campi nominati della fonte
Point · coordinates: [48.86,2.35]Numeri plausibili, invertiti nell’esercizioControllare il significato; la sintassi non basta
Feature · geometry: nullEntità non localizzata; frammento di strutturaDocumentare l’assenza senza inventare un punto
Posizione [0,0]Coordinate esistenti, non assenzaNon sostituire automaticamente un dato ignoto

Controlla la pubblicazione e il riutilizzo

Identificare le condizioni di riutilizzo della fonte e le informazioni sull'attribuzione da conservare. Chiedi ai revisori appropriati di valutare i diritti di pubblicazione e i possibili dati personali prima del rilascio pubblico. Un indirizzo visibile altrove non rende automaticamente ogni copia adatta alla pubblicazione.

Testare i download senza strumenti interni o account speciali quando è promesso l'accesso pubblico. Controlla il formato, la codifica e l'integrità. Fornire un riferimento alla versione o un checksum in modo che il feedback possa essere legato al file scaricato.

Mantieni versioni e correzioni

Scegli una frequenza di revisione realistica e un contatto per i problemi. Descrivi campi aggiunti, rimossi o ridefiniti quando gli schemi cambiano. Distinguere le correzioni dalle nuove misurazioni per evitare di creare falsi cambiamenti in una serie temporale.

Conserva versioni e note utili con una chiara politica di sostituzione. La documentazione di pubblicazione dovrebbe consentire a un'altra persona di riprodurre l'estrazione o comprendere i suoi limiti. Un contatore di download non sostituisce la qualità della documentazione.

Documentazione primaria: data.gouv.fr : Bien documenter un jeu de données.

Distinguete il dataset dalle sue distribuzioni. Un CSV e un JSON possono rappresentare lo stesso dataset in due formati; non contateli automaticamente come due misurazioni indipendenti. DCAT descrive una distribuzione come una rappresentazione specifica del dataset. Confrontate comunque copertura, precisione, campi e versione: due distribuzioni non sono necessariamente equivalenti senza perdita d’informazione.

Aggiungete un identificatore di versione e una cronologia delle correzioni. Un indirizzo «ultima versione» può restare stabile, ma occorre poter identificare quella effettivamente usata. Distinguete anche correzione e nuova osservazione: misurare un nuovo mese non corregge da solo il precedente. Spiegate il rapporto tra versioni e serie prima di confrontare i numeri.

Scorri la tabella orizzontalmente per leggere tutte le colonne. Con la tastiera, porta il focus sulla tabella e usa i tasti freccia.

Pubblicazione dei dati: identificare oggetto, formato e revisione
Elemento documentaleCosa distingueControllo utile
DatasetArgomento, ambito e osservazioni descritte.L’identità resta comprensibile indipendentemente dal formato del file.
Distribuzione CSV o JSONUna rappresentazione specifica del dataset.Confrontare campi, precisione e copertura prima di supporre equivalenza.
Versione identificataUno stato preciso e la cronologia delle modifiche.Ritrovare la versione citata anche se un indirizzo corrente è aggiornato.
Correzione o nuovo periodoUn valore rivisto o un’osservazione diversa.Non presentare un nuovo mese come correzione automatica del precedente.

Documenti di riferimento

Contenuto aggiornato

Riferimenti documentati per questo argomento

Riferimenti documentati per questo argomento
RiferimentoValore o sintassiAmbito
RFC 4180 · CSV
text/csv · "a,b"I campi con virgole, virgolette o ritorni a capo sono racchiusi tra virgolette; quelle interne raddoppiate.
RFC 8259 · JSON
application/json · UTF-8JSON standard non ammette commenti né virgole finali; le stringhe usano virgolette doppie.

Le date indicano la consultazione delle fonti. Questi riferimenti non costituiscono un audit del sito né una dichiarazione globale di conformità.

Matrice di convalida funzionale per adattarsi al progetto

Questi controlli proposti utilizzano casi fittizi. Decidi quale comportamento è previsto con il team, annota il risultato e assegna discrepanze irrisolte prima della pubblicazione.

Scorri la tabella orizzontalmente per leggere tutte le colonne. Con la tastiera, porta il focus sulla tabella e usa i tasti freccia.

Casi di test, risultati attesi e prove utili
Casorisultato attesoProva da mantenere
Download pubblico pubblicizzatoUna persona esterna ottiene un file leggibile senza strumenti interni.Indirizzo, formato, dimensioni e apertura riuscita in un lettore comune.
Campo e unità selezionatiL'esempio e il file completo utilizzano la stessa definizione.Dizionario, esempio e confronto di valori noti in entrambe le rappresentazioni.
Identificatore sconosciuto e non corrispondenteLe limitazioni rimangono visibili senza sostituire un valore plausibile.righe interessate e regole documentate per rappresentare informazioni sconosciute o non corrispondenti.
Correzione pubblicataUn reutente può distinguere una correzione da una nuova misurazione.Versione, Modifica Descrizione e Date di riferimento conservate con il file pubblicato.

Domande frequenti

Quale data dovrebbe accompagnare un file?

Ove pertinente, mostra l'estrazione, l'ultima modifica e il periodo coperto come date denominate separatamente. Non presentare automaticamente il tempo di download come anno di riferimento di una popolazione o di un'altra misurazione.

Una licenza da sola rende i dati utilizzabili?

Definisce le condizioni di riutilizzo, ma anche campi, unità, identificatori, copertura, qualità e versioni richiedono una spiegazione. Un'altra persona dovrebbe essere in grado di riprodurre o almeno comprenderne l'uso.