Developer docs

API
Reference.

Everything you need to integrate Beta Maps API. All endpoints use POST with JSON body and Basic Authentication.

Authentication

All requests use HTTP Basic Authentication. Include your username and password with every request.

// Basic Auth header

Authorization: Basic base64(username:password)

// Example with cURL

curl -u your_username:your_password \

-X POST https://api.beta.vn/v1/mapapi/geocode \

-H "Content-Type: application/json" \

-d '{"address": "37 Bế Văn Cấm, Quận 7, TP HCM"}'

All endpoints accept Content-Type: application/json and return JSON responses.

Base URL

https://api.beta.vn/v1/mapapi/<endpoint>

All endpoints are under the /v1/mapapi/ path prefix. All requests must use the POST method.

Endpoints

6 endpoints · All POST · JSON body

POST /v1/mapapi/direction

Calculate routes between two points. Accepts origin/destination as lat/lng or text addresses.

With coordinates

{
  "origin": { "lat": "10.8231", "lng": "106.6297" },
  "destination": { "lat": "20.978283", "lng": "105.817371" }
}

With text address

{
  "origin": "15 Võ Văn Kiệt, Quận 8",
  "destination": "37 Bế Văn Cấm, Quận 7"
}

POST /v1/mapapi/geocode

Forward & reverse geocoding. Send address text or lat/lng to convert between formats.

Address → coordinates

{
  "address": "37 Bế Văn Cấm / Quận 7 / TP HCM"
}

Coordinates → address

{
  "location": { "lat": "20.978283", "lng": "105.817371" }
}

POST /v1/mapapi/textsearch

Search places by text query within a radius. Returns matching places with details.

Example

{
  "location": { "lat": 20.978283, "lng": 105.817371 },
  "query": "nhà hàng",
  "radius": "1000"
}

POST /v1/mapapi/nearbysearch

Find places near a location. Discover nearby businesses and POIs.

Example

{
  "location": { "lat": "20.978283", "lng": "105.817371" }
}

POST /v1/mapapi/detail

Get full place details by place_id. Optionally include distance from a point.

Basic

{
  "place_id": "ChIJXx5qc016FTERvmL-4smwO7A"
}

With distance

{
  "place_id": "ChIJKbEmq8oudTERHKoGJK1mPmo",
  "location": { "lat": "20.978283", "lng": "105.817371" }
}

POST /v1/mapapi/search

Autocomplete search. Pass search_text with optional country filter and radius.