Dorabot – Vietnam address after 2025 merger

@dorabot-io/dia-chi

JavaScript / TypeScript 向けの2025年の合併後のベトナム行政住所データです。新設された34省、3,321の社／坊／特区、国会常務委員会の決議に基づく旧社11,559件から新社への対応表（条項番号付き）、React 向け2階層住所選択フォームを提供します。

2025年7月1日から、ベトナムの住所は2階層のみになります：社／坊／特区 → 省／市。**郡／県はなくなります。**3階層フォーム（省 → 郡 → 社）は旧形式です。

npm i @dorabot-io/dia-chi

オフラインで動作し、キーは不要で、ネットワークへの接続もありません（doiDiaChiを除く）。Node ≥ 18、ブラウザー、Vite、Next.js、Bun、Deno、Cloudflare Workers に対応しています。

すぐに使う

import { tinh, xa, timXaCu, kiemDiaChi, doiDiaChi } from '@dorabot-io/dia-chi';

tinh();                 // 34 tỉnh/thành: { slug, tenDayDu, gomTinhCu, nghiQuyet, soXa }
xa('ha-noi');           // xã/phường mới của Hà Nội (nhận cả "Hà Nội", "Thái Bình" → Hưng Yên)

await timXaCu('Bách Khoa', { huyen: 'Hai Bà Trưng', tinh: 'Hà Nội' });
// [{ xaCu: 'Phường Bách Khoa', huyenCu: 'Quận Hai Bà Trưng', den: [{ tenDayDu: 'Phường Bạch Mai', phan: 'toan_bo', khoan: 8 }],
//    nghiQuyet: { so: '1656/NQ-UBTVQH15', hieu_luc: '2025-07-01', url: '…' } }]

await kiemDiaChi('12 Tạ Quang Bửu, phường Bách Khoa, quận Hai Bà Trưng, Hà Nội');
// { trangThai: 'dia_chi_cu', lyDo: 'Còn cấp quận/huyện …' }   ← dùng ở bước kiểm form / nhập dữ liệu
await kiemDiaChi('12 Tạ Quang Bửu, Phường Bạch Mai, Thành phố Hà Nội');
// { trangThai: 'hop_le', diaChiChuan: '12 Tạ Quang Bửu, Phường Bạch Mai, Thành phố Hà Nội' }

// Đổi địa chỉ đầy đủ, chuỗi lộn xộn/viết tắt (gọi API dorabot.io):
await doiDiaChi('12 Tạ Quang Bửu, P. Bách Khoa, Q. Hai Bà Trưng, HN');
// { thanh_cong: true, dia_chi_moi: '12 Tạ Quang Bửu, Phường Bạch Mai, Thành phố Hà Nội', tin_cay: { muc: 'cao' } }
await doiDiaChi([...5000DiaChiKhachHang], { apiKey: process.env.DORABOT_API_KEY }); // tối đa 200/lần

doiDiaChiはキー不要で、IPごとに1日20住所まで利用できます。無料キーdk_…（Google ログインで1日100件）：https://dorabot.io/dia-chi/nha-phat-trien/ — 一括変換の法人向けプラン：https://dorabot.io/dia-chi/doanh-nghiep/

2階層住所選択フォーム（React）

import { ChonDiaChi } from '@dorabot-io/dia-chi/react';

<ChonDiaChi
  choDoiDiaChiCu            // thêm ô "dán địa chỉ cũ để đổi"
  onChange={(v) => setForm({ ...form, tinh: v.tinh, xa: v.xa, diaChi: v.diaChi })}
  selectClassName="border rounded px-2 py-1"
/>

UI ライブラリへの依存はありません（<select>タグ2つ）。省のslugと社のslugをDBに保存し、tenDayDuを表示します。

データベースへの保存

-- địa chỉ mới: 2 cấp
dia_chi_chi_tiet text,      -- số nhà, đường, thôn/xóm
xa_slug   text,             -- 'phuong-bach-mai'
tinh_slug text              -- 'ha-noi'
-- giữ cột địa chỉ cũ (nếu có) để đối chiếu, đừng xoá ngay

その他

• Claude / ChatGPT / Cursor 向けMCP：https://dorabot.io/dia-chi/mcp（ツール：tra_cuu_xa_cu、doi_dia_chi、kiem_dia_chi、danh_sach_xa_moi、danh_sach_tinh）。
• REST：POST https://dorabot.io/dia-chi/api/v1/doi.php {"addresses": [...]} — OpenAPI は開発者向けページにあります。
• Python：pip install dorabot-dia-chi。
• オープンデータ CSV/JSON：https://github.com/Dorabot-io/sap-nhap-2025
• 手動検索、Excel ファイル変換：https://dorabot.io/dia-chi/

ライセンス

コードは MIT。データは CC BY 4.0 — アプリまたはドキュメント内のどこかに「Dorabot (dorabot.io)」とクレジットを記載してください（React コンポーネントには小さなクレジット表記が含まれています。他の場所に記載する場合はghiNguon={false}で無効にできます）。

データは、各省の2025年社級行政単位再編に関するUBTVQH決議および決議202/2025/QH15から転記しています。誤りを見つけた場合は、[email protected] までご連絡いただくか、issueを作成してください。

Dorabot (dorabot.io) はベトナムのツールであり、深圳のロボット企業 Dorabot (dorabot.com) とは関係ありません。

---

英語。 2025年7月1日の合併後のベトナム行政区画（34省、2階層：社／坊 → 省、郡なし）。省の一覧と新設された3,321の社を含むオフラインデータ、旧社11,559件から新社への対応表（公式決議の条項付き）、新形式住所のバリデーター、React 向け2階層住所選択フォーム、および自由入力された旧形式の住所全体を変換するために dorabot.io API を呼び出すdoiDiaChi()を提供します。コードは MIT、データは CC BY 4.0 です。

このリポジトリの内容

• js/ — npm パッケージ@dorabot-io/dia-chi（および/react）
• python/ — PyPI パッケージdorabot-dia-chi
• vi-du/ — React/Vite の例、CSV ファイルを変換する Node の例、Python Excel、PHP/Laravel、Flutter
• 完全な CSV/JSON データ：https://github.com/Dorabot-io/sap-nhap-2025