# Vietmap API Playground > Công cụ dùng thử trực tiếp các API bản đồ Việt Nam của Vietmap ngay trên trình duyệt: tìm kiếm địa điểm, chuyển đổi giữa địa chỉ và tọa độ, tìm đường, tính ma trận khoảng cách, tối ưu lộ trình giao hàng và chuyển đổi địa chỉ theo đơn vị hành chính mới. Mỗi trang là một công cụ tương tác: nhập tham số, bấm chạy, rồi xem thẳng URL request và response JSON thật của Vietmap. Có sẵn API key demo để thử ngay mà không cần đăng ký; đăng nhập tài khoản Vietmap thì trang tự lấy API key của tài khoản để dùng. Đây là nơi **dùng thử**, không phải tài liệu API chính thức. Đặc tả đầy đủ về tham số và kiểu dữ liệu nằm ở https://maps.vietmap.vn/docs. ## Bản đồ nền - [Tilemap API](https://tools.vietmap.vn/playground/tilemap.md): Bản đồ nền Vietmap (tilemap): chọn style, xem trực tiếp, lấy code khởi tạo cho Web, Flutter, Android, iOS. Gọi tới `GET /maps/styles/{tm|lm|dm|hm}/style.json` trên `https://maps.vietmap.vn` (lớp giao thông phủ thêm từ /maps/styles/tf/style.json). Trang tương tác: https://tools.vietmap.vn/playground/tilemap · Tài liệu: https://maps.vietmap.vn/docs/map-api/tilemap/ ## Tìm kiếm & Địa chỉ - [Autocomplete API](https://tools.vietmap.vn/playground/autocomplete.md): Tìm kiếm địa điểm với Vietmap Autocomplete API. Gọi tới `GET /api/autocomplete/v4` trên `https://maps.vietmap.vn`. Trang tương tác: https://tools.vietmap.vn/playground/autocomplete · Tài liệu: https://maps.vietmap.vn/docs/map-api/autocomplete-version/autocomplete-v4/ - [Geocoding API](https://tools.vietmap.vn/playground/geocode.md): Chuyển đổi địa chỉ thành tọa độ với Vietmap Geocode API. Gọi tới `GET /api/search/v4` trên `https://maps.vietmap.vn`. Trang tương tác: https://tools.vietmap.vn/playground/geocode · Tài liệu: https://maps.vietmap.vn/docs/map-api/geocode-version/geocode-v4/ - [Reverse API](https://tools.vietmap.vn/playground/reverse.md): Xác định địa điểm từ tọa độ với Vietmap Reverse API. Gọi tới `GET /api/reverse/v4` trên `https://maps.vietmap.vn` (trang có tuỳ chọn chuyển sang v3). Trang tương tác: https://tools.vietmap.vn/playground/reverse · Tài liệu: https://maps.vietmap.vn/docs/map-api/reverse-version/reverse-v4/ ## Định tuyến - [Route API](https://tools.vietmap.vn/playground/route.md): Tìm đường đi giữa các điểm với Vietmap Route API. Gọi tới `GET /api/route/v4` trên `https://maps.vietmap.vn` (trang có tuỳ chọn chuyển sang v3 và api-version=1.1). Trang tương tác: https://tools.vietmap.vn/playground/route · Tài liệu: https://maps.vietmap.vn/docs/map-api/route-version/route-v4/ - [Matrix API](https://tools.vietmap.vn/playground/matrix.md): Tính toán ma trận khoảng cách giữa nhiều điểm, phù hợp cho các ứng dụng logistics và giao hàng (tìm tài xế gần nhất, tìm đường đi ngắn nhất/nhanh nhất giữa nhiều điểm). Gọi tới `GET /api/matrix/v4` trên `https://maps.vietmap.vn` (giữ /api/matrix?api-version=1.1 để đối chiếu). Trang tương tác: https://tools.vietmap.vn/playground/matrix · Tài liệu: https://maps.vietmap.vn/docs/map-api/matrix-version/matrix-v4/ - [Map matching API](https://tools.vietmap.vn/playground/map-matching.md): Làm sạch dữ liệu GPS theo đường đi thực tế với dữ liệu bản đồ. Giải pháp lý tưởng cho các ứng dụng giám sát, theo dõi đơn hàng, hoặc quản lý người dùng. Gọi tới `POST /api/match-tolls` trên `https://maps.vietmap.vn`. Trang tương tác: https://tools.vietmap.vn/playground/map-matching · Tài liệu: https://maps.vietmap.vn/docs/map-api/match-tolls/ ## Tối ưu logistics - [TSP API](https://tools.vietmap.vn/playground/tsp.md): Sắp lại thứ tự ghé thăm nhiều điểm sao cho quãng đường ngắn nhất, cho một xe. Gọi tới `GET /api/tsp/v4` trên `https://maps.vietmap.vn`. Trang tương tác: https://tools.vietmap.vn/playground/tsp · Tài liệu: https://maps.vietmap.vn/docs/map-api/tsp-version/tsp-v4/ - [VRP API](https://tools.vietmap.vn/playground/vrp.md): Phân bổ nhiều điểm giao cho đội xe, tôn trọng tải trọng và khung giờ. Gọi tới `POST /api/vrp?api-version=1.1` trên `https://maps.vietmap.vn`. Trang tương tác: https://tools.vietmap.vn/playground/vrp · Tài liệu: https://maps.vietmap.vn/docs/map-api/vrp/ ## Công cụ dữ liệu - [Address Migration API](https://tools.vietmap.vn/playground/migrate-address.md): Chuyển địa chỉ giữa định dạng cũ và mới sau khi sáp nhập tỉnh, phường. Gọi tới `GET /api/migrate-address/v3` trên `https://maps.vietmap.vn`. Trang tương tác: https://tools.vietmap.vn/playground/migrate-address · Tài liệu: https://maps.vietmap.vn/docs/migrate-address/migrate-address-docs/ ## Dành cho trợ lý AI và AI agent Playground được làm để AI dùng được, không chỉ người: - **Mỗi API có bản Markdown** (link ở danh sách trên, đuôi `.md`): mô tả, endpoint, và code mẫu chạy được ngay — cURL, JavaScript, Python, URL — cùng một **AI prompt** soạn sẵn để giao cho trợ lý lập trình viết code tích hợp. Trang HTML khai báo bản này bằng ``. - **Toàn bộ trong một file**: https://tools.vietmap.vn/playground/llms-full.txt — mọi API, mọi code mẫu, nối liền để nạp một lần vào ngữ cảnh. - **Code mẫu dùng `YOUR_API_KEY`** làm chỗ giữ key. Khi viết code cho người dùng, đọc key từ biến môi trường (ví dụ `VIETMAP_API_KEY`), không ghi cứng. - **Dẫn người dùng tới đúng request**: mỗi trang nhận tham số trên URL để mở sẵn form — ví dụ https://tools.vietmap.vn/playground/route?point=21.0285,105.8542&point=21.0368,105.8346&vehicle=motorcycle. Danh sách điểm lặp lại `point=lat,lng` theo thứ tự; trang không tự chạy request, và **không bao giờ** nhận `apikey` từ URL. - Trên mỗi trang, tab **AI prompt** có nút mở thẳng prompt trong ChatGPT hoặc Claude; prompt không bao giờ chứa API key. ## Ghi chú kỹ thuật - Mọi lời gọi API đều cần tham số `apikey`. Lấy key tại https://maps.vietmap.vn/console-v2/consumers. - Ý nghĩa mã lỗi: `401` sai API key; `423` tài khoản chưa bật tính năng đó (bật trong trang consumer của key); `423` kèm thông điệp "exceeded credit" là hết credit, nạp thêm tại https://maps.vietmap.vn/console-v2/payments; `429` vượt giới hạn tần suất. - API key demo của trang này chỉ dùng được từ trình duyệt trên https://tools.vietmap.vn; gọi từ phía máy chủ sẽ bị trả về 401. - Giao diện có hai ngôn ngữ, mỗi ngôn ngữ một URL: Tiếng Việt tại https://tools.vietmap.vn/playground/, Tiếng Anh tại https://tools.vietmap.vn/playground/en/ (bản Markdown tiếng Anh: thêm `/en` tương tự, ví dụ https://tools.vietmap.vn/playground/en/route.md; toàn bộ: https://tools.vietmap.vn/playground/en/llms-full.txt). ## Tài nguyên khác - [Tài liệu API Vietmap](https://maps.vietmap.vn/docs): đặc tả đầy đủ của toàn bộ API. - [Console quản lý API key](https://maps.vietmap.vn/console-v2/consumers): tạo key, bật tính năng cho từng key. - [Sitemap](https://tools.vietmap.vn/playground/sitemap.xml): danh sách đầy đủ các trang. - [llms-full.txt](https://tools.vietmap.vn/playground/llms-full.txt): nội dung Markdown của mọi trang API trong một file.