分解
分解
都道府県から号・建物名・階まで、27のラベルで構造化します。全角・旧字体・漢数字・ハイフンの揺れも、同じ応答で揃えます。
27 LABELS[ZORYNTO] ※ 日本の住所を、点にする
住所は、
点である。
Zorynto は、日本語の住所を27のラベルに分解し、公式データで検証して、地図上の一点へ着地させるモデル「Kiten」を作っています。表記ゆれ、階の欠落、旧市町村名まで、直した箇所をすべて開示します。
住所のテキストは保存しません訂正はすべて開示1,000件まで無料
$ curl https://api.zorynto.com/v1/parse \ -H "Authorization: Bearer $KITEN_API_KEY" \ -d '{"text":"東京都品川区東品川2-2-20"}'
27種
ラベル
1,741
市区町村
47
都道府県
35.6213 N · 139.7460 E
東京都品川区東品川２丁目２−２０ 天王洲オーシャンスクエア6F
都都道府県東京都
市市区町村品川区
町町名東品川
丁丁目2丁目
番番地・号2-20
建建物名天王洲オーシャンスクエア
階階6F
L1
L2
L3
L4
L5
訂正 2件 全角→半角（２丁目２…）· ハイフンの統一（−→-）
PRECISION LADDER
7住居rsdt
6街区block
5地番parcel
4ISJisj
3GSIgsi
2重心centroid
0なしnone
Capabilities
住所について、Kiten が扱うこと
どれも「いまの Kiten が返すもの」です。まだ無いものは、料金ページのロードマップに分けています。
照合
照合
公的データ（ABR）で照合し、検証レベル L1〜L5 を付けます。「合っている」を二値ではなく段階で返します。
ABR · L1–L5完全性
完全性
複数の入居者がいる建物で階が空なら警告します。単独利用の建物には警告を出しません。
SINGLE_TENANT · U7精度
精度
座標を、住居・街区・地番・重心のどの層で決めたかを明示します。精度は7段階の階段で見ます。
PRECISION 7→0時点
時点
合併前の市区町村名を現行へ。何から何へ直したかを resolved_from に残します。
RESOLVED_FROM · U17住所体系
住所体系
京都の通り名、札幌の条丁目、街区方式、農村の大字・字。住所体系ごとの読み方を扱います。
PARADIGM How it works
分解 → 照合 → 着地
1回の呼び出しで、この三つがすべて走ります。
01 · PARSE
分解
文字列を正規化し、ラベルごとに切り分けます。直した箇所は corrections に残します。
東京都｜品川区｜東品川｜2丁目｜2-20 └ 都 · 市 · 町 · 丁 · 番 · 建 · 階
02 · VALIDATE
照合
ABR・郵便番号・ISJ・GSI と突き合わせ、どの層まで一致したかを検証レベルで返します。
L1L2L3L4L5
例: 住居レベルまで一致 → L5 03 · LOCATE
着地
座標を決めた層を明示します。住居レベルが無ければ、街区・地番・重心へ段階的に下がります。
7住居rsdt
6街区block
5地番parcel
2重心centroid
Try it
Playgroundで1件、点を打つ
登録は要りません。入力した住所は、ブラウザの外には送りません（デモの解析はブラウザ内で動きます）。
01 · U1 02 · U7 03 · U6 04 · U23
CRM・配送データの清掃
全角・旧字体・ハイフンの表記ゆれを揃え、何を直したかをすべて記録します。
入力東京都港区六本木６丁目１０−１
出力港区六本木6-10-1（corrections 2件）
ECの住所チェック・階の欠落
複数の入居者がいる建物で、階・部屋番号が空のまま注文が通るのを防ぎます。
入力大阪市北区梅田2-5-25 ハービスOSAKA
出力⚠ 多床ビル — 階がありません
KYC・実在性の確認
その住所が公式データに存在するか、どの層まで一致したかを確かめます。
入力〒150-0002 渋谷1-2-3
出力東京都渋谷区 — L2 · 町名欠落
古い名簿の現代化
合併前の市町村名や旧字体の混じった住所を、現在の住所に直します。
入力浦和市常盤９−２５（旧字体混在）
出力さいたま市浦和区常盤9-25
Principles
約束できることだけを書きます
住所を保存しない
住所のテキストは、どのプランでも保存しません。記録するのは時刻・種別・検証レベル・応答時間・request_id だけです。
訂正をすべて開示
直した箇所は corrections に、補った箇所は annotations に。黙って書き換えることはしません。
過負荷は 429 で返す
処理が追いつかないときは、待たせ続けず 429 を返します。再試行の目安は Retry-After で伝えます。
日本語のドキュメント
概念・API・ガイドを日本語で書いています。更新履歴では、破壊的変更を明記します。
Notes
ブログへ 住所データと日本語処理の技術メモ
まず、1,000件。
登録して、APIキーを作って、最初の住所を点にするまで。