L'itinéraire le plus rapide et l'itinéraire le moins cher sont rarement la même ligne sur la carte. En Europe, la différence tient le plus souvent aux péages — et ils prennent deux formes qu'une estimation calculée pour une voiture se trompe dans des sens opposés : les péages au kilomètre sur les autoroutes françaises et les autostrade italiennes, et les redevances à durée (vignette ou Go-Box) dans la région DACH et en Europe centrale. Pour un camion à 5 essieux de 40 tonnes, ni l'une ni l'autre ne ressemble au tarif d'une voiture.
L'endpoint de routage de NAPSPAN renvoie le coût de péage calculé pour le camion que vous déplacez réellement. Activez l'option sur une requête d'itinéraire et vous récupérez deux choses : un total par devise pour l'ensemble du trajet, et un détail par section nommant chaque système de péage et le tarif qui s'applique à votre classe de véhicule.
Activer avec include
La tarification des péages est optionnelle, car son calcul a un coût en amont — vous ne le payez que lorsque vous le demandez. Ajoutez "tolls" au tableau include sur POST /api/v1/routing/route :
curl -X POST "https://api.napspan.com/api/v1/routing/route" \
-H "X-API-Key: your_key" \
-H "Content-Type: application/json" \
-d '{
"origin": { "lat": 48.1351, "lng": 11.5820 },
"destination": { "lat": 45.4642, "lng": 9.1900 },
"currency": "EUR",
"truck": {
"profile": "tractor",
"weight_t": 40.0,
"height_m": 4.0,
"axles": 5
},
"include": ["tolls"]
}'
C'est un Munich→Milan par le Brenner pour un tracteur à 5 essieux de 40 tonnes — un trajet qui traverse une section à péage au kilomètre autrichienne et le réseau autostrada italien. Le champ currency (ISO 4217) détermine la devise dans laquelle les tarifs sont rapportés ; c'est le profil truck que vous envoyez déjà qui fait que le prix est celui du camion.
La réponse
Deux endroits portent les données de péage. Le summary de l'itinéraire reçoit un tableau toll_costs — une entrée par devise distincte, car un même trajet peut traverser des systèmes facturés dans des devises différentes (un itinéraire passant par la Suisse mêle EUR et CHF). Chaque section de l'itinéraire reçoit un tableau tolls nommant les systèmes facturés sur ce tronçon et les tarifs qu'ils contiennent.
{
"routes": [
{
"summary": {
"distance_m": 492000,
"duration_s": 21600,
"toll_costs": [
{ "currency": "EUR", "value": 96.40 }
]
},
"sections": [
{
"distance_m": 184000,
"duration_s": 8100,
"summary": "A13 Brenner Autobahn (AT)",
"tolls": [
{
"system": "ASFINAG / Brenner",
"fares": [
{ "name": "Category 4+ (4+ axles)",
"price": { "currency": "EUR", "value": 49.10 } }
]
}
]
},
{
"distance_m": 308000,
"duration_s": 13500,
"summary": "A22 / A1 autostrada (IT)",
"tolls": [
{
"system": "Autostrade per l'Italia",
"fares": [
{ "name": "Class 5",
"price": { "currency": "EUR", "value": 47.30 } }
]
}
]
}
],
"geometry": { "type": "LineString", "coordinates": [ /* ... */ ] }
}
],
"route_id": "rt_9c40f2ab"
}
La valeur summary.toll_costs est la somme des tarifs de section dans cette devise — le chiffre que vous citeriez à un client ou que vous injecteriez dans un modèle de coût par axe de transport. Le détail sections[].tolls[] est l'endroit où vous voyez quel exploitant facture quoi, de sorte que vous pouvez expliquer la facture ou la comparer à une alternative sans péage.
Tarifé pour le véhicule, pas pour une voiture
C'est tout l'intérêt. Le tarif que vous récupérez est indexé sur le profil de camion de la requête — nombre d'essieux, poids total, hauteur et indicateur ADR concourent tous à la catégorie de péage retenue par le moteur. Un ensemble à 5 essieux n'obtient pas le tarif d'une voiture ; un chargement lourd n'obtient pas le tarif d'un véhicule léger. Le champ fares[].name reprend la catégorie appliquée (par ex. « Category 4+ ») pour que vous puissiez confirmer que le camion a bien été tarifé comme prévu.
Contourner les péages
Parfois, la réponse consiste à éviter complètement la route à péage. C'est un champ différent : mettez "tolls" dans le tableau avoid et le moteur contourne les infrastructures à péage là où il le peut, pour que vous puissiez peser le temps et la distance supplémentaires de l'option sans péage face à l'argent économisé.
{ "origin": { /* ... */ }, "destination": { /* ... */ },
"truck": { /* ... */ },
"alternatives": 1,
"avoid": ["tolls"],
"include": ["tolls"] }
Demandez une alternative en plus du contournement, gardez "tolls" dans include, et vous obtenez les deux itinéraires tarifés — la ligne rapide à péage et le détour sans péage — pour rendre l'arbitrage explicite plutôt qu'une supposition.
À quoi s'attendre côté données
Quelques remarques honnêtes pour que les chiffres se comportent comme vous l'attendez :
- Les autoroutes à péage au kilomètre sont bien tarifées — autoroutes françaises, autostrade/autopistas italiennes et espagnoles, péages sectionnels autrichiens et exploitants de réseau similaires renvoient de façon fiable des tarifs poids lourds par catégorie.
- Les systèmes à vignette et à boîtier sont basés sur la durée ou l'immatriculation. Lorsqu'un pays facture par vignette ou via une unité embarquée plutôt qu'au trajet, un itinéraire peut faire apparaître le système sans tarif net par trajet — traitez un
priceabsent comme « non tarifé ici », pas comme « gratuit », et comptabilisez la vignette périodique séparément. - C'est une estimation de planification. La tarification des péages est calculée au moment de la requête pour l'itinéraire et la classe de véhicule ; elle est conçue pour l'affectation et le devis, pas pour réconcilier au centime près un relevé d'exploitant.
- Pas de péage, pas de tableau. Un itinéraire sans péage, ou une requête qui n'a pas activé l'option, omet simplement
toll_costset lestollsde section — la forme de la réponse reste stable.
Un seul appel, tout le trajet
La tarification des péages passe par le même POST /api/v1/routing/route que les warnings[] de dangers du corridor et que la planification des pauses de conduite. Une seule requête transfrontalière (DE → AT → IT en une seule interrogation) peut renvoyer un itinéraire poids lourds praticable, les fermetures et restrictions qui s'y trouvent, l'endroit où le conducteur doit légalement s'arrêter, et ce que le trajet coûte en péages — le tableau opérationnel dont un exploitant a réellement besoin avant que le camion ne roule. Le routage est une fonctionnalité des offres payantes, avec un essai gratuit de 14 jours.
À vous d'essayer
- Documentation API — référence complète des requêtes et réponses de
POST /api/v1/routing/route - Carte en direct — explorez les données sous-jacentes sur l'ensemble des NAPs européens
- Clé API gratuite — sans carte, essai de 14 jours
Connaissez la facture de péage avant d'affecter le trajet
Ajoutez un mot à votre requête d'itinéraire et obtenez le coût de péage réel du camion à travers l'Europe — total et par section, tarifé pour son poids, ses essieux et sa catégorie. Essai gratuit de 14 jours. Sans carte.
Obtenir une clé API gratuite Explorer la carte