Tra toạ độ GPS ra phường, xã, tỉnh mới online

Đổi vĩ độ, kinh độ ra tỉnh và phường, xã mới (sau 1/7/2025) kèm mã đơn vị; tra hàng loạt tới 1000 điểm, kiểm tra điểm thuộc xã và lấy ranh giới xã.

Kết quả

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

Gửi lat và lng (hệ WGS 84, như toạ độ điện thoại, GPS trả về), API trả về tỉnh (34 đơn vị) và phường / xã / đặc khu (3.321 đơn vị) chứa điểm đó theo sắp xếp từ 1/7/2025, cùng mã Cục Thống kê, tên và mã bưu chính như /v1/vn-provinces. distance=1 cho thêm khoảng cách tới ranh giới xã; ward=<mã> kèm toạ độ cho biết điểm có nằm trong xã đó không (chấm công, giới hạn vùng), còn ward=<mã> riêng lẻ trả về khung bao, tâm, diện tích và, với geometry=1, ranh giới đã đơn giản hoá dạng GeoJSON.

Tra hàng loạt bằng POST points dạng [[lat, lng], …] hoặc [{"lat": …, "lng": …}] (tối đa 1000 điểm mỗi lần). Điểm nằm sát ngoài mọi xã (bãi biển, bờ sông, lệch vài mét so với ranh giới đơn giản hoá) được gán cho xã gần nhất trong phạm vi max_distance mét (mặc định 250), kèm inside: false và distance_m; xa hơn (ngoài biển, nước láng giềng) thì found: false và có thông tin xã gần nhất để tham khảo.

Ranh giới lấy từ phần GIS của bộ dữ liệu mở ThangLeQuoc/vietnamese-provinces-database (giấy phép MIT), xây dựng từ bản đồ tham chiếu chính thức sapnhap.bando.com.vn, được đơn giản hoá khoảng 30 m mà vẫn giữ các cạnh chung khớp nhau (không hở, không chồng giữa hai xã kề nhau). Vì vậy điểm cách ranh giới vài chục mét có thể rơi sang xã bên cạnh: kết quả được đánh dấu approximate, không thay cho xác định địa chính hay pháp lý. Không tra số nhà.

Dùng trong code của bạn

curl "https://apibox.io.vn/v1/vn-geo?lat=10.7725&lng=106.698" \
  -H "Authorization: Bearer YOUR_API_KEY"

const res = await fetch('https://apibox.io.vn/v1/vn-geo?lat=10.7725&lng=106.698', {
  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-geo?lat=10.7725&lng=106.698",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    timeout=30,
)
print(res.json())

<?php
$ch = curl_init('https://apibox.io.vn/v1/vn-geo?lat=10.7725&lng=106.698');
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

Có phải đơn vị hành chính mới sau 1/7/2025 không?

Đúng: 34 tỉnh, thành và 3.321 phường, xã, đặc khu, dùng chung mã với /v1/vn-provinces. Dữ liệu được đối chiếu hằng tuần với bản phát hành mới nhất.

Độ chính xác thế nào?

Ranh giới được đơn giản hoá khoảng 30 m; khi kiểm thử 99,7% điểm ngẫu nhiên trùng với bản đồ gốc, phần còn lại nằm cách ranh giới vài chục mét.

Điểm ngoài biển hoặc ngoài Việt Nam thì sao?

Điểm cách bờ trong max_distance (mặc định 250 m) được gán xã gần nhất; xa hơn thì found là false, kèm xã gần nhất và khoảng cách.