MDS
GPRviewer API

API Pointé IA

AIピッキングAPIは、地中レーダ(GPR)ファイルから鉄筋を自動で検出します。ファイルを送信するだけで、各鉄筋の位置(m)と深さ(cm)が数秒で返されます。

GPRviewerのAIピッキングと同じ自社開発モデルです。MDSの専門家が検証した測定データをもとに、フランス国内の自社サーバで学習しています。

サブスクリプション不要 · 測線1メートル単位の課金 · 数行のコードで組み込み可能

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

🔒 ファイルは当社サーバで解析した後、削除されます。人が閲覧することはありません。

ご自身のファイルでお試しください

アカウントもキーも不要:レーダーグラムをドロップするだけで、API が数秒で鉄筋を返します。

ここにファイルをドロップ またはクリックして選択 .dzt、.nx、.sgy、.hf、.out / .h5 · 最大 25 MB · 1日3回まで

仕組み

多数のファイルを処理するソフトウェアメーカーや建設コンサルタント向け:鉄筋のピッキングを、自社の処理・作図・報告書作成のワークフローに組み込めます。

1

APIキーを作成

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

ファイルを送信

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

3

JSONを受信

検出された鉄筋の一覧です。各鉄筋の距離、深さ、往復走時、信頼度スコアが含まれます。

性能

852
本鉄筋を検証に使用(モデルが学習していない実際の現場の測定データ)
88 %
鉄筋の検出率
1,3 mm
専門家のピッキングとの深さの平均誤差

比誘電率を同じにした場合、深さの {p5}% が専門家のピッキングとの差 5 mm 以内です。

各測線は数秒で処理されます。

モデルは定期的に再学習しており、新しいバージョンは、同じ検証用データで前バージョンを上回った場合にのみ運用を開始します。

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.

結果は解釈を支援するためのものであり、有資格のオペレーターによる確認が必要です。

ディープラーニングによるAI

AIピッキングは、実際の現場で取得したレーダ画像で学習した、ディープラーニングモデルである畳み込みニューラルネットワーク(CNN)を基盤としています。

AIあり・なしの比較

AIピッキング
手動ピッキング
時間
1測線あたり数秒。数十ファイルを無人で連続処理できます。
双曲線を1つずつ手作業でピッキングし、レーダ画像を1枚ずつ処理します。
オペレーターの役割
結果を確認・修正するだけです。誤検出を削除し、見落としを追加します。
ピッキングをすべて自分で行います。
一貫性
オペレーターに関係なく、すべてのファイルに同じ基準を適用します。
結果はオペレーターによって、また疲労によってばらつきます。

対応フォーマット

  • 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、その他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)gprMax 3(.out)および 4(.h5)のシミュレーション:結合済みBスキャン(outputfiles_merge)。

ファイルサイズは最大 600 MB です。

2チャンネルのファイルでは、チャンネル1を解析します。

近日対応

  • 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.

料金

プリペイド式のクレジットで、サブスクリプションは不要です。処理した測線長に応じてメートル単位で課金されます(1メートル未満は切り上げ、1ファイルあたり最低 1 m)。価格はすべて税抜です。

無料トライアル 200 m 最初のAPIキー作成時に付与
ディスカバリー 1,000 m €50(税抜) €0.050 / m 相当
ボリューム 25,000 m €750(税抜) €0.030 / m 相当
大容量 25,000 m 以上 お問い合わせ ご利用量に応じた料金

プライバシー

  • ファイルは欧州(スイス)のホスティングで受信し、MDS社内に設置した自社サーバで解析します。
  • 処理は完全に自動です。ファイルを人が閲覧することはありません。
  • ファイルは結果を返した時点で削除され、ファイル名が保存されることもありません。
  • お客様のファイルを当社モデルの学習に使用したり、第三者に提供したりすることは一切ありません。

利用規約(概要)

  • APIのご利用には、GPRviewerの利用規約が適用されます。
  • 結果を競合モデルの学習や複製に使用することは禁止されています。
  • 処理数の上限:1アカウントあたり同時に5ファイルまで処理できます。
  • 結果は解釈の支援として提供されるものであり、すべての鉄筋の検出を保証するものではありません。

ドキュメント

JSONでレスポンスを返すREST APIです。HTTPSのみ対応しています。

表示中の測線での実例

            

ベースURL

https://gprviewer.com/api

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

認証

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
APIキーは作成時に一度だけ表示されます。安全な場所に保管してください。アカウント画面からいつでも無効化できます。ユーザー側で実行されるコード(ブラウザ、配布するアプリケーション)には絶対に含めないでください。

ファイルを解析する

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.

パラメータ説明
filenameObligatoire. Nom du fichier, extension comprise (ou en-tête X-File-Name) : l'extension détermine le format.
epsr任意、1〜81。時間を深さに換算するための比誘電率。指定がない場合はファイルに記録された値を使用します。
channel任意。Hilti PS 1000 のみ:解析するチャンネル(1〜5、既定値 3)。
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

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"

レスポンス 200 — 処理完了

{
  "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
}

フィールドの説明

フィールド意味
distance_m測線の始点からの距離(メートル)。
depth_cmProfondeur depuis la surface, en centimètres, calculée avec l'εr du fichier ou celui passé dans epsr.
time_ns表面からの往復走時(ナノ秒)。
confidenceモデルの信頼度スコア(0〜1)。
traceファイル内のトレース番号。
sample検出した表面から数えたサンプル番号。
result.file読み込んだファイルの情報:機器、アンテナ、チャンネル数、トレース数、サンプル数、1メートルあたりのトレース数、時間レンジ(ns)、長さ(m)、使用した εr。
result.channel解析したチャンネル。
result.surface_sampleファイル内で検出した表面のサンプル位置。
result.polarity"normal" または "inverted":使用した信号の極性。SEG-Yファイルでは極性を自動で判定します(極性を反転して記録する機器があるため)。
usage測線長と課金メートル数(1メートル未満は切り上げ)。
balance_mこのファイル処理後の残高(メートル)。

レスポンス 202 — 処理中

{ "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]

残高の確認

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

使用量の確認

GET/v1/usage

残高、過去30日間の使用量(日別)、アカウントの直近50件の処理を返します。詳細な内訳、APIキー、請求書は gprviewer.com のAPIアカウントでも確認できます。

{
  "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 }
  ]
}

エラー

エラー時は、明示的なHTTPステータスと次の形式のボディが返されます:

{ "error": { "code": "insufficient_credits", "message": "…" } }
HTTPコード意味
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_fileファイルが空です。
400missing_fileリクエストにファイルが含まれていません。
401invalid_api_keyAPIキーがない、無効、または無効化されています。
401expired_api_key作成時に設定した有効期限を過ぎたAPIキーです。アカウント画面で新しいキーを作成してください。
402insufficient_creditsこのファイルを処理するための残高が不足しています。
413file_too_largeファイルサイズが 600 MB を超えています。
415unsupported_format拡張子がないか、対応していないフォーマットです。
429too_many_jobsこのアカウントではすでに5件のファイルを処理中です。いずれかが終わるまでお待ちください。
500internal_error内部エラーです。しばらくしてから再試行してください。このファイルは課金されません。

完全なサンプルコード

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.

AIピッキングを組み込む準備はできましたか?

アカウントを作成し、APIキーを発行すれば、最初の 200 メートルを無料で処理できます。

無料で試す — 200 m 付き

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