Danh sách đường phố theo phường/xã API

Liệt kê và tìm tên đường, phố, ngõ, hẻm của từng phường/xã và tỉnh mới từ OpenStreetMap, tìm được cả khi gõ không dấu.

Tham số

Ví dụ

curl "https://apibox.io.vn/v1/vn-streets?ward=00070&q=hang&limit=3" \
  -H "Authorization: Bearer YOUR_API_KEY"

const res = await fetch('https://apibox.io.vn/v1/vn-streets?ward=00070&q=hang&limit=3', {
  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/vn-streets?ward=00070&q=hang&limit=3",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    timeout=30,
)
print(res.json())

<?php
$ch = curl_init('https://apibox.io.vn/v1/vn-streets?ward=00070&q=hang&limit=3');
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ề

{
  "ward": {
    "code": "00070",
    "name": "Phường Hoàn Kiếm",
    "province_code": "01",
    "province": "Thành phố Hà Nội"
  },
  "total": 55,
  "offset": 0,
  "count": 3,
  "streets": [
    {
      "name": "Hàng Cân",
      "name_ascii": "hang can",
      "type": "street",
      "highway": "tertiary",
      "length_m": 157,
      "lat": 21.03465,
      "lng": 105.84967,
      "osm_way": "https://www.openstreetmap.org/way/28102774"
    },
    {
      "name": "Phố Hàng Bè",
      "name_ascii": "pho hang be",
      "type": "street",
      "highway": "residential",
      "length_m": 177,
      "lat": 21.03264,
      "lng": 105.85382,
      "osm_way": "https://www.openstreetmap.org/way/399591853"
    },
    {
      "name": "Phố Hàng Bồ",
      "name_ascii": "pho hang bo",
      "type": "street",
      "highway": "residential",
      "length_m": 285,
      "lat": 21.03382,
      "lng": 105.84815,
      "osm_way": "https://www.openstreetmap.org/way/28103110"
    }
  ],
  "attribution": "© OpenStreetMap contributors",
  "licence": "ODbL-1.0",
  "licence_url": "https://www.openstreetmap.org/copyright",
  "licence_note": "Street data © OpenStreetMap contributors, available under the Open Database License. This list is a derived database: if you redistribute it (or a substantial extract), credit OpenStreetMap and share it under the ODbL.",
  "coverage_note": "Only streets that carry a name in OpenStreetMap are listed; coverage is good in cities and incomplete in rural and mountainous areas. Wards are assigned from simplified boundaries, so streets on a ward border can appear in both wards.",
  "data": {
    "version": "20261111",
    "osm_timestamp": "2026-11-09T21:22:17.000Z",
    "built_at": "2026-11-11T03:01:14.154Z",
    "admin_version": "v5.2.0",
    "refresh": "monthly"
  }
}

Ứng dụng

• Gợi ý tên đường trong form địa chỉ đặt hàng, giao hàng
• Kiểm tra tên đường có thuộc phường/xã mới đã chọn
• Làm bộ chọn đường theo phường cho CRM, phần mềm vận chuyển
• Đối chiếu địa chỉ cũ sang phường mới theo tên đường

Hỏi đáp

API liên quan