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é.
🔒 ファイルは当社サーバで解析した後、削除されます。人が閲覧することはありません。
ご自身のファイルでお試しください
アカウントもキーも不要:レーダーグラムをドロップするだけで、API が数秒で鉄筋を返します。
仕組み
多数のファイルを処理するソフトウェアメーカーや建設コンサルタント向け:鉄筋のピッキングを、自社の処理・作図・報告書作成のワークフローに組み込めます。
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.
ファイルを送信
Un simple POST avec le fichier radar brut, depuis votre logiciel, un script ou la ligne de commande.
JSONを受信
検出された鉄筋の一覧です。各鉄筋の距離、深さ、往復走時、信頼度スコアが含まれます。
性能
比誘電率を同じにした場合、深さの {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あり・なしの比較
対応フォーマット
- 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
channelpour 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)。価格はすべて税抜です。
- Ordre de grandeur : un profil de 10 m coûte environ 0,50 €.
- お支払いはクレジットカード(Stripe)で、請求書は自動で発行されます。
- 処理に失敗したファイルは課金されません。
プライバシー
- ファイルは欧州(スイス)のホスティングで受信し、MDS社内に設置した自社サーバで解析します。
- 処理は完全に自動です。ファイルを人が閲覧することはありません。
- ファイルは結果を返した時点で削除され、ファイル名が保存されることもありません。
- お客様のファイルを当社モデルの学習に使用したり、第三者に提供したりすることは一切ありません。
利用規約(概要)
- APIのご利用には、GPRviewerの利用規約が適用されます。
- 結果を競合モデルの学習や複製に使用することは禁止されています。
- 処理数の上限:1アカウントあたり同時に5ファイルまで処理できます。
- 結果は解釈の支援として提供されるものであり、すべての鉄筋の検出を保証するものではありません。
ドキュメント
JSONでレスポンスを返すREST APIです。HTTPSのみ対応しています。
ベースURL
https://gprviewer.com/apiLes 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ファイルを解析する
Corps de la requête : le fichier brut (Content-Type: application/octet-stream), ou un envoi multipart/form-data avec un champ file.
| パラメータ | 説明 |
|---|---|
filename | Obligatoire. 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_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.DZTmultipart の場合:
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_cm | Profondeur 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.
残高の確認
{ "balance_m": 192, "unit": "m" }使用量の確認
残高、過去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 | コード | 意味 |
|---|---|---|
| 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 | ファイルが空です。 |
| 400 | missing_file | リクエストにファイルが含まれていません。 |
| 401 | invalid_api_key | APIキーがない、無効、または無効化されています。 |
| 401 | expired_api_key | 作成時に設定した有効期限を過ぎたAPIキーです。アカウント画面で新しいキーを作成してください。 |
| 402 | insufficient_credits | このファイルを処理するための残高が不足しています。 |
| 413 | file_too_large | ファイルサイズが 600 MB を超えています。 |
| 415 | unsupported_format | 拡張子がないか、対応していないフォーマットです。 |
| 429 | too_many_jobs | このアカウントではすでに5件のファイルを処理中です。いずれかが終わるまでお待ちください。 |
| 500 | internal_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
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.
AIピッキングを組み込む準備はできましたか?
アカウントを作成し、APIキーを発行すれば、最初の 200 メートルを無料で処理できます。
無料で試す — 200 m 付きPas développeur ? Le Pointé IA est inclus dans GPRviewer Pro : ouvrez vos fichiers, un clic, c'est pointé.