MDS
GPRviewer API

API Pointé IA

La API Punteo IA detecta automáticamente las armaduras (barras de refuerzo) en sus archivos de georradar (GPR, radar de penetración terrestre). Envíe un archivo y reciba la posición (m) y la profundidad (cm) de cada armadura, en unos segundos.

Nuestro propio modelo, el del Punteo IA de GPRviewer: entrenado en Francia, en nuestros propios servidores, a partir de mediciones validadas por los expertos de MDS.

Sin suscripción · Facturación por metro de perfil · Integración en unas pocas líneas

Pas développeur ? Le Pointé IA est inclus dans GPRviewer Pro : ouvrez vos fichiers, un clic, c'est pointé.

Radargramme d'une dalle en béton armé
Extrait de 1,2 m · calcul en moins d'une seconde

🔒 Sus archivos se analizan en nuestros servidores y luego se borran. Nadie los consulta.

Pruebe con su propio archivo

Sin cuenta y sin clave: suelte un radargrama y la API le devuelve sus armaduras en unos segundos.

Suelte un archivo aquí o haga clic para elegirlo .dzt, .nx, .sgy, .hf, .out / .h5 · 25 MB como máximo · 3 pruebas al día

Cómo funciona

Para los editores de software y las oficinas de ingeniería que procesan muchos archivos: integre el punteo de armaduras en su propia cadena de procesamiento, planos e informes.

1

Cree su clave

Créez votre compte gratuit dans votre espace API, puis une clé API en un clic. Déjà utilisateur de GPRviewer ? Le même compte fonctionne.

2

Envíe el archivo

Un simple POST avec le fichier radar brut, depuis votre logiciel, un script ou la ligne de commande.

3

Reciba el JSON

La lista de armaduras detectadas, con la distancia, la profundidad, el tiempo de ida y vuelta y un índice de confianza para cada una.

Rendimiento

852
armaduras por encontrar en la prueba, en mediciones de obra que el modelo nunca había visto
88 %
de las armaduras encontradas
1,3 mm
de diferencia media de profundidad con el punto marcado por el experto

{p5} % de las profundidades a menos de 5 mm del punto marcado por el experto, con la misma constante dieléctrica.

Cada perfil se procesa en unos segundos.

El modelo se reentrena con regularidad, y una nueva versión solo entra en servicio si supera a la anterior en las mismas mediciones de control.

Domaine de validité. Le modèle est entraîné pour les armatures du béton armé, sur des relevés d'antennes haute fréquence dédiées au béton (plus de 1 GHz), en majorité GSSI Flex NX, StructureScan XT / LXT, Mini LT et NX25. Les chiffres ci-dessus sont mesurés sur ces appareils. Un format accepté n'est pas une garantie de résultat : pour un autre appareil, ou un levé de réseaux à basse fréquence, vérifiez d'abord sur vos 200 m d'essai.

Los resultados son una ayuda a la interpretación y deben ser verificados por un operador cualificado.

Una IA de aprendizaje profundo

El Punteo IA se basa en una red neuronal convolucional (CNN), un modelo de aprendizaje profundo (deep learning), entrenado con radargramas de obras reales.

Con o sin IA

Con el Punteo IA
Punteo manual
Tiempo
Unos segundos por perfil: decenas de archivos procesados uno tras otro, sin intervención.
Cada hipérbola punteada a mano, una a una, radargrama tras radargrama.
Papel del operador
Revisa y corrige: elimina las detecciones falsas y añade las que faltan.
Hace todo el punteo él mismo.
Regularidad
El mismo criterio en todos los archivos, sea cual sea el operador.
El resultado varía de un operador a otro, y con el cansancio.

Formatos aceptados

  • GSSI (.dzt, .nx)SIR 3000 / 4000, StructureScan Mini / XT / LXT, Flex NX, UtilityScan DF, Mini LT, NX25 / NX15, Compass NX (.nx)
  • SEG-Y (.sgy)Proceq / Screening Eagle (GP8000, GP8800), Radsys y otros equipos que exportan en SEG-Y.
  • Hilti PS 1000 (.hf)5 voies : la voie 3 est analysée par défaut, paramètre channel pour en choisir une autre.
  • gprMax (.out, .h5)Simulaciones gprMax 3 (.out) y 4 (.h5): B-scan fusionado (outputfiles_merge).

Archivos de hasta 600 MB.

En un archivo de dos canales, se analiza el canal 1.

Próximamente

  • Sensors & Software (.dt1)
  • IDS GeoRadar (.dt)
  • Malå (.rd3, .rd7)
  • ImpulseRadar (.iprb)
  • Kontur, ex-3D-Radar (.vol)

Déjà lus par notre moteur, ces formats seront acceptés par l'API après validation sur des relevés béton. Vous en avez besoin ? Écrivez-nous à info@gprviewer.com.

Tarifas

Créditos de prepago, sin suscripción. Facturación por metro de perfil procesado, redondeado al metro superior, con un mínimo de 1 m por archivo. Precios sin IVA.

Prueba gratuita 200 m al crear su primera clave
Descubrimiento 1 000 m 50 € sin IVA es decir, 0,050 € / m
Volumen 25 000 m 750 € sin IVA es decir, 0,030 € / m
Grandes volúmenes + 25 000 m Contáctenos tarifa adaptada a su volumen

Confidencialidad

  • Sus archivos se reciben en nuestro alojamiento en Europa (Suiza) y se analizan en nuestros propios servidores, instalados en MDS.
  • El procesamiento es totalmente automático: nadie consulta sus archivos.
  • El archivo se borra en cuanto se entrega el resultado; su nombre nunca se registra.
  • Sus archivos nunca se utilizan para entrenar nuestros modelos ni se transmiten a terceros.

Condiciones de uso (resumen)

  • El uso de la API está sujeto a las condiciones generales de uso de GPRviewer.
  • Está prohibido utilizar los resultados para entrenar o reproducir un modelo competidor.
  • Límite de uso: 5 archivos en curso de cálculo simultáneamente por cuenta.
  • Los resultados se proporcionan como una ayuda a la interpretación, sin garantía de detección exhaustiva.

Documentación

API REST, respuestas en JSON, exclusivamente por HTTPS.

Ejemplo real, sobre el perfil mostrado

            

URL base

https://gprviewer.com/api

Les chemins ci-dessous s'ajoutent à cette base : POST /v1/rebars correspond à https://gprviewer.com/api/v1/rebars.

Autenticación

Transmettez votre clé dans l'en-tête Authorization: Bearer gpv_live_… ou, à défaut, dans X-API-Key: gpv_live_….

Authorization: Bearer gpv_live_xxxxxxxxxxxxxxxxxxxxxxxx
La clave solo se muestra una vez, al crearla: guárdela en un lugar seguro. Puede revocarla en cualquier momento desde su área de cliente. No la incluya nunca en código que se ejecute en los equipos de sus usuarios (navegador, aplicación distribuida).

Analizar un archivo

POST/v1/rebars?filename=SCAN_001.DZT[&epsr=6.5][&channel=3][&traces_per_m=200][&wait=30]

Corps de la requête : le fichier brut (Content-Type: application/octet-stream), ou un envoi multipart/form-data avec un champ file.

ParámetroDescripción
filenameObligatoire. Nom du fichier, extension comprise (ou en-tête X-File-Name) : l'extension détermine le format.
epsrOpcional, de 1 a 81. Permitividad relativa utilizada para la conversión tiempo → profundidad. Si se omite, la registrada en el archivo.
channelOpcional, solo Hilti PS 1000: canal que se analiza, de 1 a 5 (3 por defecto).
traces_per_mFacultatif, de 10 à 2000 : nombre de traces par mètre, pour un fichier qui ne donne pas l'espacement des traces (SEG-Y Proceq / Screening Eagle, par exemple) ou pour le corriger. À défaut, celui du fichier, sinon 200 (2 traces/cm) ; la réponse l'indique alors par traces_per_m_source.
waitFacultatif, de 0 à 50 s (30 par défaut). Durée pendant laquelle la requête attend le résultat. Si le calcul n'est pas terminé à temps, la réponse est un 202 avec l'identifiant de la tâche.
curl -X POST "https://gprviewer.com/api/v1/rebars?filename=SCAN_001.DZT&wait=30" \
  -H "Authorization: Bearer $GPV_API_KEY" \
  -H "Content-Type: application/octet-stream" \
  --data-binary @SCAN_001.DZT

Variante multipart:

curl -X POST "https://gprviewer.com/api/v1/rebars?filename=SCAN_001.DZT" \
  -H "Authorization: Bearer $GPV_API_KEY" \
  -F "file=@SCAN_001.DZT"

Respuesta 200 — cálculo terminado

{
  "id": "0c180c12-864e-471b-9312-76ac22fa72fb",
  "status": "done",
  "created_at": "2026-11-06T10:51:36.31Z",
  "finished_at": "2026-11-06T10:51:37.38Z",
  "result": {
    "engine": "2026.11.06",
    "file": { "device": "DF", "antenna": "D50800", "channels": 2, "traces": 397, "samples": 512,
              "traces_per_m": 100, "range_ns": 33.333, "length_m": 3.97, "epsr": 9.042 },
    "channel": 1,
    "surface_sample": 51,
    "polarity": "normal",
    "rebars": [
      { "distance_m": 1.63, "depth_cm": 19.8, "time_ns": 3.971, "confidence": 0.965, "trace": 163, "sample": 61 },
      { "distance_m": 1.9,  "depth_cm": 18.8, "time_ns": 3.776, "confidence": 0.945, "trace": 190, "sample": 58 }
    ],
    "count": 2
  },
  "usage": { "length_m": 3.97, "charged_m": 4 },
  "balance_m": 192
}

Significado de los campos

CampoSignificado
distance_mDistancia desde el inicio del perfil, en metros.
depth_cmProfondeur depuis la surface, en centimètres, calculée avec l'εr du fichier ou celui passé dans epsr.
time_nsTiempo de ida y vuelta desde la superficie, en nanosegundos.
confidenceÍndice de confianza del modelo, de 0 a 1.
traceÍndice de la traza en el archivo.
sampleÍndice de la muestra, contado desde la superficie detectada.
result.fileCaracterísticas del archivo leído: equipo, antena, número de canales, trazas, muestras, trazas por metro, ventana temporal (ns), longitud (m), εr utilizada.
result.channelCanal analizado.
result.surface_sampleMuestra de la superficie detectada en el archivo.
result.polarity« normal » o « inverted »: sentido de la señal utilizado. En un SEG-Y, la polaridad se detecta automáticamente (algunos equipos registran con polaridad inversa).
usageLongitud del perfil y metros facturados (redondeados al metro superior).
balance_mSaldo restante después de este archivo, en metros.

Respuesta 202 — cálculo en curso

{ "id": "0c180c12-864e-471b-9312-76ac22fa72fb", "status": "queued", "poll": "/v1/jobs/0c180c12-864e-471b-9312-76ac22fa72fb" }

Si le résultat n'est pas prêt dans le délai wait, la réponse donne l'identifiant de la tâche. Interrogez alors GET /v1/jobs/{id} (avec ?wait=20 pour attendre jusqu'à 20 s par appel) jusqu'à obtenir le statut done ou failed. Une tâche terminée porte l'objet result décrit plus haut.

GET/v1/jobs/{id}[?wait=20]

Consultar el saldo

GET/v1/balance
{ "balance_m": 192, "unit": "m" }

Consultar el consumo

GET/v1/usage

Saldo, consumo de los últimos 30 días (por día) y los 50 últimos procesamientos de la cuenta. El detalle completo, las claves y las facturas también están en su espacio API en gprviewer.com.

{
  "balance_m": 133, "unit": "m",
  "last_30_days": {
    "jobs": 6, "charged_m": 67,
    "by_day": [ { "day": "2026-11-06", "jobs": 6, "charged_m": 67 } ]
  },
  "recent": [
    { "id": "f44ada08-…", "created_at": "2026-11-06T13:37:30Z", "status": "done",
      "format": "dzt", "length_m": 0.75, "charged_m": 1, "count": 5 }
  ]
}

Errores

En caso de error, la respuesta lleva un código HTTP explícito y un cuerpo con esta forma:

{ "error": { "code": "insufficient_credits", "message": "…" } }
HTTPCódigoSignificado
400bad_epsrepsr hors de l'intervalle 1–81.
400bad_channelchannel doit être un entier de 1 à 5.
400bad_traces_per_mtraces_per_m doit être compris entre 10 et 2000.
400empty_fileArchivo vacío.
400missing_fileNingún archivo en la solicitud.
401invalid_api_keyClave ausente, no válida o revocada.
401expired_api_keyLa clave ha llegado al final del periodo de validez elegido al crearla: cree una nueva en su espacio.
402insufficient_creditsSaldo insuficiente para procesar este archivo.
413file_too_largeArchivo de más de 600 MB.
415unsupported_formatExtensión ausente o formato no admitido.
429too_many_jobsYa hay 5 archivos en curso de cálculo en esta cuenta: espere a que termine uno de ellos.
500internal_errorError interno: vuelva a intentarlo más tarde. El archivo no se factura.

Ejemplos completos

Chaque exemple envoie un fichier, interroge /v1/jobs/{id} si nécessaire jusqu'à la fin du calcul, puis affiche les armatures. La clé est lue dans la variable d'environnement GPV_API_KEY.

#!/bin/sh
# Usage: GPV_API_KEY=gpv_live_... ./pick-rebars.sh SCAN_001.DZT
API="https://gprviewer.com/api"
FILE="$1"
NAME=$(basename "$FILE")

# 1. Upload the file (waits up to 30 s for the result).
#    X-File-Name instead of ?filename= : no URL-encoding needed for spaces.
curl -s -X POST "$API/v1/rebars?wait=30" \
  -H "Authorization: Bearer $GPV_API_KEY" \
  -H "Content-Type: application/octet-stream" \
  -H "X-File-Name: $NAME" \
  --data-binary "@$FILE" > result.json

# 2. Still processing (202)? Poll the job until it is done or failed
while :; do
  STATUS=$(jq -r '.status // "error"' result.json 2>/dev/null || echo error)
  case "$STATUS" in done|failed|error) break ;; esac
  JOB=$(jq -r '.id' result.json)
  sleep 1
  curl -s "$API/v1/jobs/$JOB?wait=20" \
    -H "Authorization: Bearer $GPV_API_KEY" > result.json
done

# 3. Print the rebars, or the error
if [ "$STATUS" = "done" ]; then
  jq -r '.result.rebars[] | "\(.distance_m) m\t\(.depth_cm) cm\tconfidence \(.confidence)"' result.json
  jq -r '"\(.result.count) rebar(s)"' result.json
else
  cat result.json; exit 1
fi

Nécessite curl et jq.

import os
import requests

API = "https://gprviewer.com/api"
HEADERS = {"Authorization": f"Bearer {os.environ['GPV_API_KEY']}"}


def check(r):
    """Return the JSON body, or raise with the API error code."""
    body = r.json()
    if r.status_code not in (200, 202):
        err = body.get("error", {})
        raise RuntimeError(f"HTTP {r.status_code} {err.get('code')}: {err.get('message')}")
    return body


def pick_rebars(path, epsr=None):
    params = {"filename": os.path.basename(path), "wait": 30}
    if epsr is not None:
        params["epsr"] = epsr

    # 1. Upload the raw file
    with open(path, "rb") as f:
        job = check(requests.post(
            f"{API}/v1/rebars", params=params, data=f,
            headers={**HEADERS, "Content-Type": "application/octet-stream"},
            timeout=120,
        ))

    # 2. 202 = still processing: poll the job
    while job["status"] not in ("done", "failed"):
        job = check(requests.get(
            f"{API}/v1/jobs/{job['id']}", params={"wait": 20},
            headers=HEADERS, timeout=60,
        ))

    if job["status"] == "failed":
        raise RuntimeError(f"Job {job['id']} failed: {job.get('error')}")
    return job["result"]


if __name__ == "__main__":
    result = pick_rebars("SCAN_001.DZT")
    for b in result["rebars"]:
        print(f"{b['distance_m']:7.2f} m  {b['depth_cm']:6.1f} cm  confidence {b['confidence']:.2f}")
    print(f"{result['count']} rebar(s) on {result['file']['length_m']} m")

Python 3.8+ et requests (pip install requests).

// pick-rebars.mjs — Node.js 18+
import { readFile } from "node:fs/promises";
import { basename } from "node:path";

const API = "https://gprviewer.com/api";
const AUTH = { Authorization: `Bearer ${process.env.GPV_API_KEY}` };

// Return the JSON body, or throw with the API error code
async function call(url, init = {}) {
  const res = await fetch(url, { ...init, headers: { ...AUTH, ...init.headers } });
  const body = await res.json();
  if (!res.ok) {
    const e = body.error ?? {};
    throw new Error(`HTTP ${res.status} ${e.code}: ${e.message}`);
  }
  return body;
}

async function pickRebars(path, { epsr } = {}) {
  const params = new URLSearchParams({ filename: basename(path), wait: "30" });
  if (epsr !== undefined) params.set("epsr", String(epsr));

  // 1. Upload the raw file
  let job = await call(`${API}/v1/rebars?${params}`, {
    method: "POST",
    headers: { "Content-Type": "application/octet-stream" },
    body: await readFile(path),
  });

  // 2. 202 = still processing: poll the job
  while (job.status !== "done" && job.status !== "failed") {
    job = await call(`${API}/v1/jobs/${job.id}?wait=20`);
  }
  if (job.status === "failed") throw new Error(`Job ${job.id} failed`);
  return job.result;
}

const result = await pickRebars(process.argv[2] ?? "SCAN_001.DZT");
for (const b of result.rebars) {
  console.log(`${b.distance_m.toFixed(2)} m  ${b.depth_cm.toFixed(1)} cm  confidence ${b.confidence.toFixed(2)}`);
}
console.log(`${result.count} rebar(s) on ${result.file.length_m} m`);

Node.js 18+ (fetch natif). Enregistrez le script sous pick-rebars.mjs.

¿Listo para integrar el Punteo IA?

Cree su cuenta, genere su clave y procese sus primeros 200 metros gratis.

Probar gratis — 200 m de regalo

Pas développeur ? Le Pointé IA est inclus dans GPRviewer Pro : ouvrez vos fichiers, un clic, c'est pointé.