f1db

F1DB

F1DB est la base de données open source gratuite la plus complète contenant des données et des statistiques de tous les temps sur les courses de Formule 1.

Que vous créiez un site Web personnalisé, une application mobile ou que vous utilisiez simplement F1DB pour interroger des données, voici ce que nous proposons :

• Tous les pilotes
• Tous constructeurs (y compris châssis)
• Tous les constructeurs de moteurs (y compris les moteurs)
• Tous les fabricants de pneus
• Tous les circuits et données de localisation
• Toutes les saisons de 1950 à aujourd'hui ; y compris:
  • participants
  • classement
• Toutes les courses ; y compris:
  • résultats des essais libres et de l'échauffement
  • résultats des qualifications et des pré-qualifications
  • résultats des courses de sprint
  • positions sur la grille de départ
  • résultats des courses
  • tours les plus rapides
  • arrêts aux stands
  • résultats du pilote du jour
  • classement

Les nouvelles versions seront disponibles dès que possible après chaque course. Voir également Gestion des versions.

Les artefacts de version sont disponibles dans les formats suivants :

• CSV
• JSON
• JSON divisé (plusieurs fichiers de données)
• Smile (variante binaire du format JSON)
• SQL (fichiers de dump MySQL, PostgreSQL ou SQLite .sql pour créer et remplir une base de données personnalisée)
• Base de données SQLite

Modifications notables et révolutionnaires dans v2024.19.0

• Ajout de données sur le châssis et le moteur.
• Ajout des détails de la position de qualification ( qualificationPositionNumber et qualificationPositionText ) aux résultats de course et aux positions sur la grille de départ.
• Ajout d'une statistique de points totaux ( totalPoints ) pour les constructeurs et les motoristes.
• Ajout de statistiques de saison détaillées pour les pilotes, les constructeurs, les fabricants de moteurs et les fabricants de pneus.
• Renommé ConstructorPreviousNextConstructor en ConstructorChronology
• Ajout de positionDisplayOrder explicite à DriverFamilyRelationship , ConstructorChronology , PracticeResult , QualifyingResult , StartingGridPosition , RaceResult , FastestLap , PitStop , DriverOfTheDayResult , RaceDriverStanding , RaceConstructorStanding , SeasonDriverStanding et SeasonConstructorStanding .

Pour prendre en compte ces modifications (réruptes), le schéma JSON est remplacé par la version v5.0.0 .

Schéma JSON F1DB

Le fichier de schéma principal f1db.schema.json contient toutes les définitions d'objets F1DB et sert de documentation principale.

Pour les distributions fractionnées, les fichiers de schéma fractionnés doivent être utilisés.

Les artefacts JSON et Smile sont validés par rapport au schéma Json F1DB.

Compatibilité / historique des versions du schéma

Version	Version du schéma
>= v2024.19.0	f1db.schema.json v5.0.0 , f1db-*.schema.json v5.0.0 splitted
>= v2024.0.0.beta2	f1db.schema.json v4.1.0 , f1db-*.schema.json v4.1.0 splitted
>= v2024.0.0.beta1	f1db.schema.json v4.0.0 , f1db-*.schema.json v4.0.0 splitted
>= v2023.22.0	onlyf1-db.schema.json v3.2.0 , onlyf1-db-*.schema.json v3.2.0 splitted
>= v2023.8.0	onlyf1-db.schema.json v3.1.0 , onlyf1-db-*.schema.json v3.1.0 splitted
>= v2023.4.0	onlyf1-db.schema.json v3.0.0 , onlyf1-db-*.schema.json v3.0.0 splitted
>= v2023.0.0.beta1	onlyf1-db.schema.json v2.0.0 , onlyf1-db-*.schema.json v2.0.0 splitted
>= v2022.1.1	f1db-json-schema-v1.4.0.json
>= v2022.0.0	f1db-json-schema-v1.3.0.json
>= v2022.0.0.beta4	f1db-json-schema-v1.3.0.json
>= v2022.0.0.beta3	f1db-json-schema-v1.2.0.json
>= v2022.0.0.beta2	f1db-json-schema-v1.1.0.json
>= v2022.0.0.alpha1	f1db-json-schema-v1.0.0.json

Base de données F1DB SQL/SQLite

L'artefact de base de données SQLite contient toutes les données dans un format de base de données relationnelle et peut être utilisé pour interroger directement les données au lieu de traiter le format JSON.

Le fichier de base de données pourrait également servir aux étudiants souhaitant apprendre SQL.

Nous suggérons d'utiliser SQLiteStudio pour interroger le fichier de base de données. Bien entendu, n’importe quel client SQL compatible SQLite peut également être utilisé.

Depuis v2024.3.0 des artefacts SQL sont disponibles pour MySQL, PostgreSQL et SQLite qui fournissent des fichiers de dump .sql pour importer le schéma et les données directement dans ces systèmes de base de données.

Si vous souhaitez remplir un autre système de base de données (par exemple H2), le fichier de vidage PostgreSQL .sql est probablement votre meilleure option. Si cela ne fonctionne pas et que vous souhaitez qu'un fichier de vidage .sql pour un autre système de base de données soit ajouté aux artefacts de la version, veuillez créer une demande de fonctionnalité.

Gestion des versions

Les versions sont versionnées à l'aide d'un schéma de versioning CalVer « personnalisé » :

 YYYY.RR.MICRO(.MODIFIER)

qui utilise les conventions suivantes :

• AAAA – Année complète de la saison – 2024 , ..
• RR – Numéro de ronde dans la saison – 0 , 1 , 2 , .., 10 , 11 , ..
• MICRO – Version patch – 0 , 1 , 2 , ..
• MODIFICATEUR – Une balise de texte facultative comme dev , alpha , beta , rc , ..

Notez qu'il s'agit essentiellement du modèle YYYY.MINOR.MICRO(.MODIFIER) où MINOR indique le nombre rond ( RR ).

Exemples :

• 2024.0.0.alpha – Sortie alpha de pré-saison avant la ^1ère manche de course de la saison 2024.
• 2024.0.0.beta – Sortie bêta de pré-saison avant la ^1ère manche de course de la saison 2024.
• 2024.0.0 – Sortie finale de pré-saison avant la ^1ère manche de course de la saison 2024.
• 2024.0.1 – Première sortie du patch de pré-saison avant la ^première manche de course de la saison 2024.
• 2024.1.0 – Sortie finale après la ^1ère manche de course de la saison 2024.
• 2024.2.0 – Sortie finale après la 2 ^ème manche de course de la saison 2024.
• 2024.2.1 – Sortie du premier patch après la 2 ^e manche de course de la saison 2024.
• 2024.2.2 – Deuxième sortie de patch après la 2 ^ème manche de course de la saison 2024.

Comme vous pouvez le constater, nous utilisons un RR 0 spécial pour les sorties de pré-saison.

Communauté

La communauté F1DB se trouve sur les discussions GitHub, où vous pouvez poser et répondre à des questions, exprimer des idées et partager vos projets.

Restez en contact avec nous en nous suivant sur X — @F1DB_com.

Signalement des problèmes de données

Nous utilisons les problèmes GitHub pour suivre les problèmes de données ou les problèmes associés.

Si vous avez trouvé un problème de données qui n'a pas encore été signalé, veuillez créer un nouveau problème.

Construire à partir de la source

Pour créer les zips de distribution, exécutez simplement :

 ./gradlew clean dist assemble

Nécessite Java 21.

Libération

GitHub Actions est utilisé pour créer et télécharger de nouvelles versions en créant une nouvelle balise git.

Suivez ces étapes :

1. Mettre à jour le numéro de version dans gradle.properties
2. git commit -am "Release v<version>"
3. git push
4. git tag -a v<version> -m "Release v<version>"
5. git push origin v<version>

et l'action de libération est automatiquement déclenchée en appuyant sur la nouvelle balise.

Licence

F1DB est sous licence internationale Creative Commons Attribution 4.0.