CONCEPTS

検証レベル（L1〜L5）

Kiten が住所に付ける5段階の検証レベルの意味と、受け入れる・確認する・却下するの使い分けを説明します。

更新: 2026年10月12日

すべての応答には、住所がどこまで確かめられたかを示す 検証レベル（level）が付きます。「住所らしく見える」ことと「その住所が実在する」ことは別なので、段階で示します。

要確認 以前の設計資料では、レベルの名称が異なる箇所があります。このページは、監査で確認した動作に合わせています。名称は公開前に再確認します。

5つのレベル

レベル名称意味
L5全階層都道府県から住居までの全階層が、公開データと照合できた
L4記号的に検証住所の階層が規則に沿って整合し、記号的に検証できた
L3妥当・未検証形として妥当だが、公開データでは確かめられていない（信頼度の上限 0.70）
L2劣化一部の要素が欠けている、または食い違っている
L1却下住所として扱えない

使い分けの目安

用途受け入れる確認を促す却下・再入力
EC のチェックアウトL5 L4L3 L2L1
名寄せ・クレンジングL5 L4L3（目視の対象）L1 L2
配送ラベルの作成L5L4 L3L2 L1

これは出発点です。しきい値は、誤りが出たときの損失に合わせて決めてください。

読み方の注意

  • L3 の信頼度は 0.70 を超えません。 形が整っているだけの住所を、実在すると誤って確信しないための上限です。
  • レベルは、座標の精度とは別です。 精度は精度の段で示します。
  • warnings と合わせて読みます。 例えば、多床ビルで階が未入力のとき、レベルが高くても配送では注意が必要です。

関連：訂正と補足・欠けている要素

この内容に誤りや不足があれば、お知らせください。