Source: https://maps.vietmap.vn/docs/map-api/console/usage-limitation/

# Usage Limits & Conditions

This page explains the usage limits that apply to your Vietmap API account, how to read them on the Console Dashboard, what happens when a limit is reached, and which actions require administrator permission.

## Account Types

Your limits and available actions depend on your account type:

| Account type | Limit | Description |
|---|---|---|
| **Trial** | **500 / day** + **100–200 / minute** per API | Free evaluation account. Upgrade (via payment) to raise limits and unlock administrator actions. See the [full per-API table](#default-trial-limits) below. |
| **Standard** | By total quota | Paid account billed by usage against a total quota, with no per-API daily caps. |
| **Enterprise** | **200 requests / minute** (default, can be raised) | Paid account with a much higher total quota, no per-API daily caps, and an adjustable rate limit — contact support to raise it. |

> Need higher limits? Contact our [support team](#support).

> Accounts **created by our Sales team** are **Enterprise** by default. If you have a **Trial** account and want to upgrade, make a payment to be granted administrator permission and unlock higher limits. See [Payment & Billing](https://maps.vietmap.vn/docs/map-api/console/payment/) for details.

## Consumers & API Keys

Every account comes with **two consumers** out of the box, each with its own API key:

| Consumer | API key for | Use it for |
|---|---|---|
| **default** | Map APIs (Search, Geocode, Routing, …) | Server-to-server calls from your **backend**. Keep this key private. This key will have limited access based on your account type and API limits, as described above. |
| **public tile** | Tilemap | Displaying the map on the **client** (web/mobile). This key is embedded in the tilemap and is safe to expose. |

Use the right key for the right job: the **default** key is for backend API calls and should never be shipped to a client, while the **public tile** key is meant to be published in your client app to render the map. **They each have their own usage limits and permissions — please do not confuse them.** See [Manage API key](https://maps.vietmap.vn/docs/map-api/console/manage-api-key/) for details.

## Quota Concepts

- **Total Quota** — the overall quota of your account, shown as **Total / Used / Available**.
- **Daily Quota** — the per-day quota of the account (applies to daily-limit warnings).
- **Limit per API** — the rate limit for an individual API, expressed as **Per Minute / Per Hour / Per Day** (applies to Trial accounts).
- **Daily request per API** — how many requests a single API has used today versus its daily limit (e.g. `500/500`).

## Reading the Total Quota Card

The **Total Quota** card on the Dashboard shows the percentage used, a progress bar, and the Used / Total figures. The progress bar color tells you the status at a glance:

| Usage | Color | Meaning |
|---|---|---|
| Below 80% | Green | Normal. |
| 80%–99% | Yellow | Almost full. Consider topping up to avoid a service interruption. |
| 100% or more | Red | Quota used up. The percentage may show above 100% (e.g. 116%); the available figure is hidden. |

Click **Detail** to expand the card for a per-API breakdown.

Our system will automatically send you an email notification when your account reaches 80% and 100% of the total quota, but you can also monitor it on the [Console Dashboard](https://maps.vietmap.vn/console-v2) at any time.

## Per-API Limits (Trial)

Trial accounts have a limit on each API. In the expanded Total Quota card you can see a read-only table of limits per API:

- **Columns**: API · Per Minute · Per Day · Today · Status
- **Status badges**:
  - `x/x` (red) — the API has used up its daily request allowance for today.
  - `on` — the API is enabled.
  - `off` — the API is not yet enabled.

This table is for monitoring only on Trial accounts. Accounts that are not Trial do not see this table.

### Default Trial Limits

These are the limits applied to a new Trial account. Most APIs allow **500 requests/day** with a per-minute cap of 100 or 200. The **Default** column shows each API's initial **Status** in the console table above: `On` = enabled, `Off` = not yet enabled.

| API | Per Minute | Per Day | Default |
|---|---|---|---|
| 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 | up to 5000 | — | Off |
| Driving Alert | — | — | Off |
| Traffic | — | — | Off |

> **Off** means the API is not enabled on Trial by default. **Auto Complete** has no daily cap (per-minute only). Need higher limits or an API that's off? [Contact support](#support) to upgrade.

## When a Limit Is Reached

- **Trial**: Once an API hits **500 requests today (500/500)**, it pauses until the daily limit resets the next day — or until you upgrade.
- **Standard**: Usage is billed against your **total quota**. When the total quota is fully used (the card shows red / 100%), requests are blocked until you top up.
- **Enterprise**: Calls beyond the **rate limit (200 requests/minute by default)** are rejected. Wait a minute and retry, or contact support to raise the limit. The daily quota also warns at 80% (yellow) and blocks at 100% (red) for the rest of the day.

To avoid interruptions, top up or upgrade your account before reaching the cap.

## Permissions

Adjusting quota and per-API limits requires **administrator** permission on the account.

| Account / role | What you can do |
|---|---|
| **Trial** | View all information and copy your API key. Adjusting limits requires upgrading — pay/upgrade to be granted administrator permission and unlock higher limits. |
| **Regular user** (paid account, not an admin) | View all information and copy your API key. To change limits, contact the administrator of your account. |
| **Administrator** | View everything and edit limits directly, then **Save**. |

> Regardless of permission, you can always view all account information and copy your API key.

## Support

If you need to upgrade your account or have questions about your limits, contact us:

- **Zalo OA**: [Vietmap Solutions](https://zalo.me/3189066936017422854)
- **Email**: [maps.info@vietmap.vn](mailto:maps.info@vietmap.vn)
- **Website**: [https://maps.vietmap.vn](https://maps.vietmap.vn)

## Related

- [Monitor API Key Usage](https://maps.vietmap.vn/docs/map-api/console/monitor-api-key-usage/)
- [Payment & Billing](https://maps.vietmap.vn/docs/map-api/console/payment/)
- [How Pricing Works](https://maps.vietmap.vn/docs/map-api/console/request-to-transaction/)