Tra mã bưu chính online

Tra mã bưu chính của 124 nước (địa danh, bang, hạt, toạ độ), tìm mã theo tên địa danh hoặc gần một toạ độ, kiểm tra định dạng mã của 180 nước.

Kết quả

Bấm “Chạy” để xem kết quả.

country + postcode (hoặc /v1/world-postcodes/<CC>/<mã>) trả về các địa danh dùng mã đó cùng đơn vị hành chính cấp 1, 2, 3 và toạ độ gần đúng; khoảng trắng, gạch ngang và chữ hoa không quan trọng (sw1a1aa = SW1A 1AA). Mã chưa đầy đủ (outward code như SW1A, vài chữ số đầu của ZIP) sẽ liệt kê các mã bắt đầu bằng chuỗi đó. Mọi kết quả đều cho biết mã có đúng định dạng chính thức của nước đó không (format.valid, mẫu regex và ví dụ); validate_only=true chỉ kiểm tra định dạng mà không tra cứu, dùng được cho khoảng 180 nước – kể cả nước không có cơ sở dữ liệu như Việt Nam.

q tìm địa danh theo tên trong một nước (không cần dấu) kèm các mã của nó; lat + lon trả về các mã bưu chính gần một điểm nhất. action=countries liệt kê các nước có dữ liệu, action=formats liệt kê mẫu định dạng.

Dữ liệu: bộ mã bưu chính của GeoNames (CC BY 4.0, cập nhật hàng tuần) – khoảng 4,1 triệu mã; Anh và Hà Lan có mã đầy đủ (Anh lấy từ Code-Point Open, giấy phép Open Government Licence), Canada, Ireland, Malta, Chile và Argentina chỉ có phần đầu, Brazil chỉ có mã chính, một số nước (gồm Việt Nam) không có. Toạ độ là tâm vùng, không phải điểm giao hàng. Định dạng lấy từ dữ liệu địa chỉ của Google (libaddressinput, CC BY 4.0). Khi hiển thị dữ liệu hãy giữ dòng attribution.

Dùng trong code của bạn

curl "https://apibox.io.vn/v1/world-postcodes?country=GB&postcode=sw1a1aa" \
  -H "Authorization: Bearer YOUR_API_KEY"

const res = await fetch('https://apibox.io.vn/v1/world-postcodes?country=GB&postcode=sw1a1aa', {
  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/world-postcodes?country=GB&postcode=sw1a1aa",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    timeout=30,
)
print(res.json())

<?php
$ch = curl_init('https://apibox.io.vn/v1/world-postcodes?country=GB&postcode=sw1a1aa');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
]);
$response = curl_exec($ch);
print_r(json_decode($response, true));

Tài liệu API → Nhận API key miễn phí

Hỏi đáp

Những nước nào có dữ liệu?

124 nước có cơ sở dữ liệu (action=countries liệt kê kèm số dòng); khoảng 180 nước kiểm tra được định dạng. Việt Nam được kiểm tra định dạng ở đây và tra cứu riêng tại /v1/vn-postcode.

Vì sao mã Canada chỉ có 3 ký tự đầu?

Mã bưu chính Canada đầy đủ thuộc quyền của Canada Post; dữ liệu mở chỉ có vùng phân loại đầu (ví dụ K1A). Hãy tra bằng 3 ký tự đó.

Toạ độ có chính xác không?

Không tuyệt đối. Đó là tâm vùng mã hoặc tâm địa danh; trường accuracy (1, 4 hoặc 6) cho biết cách xác định.