Geocoding API
Chuyển đổi địa chỉ thành tọa độ với Vietmap Geocode API
Kết quả Geocoding
Nhập địa chỉ và nhấp "Tìm tọa độ địa chỉ" để xem kết quả
Code mẫu
curl 'https://maps.vietmap.vn/api/search/v4?apikey=YOUR_API_KEY&text=197+Tr%E1%BA%A7n+Ph%C3%BA&admin_new=true&display_type=6'Thay YOUR_API_KEY bằng API key của bạn trước khi chạy.
// Khi đưa vào sản phẩm, đọc key từ biến môi trường thay vì ghi cứng.
const API_KEY = "YOUR_API_KEY";
const params = new URLSearchParams([
["apikey", API_KEY],
["text", "197 Trần Phú"],
["admin_new", "true"],
["display_type", "6"],
]);
const response = await fetch(`https://maps.vietmap.vn/api/search/v4?${params}`);
if (!response.ok) {
throw new Error(`Vietmap ${response.status}: ${await response.text()}`);
}
const data = await response.json();
console.log(data);Thay YOUR_API_KEY bằng API key của bạn trước khi chạy.
import requests
# Khi đưa vào sản phẩm, đọc key từ biến môi trường thay vì ghi cứng.
API_KEY = "YOUR_API_KEY"
params = [
("apikey", API_KEY),
("text", "197 Trần Phú"),
("admin_new", "true"),
("display_type", "6"),
]
response = requests.get("https://maps.vietmap.vn/api/search/v4", params=params, timeout=30)
response.raise_for_status()
print(response.json())Thay YOUR_API_KEY bằng API key của bạn trước khi chạy.
https://maps.vietmap.vn/api/search/v4?apikey=YOUR_API_KEY&text=197+Tr%E1%BA%A7n+Ph%C3%BA&admin_new=true&display_type=6Thay YOUR_API_KEY bằng API key của bạn trước khi chạy.
Tôi cần tích hợp Geocoding (Search) API v4 của Vietmap vào ứng dụng của mình.
Tài liệu chính thức: https://maps.vietmap.vn/docs/map-api/geocode-version/geocode-v4/
Đây là một request mẫu đã chạy được trên Vietmap API Playground:
GET https://maps.vietmap.vn/api/search/v4?apikey=YOUR_API_KEY&text=197+Tr%E1%BA%A7n+Ph%C3%BA&admin_new=true&display_type=6
Tham số đang dùng:
- text = 197 Trần Phú
- admin_new = true
- display_type = 6
Hãy viết code bằng [ngôn ngữ / framework của tôi] để gọi API này, với các yêu cầu:
1. Đọc API key từ biến môi trường VIETMAP_API_KEY, không ghi cứng trong code.
2. Truyền tham số qua query string đúng như request mẫu; tham số lặp lại (như `point`) phải giữ nguyên thứ tự.
3. Xử lý lỗi theo mã HTTP của Vietmap:
- 401: API key sai hoặc đã bị thu hồi.
- 403: key bị giới hạn theo domain / IP không khớp.
- 423: API chưa được bật cho consumer của key, HOẶC tài khoản hết credit — phân biệt bằng nội dung phản hồi (có cụm "exceeded credit" là hết credit).
- 429: vượt giới hạn tần suất — thử lại với backoff tăng dần.
4. Đặt timeout cho request, và định nghĩa kiểu dữ liệu (type / interface / dataclass) cho phản hồi.
Nếu không chắc tên một trường, tra trong tài liệu ở link trên thay vì đoán.Dán vào ChatGPT, Claude… để sinh code tích hợp. Prompt không bao giờ chứa API key của bạn.
https://tools.vietmap.vn/playground/geocode?text=197+Tr%E1%BA%A7n+Ph%C3%BA&display_type=6Mở Playground với đúng các tham số này — dùng để gắn vào tài liệu hoặc gửi đồng nghiệp. Link không chứa API key.
Chưa có phản hồi từ API
Geocoding API là gì?
Geocoding API là gì?
Geocoding API chuyển một địa chỉ dạng chữ thành tọa độ. Phiên bản v4 hiểu cả địa chỉ theo đơn vị hành chính mới sau sáp nhập lẫn địa chỉ cũ, nhận bộ lọc tỉnh, quận, phường, vòng tròn và danh mục, và trả kết quả kèm địa chỉ đã chuẩn hóa. Đây là bước đầu tiên khi cần đưa danh sách địa chỉ khách hàng lên bản đồ hay chuyển sang các API tìm đường, tối ưu lộ trình.
Dùng để làm gì
- Đưa danh sách đơn hàng, khách hàng lên bản đồ.
- Lấy tọa độ cho Route, Matrix, TSP, VRP.
- Kiểm tra địa chỉ có tồn tại trước khi tạo đơn.
- Phân vùng khách theo tỉnh, phường.
Request mẫu
GET https://maps.vietmap.vn/api/search/v4?apikey=YOUR_API_KEY&text=197%20Tr%E1%BA%A7n%20Ph%C3%BA&focus=10.7588,106.6755Thêm display_type để chọn định dạng địa chỉ mới, cũ hoặc cả hai.
Câu hỏi thường gặp về Geocoding API
- Geocoding là gì?
- Geocoding (mã hóa địa lý) là quá trình chuyển một địa chỉ dạng chữ, ví dụ “197 Trần Phú, Phường Chợ Quán, TP. Hồ Chí Minh”, thành tọa độ vĩ độ, kinh độ để đặt lên bản đồ hoặc đưa vào các bài toán tìm đường. Chiều ngược lại, từ tọa độ ra địa chỉ, gọi là reverse geocoding.
- Geocoding API có hiểu địa chỉ cũ trước sáp nhập không?
- Có. Phiên bản v4 nhận cả địa chỉ theo đơn vị hành chính mới lẫn địa chỉ cũ, và display_type cho phép chọn định dạng địa chỉ trả về. Nếu cần đổi hẳn dữ liệu sang địa chỉ mới, dùng thêm API chuyển đổi địa chỉ.
- Làm sao để kết quả geocoding chính xác hơn?
- Nhập địa chỉ càng đầy đủ càng tốt (số nhà, đường, phường, tỉnh), truyền focus gần khu vực cần tìm, hoặc giới hạn kết quả theo tỉnh, phường bằng bộ lọc hành chính.
- Dùng thử Geocoding API có mất phí không?
- Trên Playground có sẵn API key demo để gọi thử Geocoding API ngay trên trình duyệt, không cần đăng ký. Khi tích hợp vào sản phẩm, bạn đăng ký tài khoản VIETMAP để có API key riêng. Phí tính theo transaction, mỗi API quy đổi số request ra transaction theo tỉ lệ riêng; chi tiết và chương trình trải nghiệm miễn phí có trong bảng giá.