Đoán tỉnh và xã/phường từ một chuỗi địa chỉ tự do

Ví dụ `Phường Ba Đình, Hà Nội`. Không phân biệt dấu; tự bỏ qua các chữ chỉ loại đơn vị (`Phường`, `Xã`, `TP`). Trường `matched` nói rõ mức khớp: `ward` (ra tới xã), `province` (chỉ ra tỉnh), `ambiguous` (tên xã có ở nhiều tỉnh mà chuỗi không nêu tỉnh — ứng viên nằm ở `ambiguous`), `none` (không nhận ra gì). ĐÂY LÀ PHÉP SO KHỚP TÊN, không phải phép hiểu địa chỉ: địa chỉ viết theo địa giới trước 01/7/2025 — còn tên huyện, hoặc tên tỉnh đã bị gộp — sẽ trả `none`, và đó là câu trả lời đúng.

GET https://api-tools.hitechcloud.vn/api/opendata/admin/resolve Đã chép

Cần khoá API

Tham số

address string · truy vấn bắt buộc

Chuỗi địa chỉ tự do, tối thiểu 3 ký tự. Ví dụ: Phường Ba Đình, Hà Nội.

Mã trả về

200 Thành công.

401 Thiếu hoặc sai khoá API. Gửi kèm header X-API-Key.

404 Không tìm thấy dữ liệu tương ứng.

429 Vượt hạn mức của khoá. Xem header Retry-After.

Ví dụ gọi

bash

curl --location 'https://api-tools.hitechcloud.vn/api/opendata/admin/resolve?address=GIA_TRI' \
--header 'X-API-Key: $HITECH_API_KEY' \
--header 'Accept: application/json'

php

$response = Http::withHeaders([
    'X-API-Key' => env('HITECH_API_KEY'),
])->get('https://api-tools.hitechcloud.vn/api/opendata/admin/resolve', [
    'address' => 'GIA_TRI',
]);

$data = $response->json();

javascript

const q = new URLSearchParams({
  address: 'GIA_TRI',
});

const res = await fetch(`https://api-tools.hitechcloud.vn/api/opendata/admin/resolve?${q}`, {
  headers: { 'X-API-Key': process.env.HITECH_API_KEY },
});

const data = await res.json();

python

import os, requests

res = requests.get(
    "https://api-tools.hitechcloud.vn/api/opendata/admin/resolve",
    headers={"X-API-Key": os.environ["HITECH_API_KEY"]},
    params={
        "address": "GIA_TRI",
    },
)
data = res.json()

Đã chép mã

Thử ngay

X-API-Key

Khoá chỉ lưu trong trình duyệt của bạn. Lấy khoá →

address bắt buộc truy vấn

Cùng nhóm

GET Danh sách quốc gia kèm mã ISO và mã điện thoại GET Tra ngược từ mã bưu chính năm chữ số ra các xã... GET Danh sách 34 tỉnh và thành phố trực thuộc trun... GET Chi tiết một tỉnh hoặc thành phố trực thuộc tr... GET Toàn bộ xã POST Cùng phép đoán như bản GET nhưng nhận nhiều đị...