Matrix API

curl 'https://maps.vietmap.vn/api/matrix/v4?apikey=YOUR_API_KEY&point=10.776889,106.700806&point=10.818,106.6585&points_encoded=true&vehicle=car&sources=all&destinations=all&annotation=duration'

// In production, read the key from an environment variable instead.
const API_KEY = "YOUR_API_KEY";

const params = new URLSearchParams([
  ["apikey", API_KEY],
  ["point", "10.776889,106.700806"],
  ["point", "10.818,106.6585"],
  ["points_encoded", "true"],
  ["vehicle", "car"],
  ["sources", "all"],
  ["destinations", "all"],
  ["annotation", "duration"],
]);

const response = await fetch(`https://maps.vietmap.vn/api/matrix/v4?${params}`);
if (!response.ok) {
  throw new Error(`Vietmap ${response.status}: ${await response.text()}`);
}
const data = await response.json();
console.log(data);

import requests

# In production, read the key from an environment variable instead.
API_KEY = "YOUR_API_KEY"

params = [
    ("apikey", API_KEY),
    ("point", "10.776889,106.700806"),
    ("point", "10.818,106.6585"),
    ("points_encoded", "true"),
    ("vehicle", "car"),
    ("sources", "all"),
    ("destinations", "all"),
    ("annotation", "duration"),
]

response = requests.get("https://maps.vietmap.vn/api/matrix/v4", params=params, timeout=30)
response.raise_for_status()
print(response.json())

https://maps.vietmap.vn/api/matrix/v4?apikey=YOUR_API_KEY&point=10.776889,106.700806&point=10.818,106.6585&points_encoded=true&vehicle=car&sources=all&destinations=all&annotation=duration

I need to integrate Vietmap's Matrix API v4 into my application.

Official documentation: https://maps.vietmap.vn/docs/map-api/matrix-version/matrix-v4/

Here is a sample request that works in the Vietmap API Playground:

GET https://maps.vietmap.vn/api/matrix/v4?apikey=YOUR_API_KEY&point=10.776889,106.700806&point=10.818,106.6585&points_encoded=true&vehicle=car&sources=all&destinations=all&annotation=duration

Parameters in use:
- point = 10.776889,106.700806
- point = 10.818,106.6585
- points_encoded = true
- vehicle = car
- sources = all
- destinations = all
- annotation = duration

Write code in [my language / framework] that calls this API, with these requirements:
1. Read the API key from the VIETMAP_API_KEY environment variable; never hard-code it.
2. Send the parameters in the query string exactly as in the sample; repeated parameters (such as `point`) must keep their order.
3. Handle Vietmap's HTTP errors:
   - 401: the API key is wrong or revoked.
   - 403: the key is restricted to a domain / IP that does not match.
   - 423: the API is not enabled for the key's consumer, OR the account is out of credit — tell them apart by the response body ("exceeded credit" means out of credit).
   - 429: rate limit exceeded — retry with increasing backoff.
4. Set a request timeout, and define types (type / interface / dataclass) for the response.

If unsure about a field name, look it up in the documentation linked above instead of guessing.

https://tools.vietmap.vn/playground/en/matrix?point=10.776889,106.700806&point=10.818,106.6585&version=v4&vehicle=car&annotation=duration