Toll

Ejemplo – Descuento en el peaje mediante pago automático

Algunas estaciones de peaje ofrecen un porcentaje de descuento a los usuarios que utilizan métodos de pago automáticos, conocidos como TAG o TelePeaje.

En Brasil, este porcentaje es del 5% y sólo está disponible en algunos concesionarios que ofrecen el servicio. Este porcentaje puede variar en otros países. En Argentina, por ejemplo, el concesionario Caminos del Río Uruguay ofrece un 15% de descuento a los usuarios que utilicen el tag, o TelePeaje.

En el siguiente ejemplo, tenemos una ruta con un solo camión de dos ejes que pasa por el peaje de Parapuã, en Brasil, que ofrece un descuento del 5%.

Solicitud

Para obtener el valor con el descuento TAG ya aplicado se requerirán los siguientes parámetros::

  • vehicleType – Tipo de vehículo a considerar, en el ejemplo será TRUCK_WITH_TWO_DOUBLE_AXLES;
  • conditions – Objeto que indica qué valores se deben considerar para los peajes donde existen valores condicionales, como en este ejemplo un valor descontado para vehículos con TAG:
    • period – Indica el período que se debe considerar para devolver el valor exacto del peaje.En este caso, la ruta se realizará en un día común, por lo que el valor utilizado en este ejemplo será NORMAL.
    • billingType – Indica el tipo de tarifa que se debe considerar. El valor a utilizar en este ejemplo debe ser TAG.

Solicitud con Endpoint independiente

{
    "legs": [
        {
            "points": "`fidCffqtHo@t@u@hAm@p@yCvEe@v@aBvBqAjBeA~A",
            "vehicleType": "TRUCK_WITH_TWO_DOUBLE_AXLES",
            "condition": {
                "period": "NORMAL",
                "billingType": "TAG"
            }
        }
    ]
}

Solicitud con Trip API

{
    "calculationMode": "THE_FASTEST",
    "points": [
        {
            "siteId": "Point 1",
            "latitude": -21.843015408682692,
            "longitude": -50.71983853381955
        },
        {
            "siteId": "Point 2",
            "latitude": -21.840092392777727,
            "longitude": -50.72374936513232
        }
    ],
    "toll": {
        "vehicleType": "TRUCK_WITH_TWO_DOUBLE_AXLES",
        "condition": {
            "period": "NORMAL",
            "billingType": "TAG"
        }
    }
}

Respuesta

Respuesta con Endpoint independiente

{
    "legs": [
        {
            "tolls": [
                {
                    "id": "828",
                    "name": "Pedágio - Parapuã",
                    "address": "SP294, KM551+500",
                    "city": "Parapuã",
                    "state": {
                        "name": "São Paulo",
                        "code": "SP"
                    },
                    "country": "Brasil",
                    "concession": "Eixo-SP",
                    "direction": "WEST",
                    "coordinates": {
                        "latitude": -21.840998367867602,
                        "longitude": -50.722601401095574
                    },
                    "serviceTypes": [
                        {
                            "serviceId": "791",
                            "name": "Via Facil"
                        },
                        {
                            "serviceId": "35352945515000103",
                            "name": "ANTTCODE"
                        }
                    ],
                    "price": 19.76
                }
            ],
            "legTotalCost": 19.76,
            "vehicleType": "TRUCK_WITH_TWO_DOUBLE_AXLES",
            "condition": {
                "billingType": "TAG",
                "period": "NORMAL"
            },
            "calculationDate": 1738853654511
        }
    ],
    "totalCost": 19.76
}

Respuesta con Trip API

{
  "id": "67a4ccd6361dc514265d966f",
  "clientId": "maplink",
  "totalDistance": 518,
  "totalNominalDuration": 37,
  "averageSpeed": 64.8,
  "tollCosts": 19.76,
  "legs": [
      {
          "distance": 518,
          "nominalDuration": 37,
          "averageSpeed": 64.8,
          "points": "`fidCffqtHo@t@u@hAm@p@yCvEe@v@aBvBqAjBeA~A",
          "tollCalculation": {
              "tolls": [
                  {
                      "id": "828",
                      "name": "Pedágio - Parapuã",
                      "address": "SP294, KM551+500",
                      "city": "Parapuã",
                      "state": {
                          "name": "São Paulo",
                          "code": "SP"
                      },
                      "country": "Brasil",
                      "concession": "Eixo-SP",
                      "direction": "WEST",
                      "coordinates": {
                          "latitude": -21.840998367867602,
                          "longitude": -50.722601401095574
                      },
                      "serviceTypes": [
                          {
                              "serviceId": "791",
                              "name": "Via Facil"
                          },
                          {
                              "serviceId": "35352945515000103",
                              "name": "ANTTCODE"
                          }
                      ],
                      "price": 19.76
                  }
              ],
              "legTotalCost": 19.76,
              "vehicleType": "TRUCK_WITH_TWO_DOUBLE_AXLES",
              "calculationDate": 1738853590334,
              "condition": {
                  "billingType": "TAG",
                  "period": "NORMAL"
              }
          }
      }
  ],
  "crossedBorders": [],
  "source": "MAPLINK",
  "createdAt": 1738853590348,
  "expiryIn": 1739458390249
}