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é.
🔒 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.
Cada punto es una armadura: su posición a lo largo del perfil y su profundidad. Cuanto más grande es el punto, más seguro está el modelo.
Ver la respuesta de la API (JSON)
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.
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.
Envíe el archivo
Un simple POST avec le fichier radar brut, depuis votre logiciel, un script ou la ligne de commande.
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
{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.
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
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
channelpour 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.
- Ordre de grandeur : un profil de 10 m coûte environ 0,50 €.
- Pago con tarjeta (Stripe), factura emitida automáticamente.
- Un archivo fallido no se factura.
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.
URL base
https://gprviewer.com/apiLes 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_xxxxxxxxxxxxxxxxxxxxxxxxAnalizar un archivo
Corps de la requête : le fichier brut (Content-Type: application/octet-stream), ou un envoi multipart/form-data avec un champ file.
| Parámetro | Descripción |
|---|---|
filename | Obligatoire. Nom du fichier, extension comprise (ou en-tête X-File-Name) : l'extension détermine le format. |
epsr | Opcional, de 1 a 81. Permitividad relativa utilizada para la conversión tiempo → profundidad. Si se omite, la registrada en el archivo. |
channel | Opcional, solo Hilti PS 1000: canal que se analiza, de 1 a 5 (3 por defecto). |
traces_per_m | Facultatif, 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. |
wait | Facultatif, 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.DZTVariante 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
| Campo | Significado |
|---|---|
distance_m | Distancia desde el inicio del perfil, en metros. |
depth_cm | Profondeur depuis la surface, en centimètres, calculée avec l'εr du fichier ou celui passé dans epsr. |
time_ns | Tiempo 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.file | Características del archivo leído: equipo, antena, número de canales, trazas, muestras, trazas por metro, ventana temporal (ns), longitud (m), εr utilizada. |
result.channel | Canal analizado. |
result.surface_sample | Muestra 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). |
usage | Longitud del perfil y metros facturados (redondeados al metro superior). |
balance_m | Saldo 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.
Consultar el saldo
{ "balance_m": 192, "unit": "m" }Consultar el consumo
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": "…" } }| HTTP | Código | Significado |
|---|---|---|
| 400 | bad_epsr | epsr hors de l'intervalle 1–81. |
| 400 | bad_channel | channel doit être un entier de 1 à 5. |
| 400 | bad_traces_per_m | traces_per_m doit être compris entre 10 et 2000. |
| 400 | empty_file | Archivo vacío. |
| 400 | missing_file | Ningún archivo en la solicitud. |
| 401 | invalid_api_key | Clave ausente, no válida o revocada. |
| 401 | expired_api_key | La clave ha llegado al final del periodo de validez elegido al crearla: cree una nueva en su espacio. |
| 402 | insufficient_credits | Saldo insuficiente para procesar este archivo. |
| 413 | file_too_large | Archivo de más de 600 MB. |
| 415 | unsupported_format | Extensión ausente o formato no admitido. |
| 429 | too_many_jobs | Ya hay 5 archivos en curso de cálculo en esta cuenta: espere a que termine uno de ellos. |
| 500 | internal_error | Error 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
fiNé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 regaloPas développeur ? Le Pointé IA est inclus dans GPRviewer Pro : ouvrez vos fichiers, un clic, c'est pointé.