Chuẩn hoá địa chỉ API

Tách địa chỉ tự do thành số nhà, đường, phường xã, tỉnh và tự đổi địa chỉ cũ 3 cấp (có quận/huyện) sang đơn vị 2 cấp mới từ 2025.

Tham số

Ví dụ

curl "https://apibox.io.vn/v1/address-parse?address=123 Lê Lợi, P. Bến Thành, Q.1, TP.HCM" \
  -H "Authorization: Bearer YOUR_API_KEY"

const res = await fetch('https://apibox.io.vn/v1/address-parse?address=123 Lê Lợi, P. Bến Thành, Q.1, TP.HCM', {
  method: 'GET',
  headers: {
    Authorization: 'Bearer YOUR_API_KEY',
  },
});
const data = await res.json();
console.log(data);

import requests

res = requests.get(
    "https://apibox.io.vn/v1/address-parse?address=123 Lê Lợi, P. Bến Thành, Q.1, TP.HCM",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    timeout=30,
)
print(res.json())

<?php
$ch = curl_init('https://apibox.io.vn/v1/address-parse?address=123 Lê Lợi, P. Bến Thành, Q.1, TP.HCM');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
]);
$response = curl_exec($ch);
print_r(json_decode($response, true));

Kết quả trả về

{
  "version": "v5.2.0",
  "decree": "388/NQ-UBTVQH16",
  "updated": "2026-09-20",
  "input": "123 Lê Lợi, P. Bến Thành, Q.1, TP.HCM",
  "parsed": {
    "house_number": "123",
    "street": "Lê Lợi",
    "ward": "P. Bến Thành",
    "district": "Q.1",
    "province": "TP.HCM"
  },
  "format": "old (before 07/2025)",
  "matched": true,
  "ambiguous": false,
  "result": {
    "ward": "Phường Bến Thành",
    "ward_code": "26743",
    "province": "Thành phố Hồ Chí Minh",
    "province_code": "79",
    "postal_code": "71009",
    "full_address": "123 Lê Lợi, Phường Bến Thành, Thành phố Hồ Chí Minh",
    "converted_from": {
      "code": "26743",
      "name": "Phường Bến Thành",
      "change": "Nhập toàn bộ",
      "district": "Quận 1",
      "district_code": "760",
      "province": "Thành phố Hồ Chí Minh",
      "province_code": "79"
    }
  }
}

Ứng dụng

• Làm sạch địa chỉ khách hàng trong CRM, cơ sở dữ liệu bán hàng
• Đổi địa chỉ cũ trên nhãn vận chuyển, hoá đơn sau sáp nhập 2025
• Tự điền dropdown tỉnh / phường từ địa chỉ dán vào
• Thống kê đơn hàng theo tỉnh mới

Hỏi đáp

API liên quan