Giới hạn & Điều kiện sử dụng¶
Trang này giải thích các mức giới hạn áp dụng cho tài khoản VIETMAP Map API của bạn, cách đọc chúng trên Dashboard của Console, chuyện gì xảy ra khi chạm giới hạn, và những thao tác nào cần quyền quản trị.
Loại tài khoản¶
Giới hạn và các thao tác bạn được làm phụ thuộc vào loại tài khoản:
| Loại tài khoản | Giới hạn | Mô tả |
|---|---|---|
| Trial | 500 / ngày + 100–200 / phút cho mỗi API | Tài khoản dùng thử miễn phí. Nâng cấp (bằng cách thanh toán) để tăng giới hạn và mở khóa các thao tác quản trị. Xem bảng chi tiết từng API bên dưới. |
| Standard | Theo tổng hạn mức | Tài khoản trả phí, tính tiền theo mức dùng trừ vào tổng hạn mức, không giới hạn theo ngày cho từng API. |
| Enterprise | 200 lượt / phút (mặc định, có thể nâng) | Tài khoản trả phí với tổng hạn mức lớn hơn nhiều, không giới hạn theo ngày cho từng API, và mức giới hạn tần suất có thể điều chỉnh — liên hệ hỗ trợ để nâng. |
Cần hạn mức cao hơn? Liên hệ bộ phận hỗ trợ.
Tài khoản do đội Sales của chúng tôi tạo mặc định là Enterprise. Nếu bạn đang dùng tài khoản Trial và muốn nâng cấp, hãy thanh toán để được cấp quyền quản trị và mở giới hạn cao hơn. Chi tiết xem Thanh toán & Hóa đơn.
Consumer & API Key¶
Mỗi tài khoản có sẵn hai consumer, mỗi consumer một API key riêng:
| Consumer | API key dùng cho | Dùng khi nào |
|---|---|---|
| default | Các Map API (Tìm kiếm, Geocode, Chỉ đường, …) | Gọi từ server backend của bạn. Giữ kín key này. Key này bị giới hạn theo loại tài khoản và hạn mức API như nêu ở trên. |
| public tile | Bản đồ nền (Tilemap) | Hiển thị bản đồ ở phía client (web/mobile). Key này nhúng thẳng vào bản đồ nền và để lộ cũng không sao. |
Dùng đúng key cho đúng việc: key default dành cho backend, tuyệt đối không đẩy xuống client; còn key public tile sinh ra để nhúng vào app phía client cho việc vẽ bản đồ. Mỗi key có hạn mức và quyền riêng — bạn đừng dùng lẫn lộn. Chi tiết xem Quản lý API Key.
Các khái niệm hạn mức¶
- Total Quota — tổng hạn mức của tài khoản, hiển thị theo dạng Tổng / Đã dùng / Còn lại.
- Daily Quota — hạn mức theo ngày của tài khoản (dùng để cảnh báo khi sắp chạm mức ngày).
- Limit per API — giới hạn tần suất của từng API, tính theo Mỗi phút / Mỗi giờ / Mỗi ngày (áp dụng cho tài khoản Trial).
- Daily request per API — hôm nay một API đã gọi bao nhiêu lượt so với giới hạn ngày của nó (ví dụ
500/500).
Cách đọc thẻ Total Quota¶
Thẻ Total Quota trên Dashboard hiển thị phần trăm đã dùng, thanh tiến trình, và số Đã dùng / Tổng. Màu thanh tiến trình cho biết tình trạng ngay lập tức:
| Mức dùng | Màu | Ý nghĩa |
|---|---|---|
| Dưới 80% | Xanh lá | Bình thường. |
| 80%–99% | Vàng | Sắp hết. Bạn nên nạp thêm để dịch vụ không bị gián đoạn. |
| Từ 100% trở lên | Đỏ | Đã dùng hết hạn mức. Phần trăm có thể vượt 100% (ví dụ 116%); số còn lại sẽ bị ẩn. |
Bấm Detail để mở rộng thẻ và xem chi tiết theo từng API.
Hệ thống sẽ tự động gửi email báo cho bạn khi tài khoản dùng tới 80% và 100% tổng hạn mức, nhưng bạn cũng có thể tự vào Dashboard của Console xem bất cứ lúc nào.
Giới hạn theo từng API (Trial)¶
Tài khoản Trial bị giới hạn trên từng API. Khi mở rộng thẻ Total Quota, bạn sẽ thấy bảng giới hạn theo từng API (chỉ để xem):
- Các cột: API · Mỗi phút · Mỗi ngày · Hôm nay · Trạng thái
- Nhãn trạng thái:
x/x(đỏ) — API này đã dùng hết lượt gọi của ngày hôm nay.on— API đang bật.off— API chưa được bật.
Bảng này chỉ để theo dõi và chỉ có ở tài khoản Trial. Tài khoản không phải Trial sẽ không thấy bảng này.
Giới hạn mặc định của tài khoản Trial¶
Đây là giới hạn áp dụng cho tài khoản Trial mới. Hầu hết API cho phép 500 lượt/ngày và tối đa 100 hoặc 200 lượt mỗi phút. Cột Mặc định cho biết Trạng thái ban đầu của từng API trong bảng console nói trên: On = đang bật, Off = chưa bật.
| API | Mỗi phút | Mỗi ngày | Mặc định |
|---|---|---|---|
| Auto Complete | 200 | — | On |
| Reverse | 200 | 500 | On |
| Geocode | 200 | 500 | On |
| Match | 200 | 500 | On |
| Route | 200 | 500 | On |
| Static | 200 | 500 | On |
| Near By Search | 200 | 500 | On |
| TSP | 100 | 500 | On |
| VRP | 100 | 500 | On |
| Matrix | 100 | 500 | On |
| Isochrone | 100 | 500 | On |
| Addr Parser | 100 | 500 | On |
| Boundary | 100 | 500 | On |
| Place | 100 | 500 | On |
| Tile | tối đa 5000 | — | Off |
| Driving Alert | — | — | Off |
| Traffic | — | — | Off |
Off nghĩa là API đó mặc định chưa bật cho tài khoản Trial. Auto Complete không giới hạn theo ngày (chỉ giới hạn theo phút). Cần hạn mức cao hơn hoặc cần bật thêm API? Liên hệ hỗ trợ để nâng cấp.
Khi chạm giới hạn¶
- Trial: Khi một API đã gọi đủ 500 lượt trong ngày (500/500), API đó tạm dừng cho tới khi hạn mức ngày được đặt lại vào hôm sau — hoặc cho tới khi bạn nâng cấp.
- Standard: Mức dùng được trừ vào tổng hạn mức. Khi tổng hạn mức dùng hết (thẻ chuyển đỏ / 100%), các lượt gọi sẽ bị chặn cho tới khi bạn nạp thêm.
- Enterprise: Các lượt gọi vượt giới hạn tần suất (mặc định 200 lượt/phút) sẽ bị từ chối. Bạn đợi một phút rồi gọi lại, hoặc liên hệ hỗ trợ để nâng giới hạn. Hạn mức ngày cũng cảnh báo ở mức 80% (vàng) và chặn ở mức 100% (đỏ) cho tới hết ngày.
Để không bị gián đoạn, bạn nên nạp thêm hoặc nâng cấp tài khoản trước khi chạm trần.
Phân quyền¶
Muốn chỉnh hạn mức và giới hạn từng API thì tài khoản phải có quyền quản trị (administrator).
| Tài khoản / vai trò | Bạn làm được gì |
|---|---|
| Trial | Xem mọi thông tin và sao chép API key. Muốn chỉnh giới hạn thì phải nâng cấp — thanh toán/nâng cấp để được cấp quyền quản trị và mở hạn mức cao hơn. |
| Người dùng thường (tài khoản trả phí, không phải admin) | Xem mọi thông tin và sao chép API key. Muốn đổi giới hạn thì liên hệ người quản trị tài khoản. |
| Quản trị viên | Xem mọi thứ và chỉnh giới hạn trực tiếp, rồi bấm Save. |
Dù ở quyền nào, bạn vẫn luôn xem được toàn bộ thông tin tài khoản và sao chép được API key.
Hỗ trợ¶
Nếu cần nâng cấp tài khoản hoặc có thắc mắc về hạn mức, bạn liên hệ:
- Zalo OA: Vietmap Solutions
- Email: maps.info@vietmap.vn
- Website: https://maps.vietmap.vn
