Route-tolls

---

Ngừng hỗ trợ

Chúng tôi khuyên dùng Route v4 API kèm tham số annotations=toll cho tích hợp mới — API này trả về cả tổng phí cầu đường lẫn chi tiết theo từng trạm trong cùng một phản hồi. Route-tolls API sẽ ngừng hỗ trợ trong tương lai.

Bạn gửi lên danh sách tọa độ GPS (lat, long). Route-tolls API tính ra tuyến đường khớp nhất với đường xe đã thật sự đi, kèm các trạm thu phí mà xe đã đi qua.

URL

https://maps.vietmap.vn/api/route-tolls?api-version=1.1&apikey={your-apikey}&vehicle={vehicle}

Method

POST

Tham số

Tham số	Kiểu	Bắt buộc	Mặc định	Mô tả
apikey	array string	có	không	API key VIETMAP cấp cho tài khoản của bạn. Đăng ký tại đây
vehicle	number	không	1	= 1 (Áp dụng cho xe con dưới 12 chỗ; xe tải dưới 2 tấn) = 2 (Applicable to passenger cars: seats <= 30; trucks: gross tonnage < 4 tons) = 3 (Applicable to passenger cars: seats > 31; trucks: total tonnage < 10 tons; tractors: not towing containers) = 4 (Applicable to trucks: gross tonnage < 18 tons; tractor trucks: containers <= 20 feet); = 5 (Applicable to trucks: gross tonnage >= 18 tons; tractors: containers > 20 feet)

Ví dụ

Input

URL:
https://maps.vietmap.vn/api/route-tolls?apikey=”YOUR APIKEY”&vehicle=5


body:
[
    [106.765137, 10.477009],[108.363304,11.398591]
]

Kết quả JSON

{
    "path": [
        [
            106.765375,
            10.477203
        ],
        /// More LngLat to present the route here
        [
            106.76586,
            10.478109
        ]
    ],
    "tolls": [
        {
            "name": "Trạm Thu Phí Cầu Phú Mỹ",
            "address": "Đường Võ Chí Công",
            "type": "",
            "amount": 77000
        },
        {
            "name": "Trạm Thu Phí Long Phước",
            "address": "Cao Tốc Hồ Chí Minh Long Thành Dầu Giây",
            "type": "entry",
            "amount": 0
        },
        {
            "name": "Trạm Thu Phí Dầu Giây",
            "address": "Cao Tốc Hồ Chí Minh Long Thành Dầu Giây",
            "type": "exit",
            "amount": 373000
        },
        {
            "name": "Trạm Thu Phí Sông Phan",
            "address": "Km 1725+252 Quốc Lộ 1A",
            "type": "",
            "amount": 177000
        },
        {
            "name": "Trạm Thu Phí Km 1661+600",
            "address": "Km 1661+600 Quốc Lộ 1A",
            "type": "",
            "amount": 177000
        }
    ] 
}

Mô tả phản hồi

Parameter	Type	Description
path	array	Mảng các cặp tọa độ dọc theo tuyến
tolls	array	Mảng thông tin các trạm thu phí dọc tuyến

Với mảng path:

Trường con	Kiểu	Mô tả
[longitude, latitude]	array of floats	Cặp tọa độ của một điểm trên tuyến

Với mảng tolls:

Trường con	Kiểu	Mô tả
name	string	Tên trạm thu phí
address	string	Địa chỉ hoặc tuyến đường đặt trạm thu phí
type	string	Loại trạm thu phí (vào, ra, v.v.)
amount	int	Mức phí, tính bằng VNĐ