Đăng ký tài khoản và lấy API key VIETMAP¶
Để dùng API bản đồ và các dịch vụ bản đồ số của VIETMAP, bạn cần đăng ký tài khoản tại https://maps.vietmap.vn/console-v2/register
Tài khoản mới nhận gì
Miễn phí 60.000 transaction — tương đương khoảng 3.000.000đ. Không cần thẻ tín dụng. Xem cách quy đổi request ra transaction hoặc các gói cước theo bảng giá.
Các bước đăng ký¶
1. Vào trang đăng ký¶
Mở trang đăng ký tại: https://maps.vietmap.vn/console-v2/register
2. Điền thông tin đăng ký¶
Bạn cần điền đầy đủ các thông tin bắt buộc. Nếu bạn là sinh viên hoặc dùng cá nhân, có thể điền như sau:
- Sinh viên: điền tên trường vào ô Company Name, email của trường vào ô Company Email.
- Cá nhân: điền "Individual" vào ô Company Name, email cá nhân vào ô Company Email.
3. Đồng ý điều khoản¶
- Đọc và đồng ý Điều khoản sử dụng của VIETMAP
- Tích vào ô "I accept the terms and conditions"
4. Hoàn tất đăng ký¶
- Sau khi điền đủ thông tin, đồng ý điều khoản và bấm gửi, hệ thống sẽ gửi một email xác nhận về địa chỉ bạn vừa nhập.
5. Mở email và xác nhận tài khoản¶
- Chúng tôi gửi email xác nhận về địa chỉ bạn đã đăng ký. Bạn kiểm tra hộp thư đến hoặc thư mục spam để xác nhận. Link xác nhận chỉ có hiệu lực trong 24 giờ, bạn nhớ xác nhận trong khoảng thời gian này.
6. Xác nhận thành công¶
7. Nhận API key qua email¶
Ngay sau khi xác nhận email, bạn nhận một email thứ hai tiêu đề Account Registration Information chứa hai API key. Key dùng được ngay, không phải chờ duyệt.
- Services key — dùng cho các Map API: tìm địa chỉ, geocode, chỉ đường, ma trận, tối ưu lộ trình. Giữ ở phía backend, không để lộ.
- Tilemap key — chỉ để hiển thị bản đồ nền trong SDK. Key này chạy được phía client; bạn nhớ khai báo tên miền được phép gọi trong Console. Xem thêm ở Quản lý API Key.
Hai key không thay thế nhau được. Gọi Map API bằng tilemap key sẽ nhận lỗi 423.
8. Gọi thử request đầu tiên¶
curl "https://maps.vietmap.vn/api/autocomplete/v4?apikey=SERVICES_KEY_CUA_BAN&text=197%20tran%20phu&focus=10.7588,106.6753"
Phản hồi (đã rút gọn):
[
{
"ref_id": "geocode:RAkPcicmZ3d-NQ...",
"address": "Phường 4,Quận 5,Thành Phố Hồ Chí Minh",
"name": "197 Trần Phú",
"display": "197 Trần Phú Phường 4,Quận 5,Thành Phố Hồ Chí Minh"
}
]
| Mã | Nghĩa |
|---|---|
200 |
Thành công |
401 |
API key sai |
423 |
Hết hạn mức, hoặc API chưa được mở cho key này — chi tiết nằm trong phần thân phản hồi |
Muốn thử nhiều API cùng lúc thì dùng collection Postman dựng sẵn.
Hỗ trợ¶
Nếu gặp vướng mắc khi đăng ký, bạn liên hệ:
- Zalo OA: Vietmap Solutions
- Email: maps.info@vietmap.vn
- Website: https://maps.vietmap.vn
Bước tiếp theo¶
Sau khi tạo xong tài khoản, bạn xem tiếp các tài liệu sau:
Lưu ý: Mọi thông tin bạn cung cấp đều được VIETMAP bảo mật theo chính sách bảo mật của chúng tôi.
