API publique

Accéder aux métadonnées du catalogue au format JSON, librement et sans clé

Le catalogue GPRbase est exposé au format JSON. L'API est en lecture seule, ouverte à tous, sans clé ni inscription, et autorise les appels depuis un navigateur.

Points d'entrée

Deux adresses suffisent. Les réponses sont mises en cache une heure.

Catalogue complet

GET https://www.gprbase.com/api/datasets.json

Renvoie tous les jeux de données avec leurs métadonnées, ainsi que le nombre total et la date de génération.

Un jeu de données

GET https://www.gprbase.com/api/datasets/{id}.json

Les mêmes champs, complétés par une citation prête à l'emploi aux formats APA et BibTeX. La recherche de l'identifiant ne tient pas compte de la casse.

/api/datasets/ds016.json

Champs d'un jeu de données

Chaque entrée du catalogue contient les champs suivants. D'autres pourront être ajoutés : ignorez ceux que vous ne connaissez pas plutôt que de valider strictement.

Champ Type Description
id string Identifiant stable, par exemple ds016. Jamais réattribué.
title / title_fr string Titres anglais et français.
description / description_fr string Descriptions bilingues. Les sauts de ligne et les paragraphes sont conservés.
applications array Clés canoniques d'application. Un jeu peut relever de plusieurs domaines.
antenna string Une ou plusieurs antennes, séparées par un point-virgule.
frequency_mhz string Valeur unique, bi-fréquence sous la forme 300/800, ou plusieurs valeurs séparées par un point-virgule.
format string Format natif des fichiers, généralement DZT.
dataType string Toujours raw : aucun traitement n'est appliqué aux données.
fileCount integer | null Nombre de fichiers du paquet, lorsqu'il est renseigné.
targets array Cibles recherchées lors de l'acquisition.
channels integer | null Nombre de canaux enregistrés simultanément. 2 pour une antenne bi-fréquence ou deux antennes. Nul si non renseigné.
gpsAvailable boolean | null Les fichiers de positionnement .DZG sont-ils inclus ? Nul lorsque l'information n'est pas connue — un champ vide ne signifie pas « non ».
groundTruth string Niveau de vérité terrain : verified, partial ou none. Un jeu sans validation documentée vaut none.
groundTruthMethod string | null Méthode de validation, lorsqu'elle est connue : carottage, tranchée de reconnaissance, bibliographie, observation directe.
contributor string Auteur de l'acquisition sur le terrain.
datePublished string | null Date de publication au format ISO 8601.
license string Toujours CC BY-NC-SA 4.0.
status string Visibilité du jeu de données. Seuls les jeux publics sont librement accessibles.
isAccessibleForFree boolean Vrai lorsque le jeu est en libre accès.
url / url_fr string | null Adresses canoniques des fiches, en français et en anglais. Nulles pour un jeu non public.

Clés d'application

Les valeurs sont renvoyées sous forme canonique, quelle que soit la saisie d'origine.

  • beton — Béton / Génie civil
  • reseaux — Réseaux enterrés
  • geotech — Géotechnique
  • routes — Routes / Chaussées
  • archeologie — Archéologie
  • geosciences — Géosciences

Les champs antenne et fréquence sont des chaînes de caractères et non des tableaux : à vous de les découper, ou d'utiliser le client qui s'en charge.

Vérité terrain

La plupart des jeux de données géoradar librement accessibles ne disent rien de leur validation. GPRbase l'expose explicitement, parce que la différence entre une interprétation plausible et une cible vérifiée est décisive pour évaluer un algorithme.

verified La cible a été confirmée par un moyen indépendant du radar.
partial Une partie des cibles est confirmée, ou le contexte est documenté sans vérification directe.
none Aucune validation documentée. C'est le cas de la majorité du catalogue.

Ces jeux ne sont pas des références d'évaluation : ils ne sont pas annotés et ne comportent ni masques ni boîtes englobantes. Vérifiez ce champ avant tout usage en validation ou en comparaison.

Citations

L'appel à un jeu de données renvoie une citation formatée. L'auteur est l'entité éditrice ; l'équipe de terrain, lorsqu'elle est externe, est créditée séparément comme auteur de l'acquisition.

Ce que l'API ne fait pas

  • Aucune écriture. Le catalogue se met à jour par une interface d'administration distincte.
  • Aucun lien de téléchargement. L'API renvoie l'adresse de la fiche ; l'accès aux fichiers passe par le formulaire de demande.
  • Aucune recherche côté serveur. Récupérez le catalogue une fois et filtrez localement : la collection est petite.

Client Python et JavaScript

Un client officiel, sans dépendance et sous licence MIT, simplifie le filtrage, le découpage des champs multivalués et la production des citations.

from gprbase import GPRbase

gpr = GPRbase()
for d in gpr.datasets(application="beton", frequency="2500"):
    print(d.id, d.title, d.url)

GitHub   DOI 10.5281/zenodo.22010033

Bonnes pratiques

  • Récupérez le catalogue une fois plutôt qu'un jeu de données à la fois.
  • Identifiez votre outil par un en-tête User-Agent. Il n'y a pas de limitation de débit, mais cela aide en cas de problème.
  • Ignorez les champs que vous ne connaissez pas : de nouveaux peuvent apparaître sans préavis.

Licence et citation

Les métadonnées renvoyées par cette API sont librement réutilisables, y compris pour construire un catalogue ou un moteur de recherche. Les jeux de données eux-mêmes restent sous licence CC BY-NC-SA 4.0 : attribution obligatoire, pas d'usage commercial sans autorisation distincte, partage à l'identique.

Xavier, J. (2026). GPRBase: A Free Library of Real-World Ground Penetrating Radar Datasets for Education, Training and Research. https://doi.org/10.5281/zenodo.21894932

Questions

Pour toute question ou correction : info@gprbase.com