Route d'une expédition
Pour afficher la route d'une expédition dans votre propre application, analysez la réponse de l'endpoint GET /shipment de la Container Tracking API, récupérez les coordonnées dont vous avez besoin et transmettez-les à un outil de cartographie. La réponse offre trois niveaux de détail : le bloc route pour les lieux clés, la liste locations pour chaque lieu, et routeData.routeSegments pour un trajet possible entre eux.
Port de chargement et port de déchargement
Pour n'afficher que le port de chargement (POL) et le port de déchargement (POD), utilisez le bloc route de la réponse. C'est une vue simplifiée de l'expédition composée de quatre lieux :
prepol— le premier lieu de l'expédition, avant le port de chargement ;pol— le port de chargement ;pod— le port de déchargement ;postpod— le dernier lieu de l'expédition, après le port de déchargement.
Chacun porte le lieu, avec ses coordonnées, et une date.
{
"route": {
"prepol": {
"location": {
"name": "Elland",
"state": "England",
"country": "United Kingdom",
"countryCode": "GB",
"locode": "GBEND",
"coordinates": { "lat": 53.41, "lng": -1.5 },
"timezone": "Europe/London"
},
"date": "2024-08-12T05:00:00+01:00",
"actual": true,
"predictiveEta": null
},
"pol": {
"location": {
"name": "LIVERPOOL",
"state": "England",
"country": "United Kingdom",
"countryCode": "GB",
"locode": "GBLIV",
"coordinates": { "lat": 53.4224, "lng": -3.00837 },
"timezone": "Europe/London"
},
"date": "2024-08-13T04:18:00+01:00",
"actual": true,
"predictiveEta": null
},
"pod": {
"location": {
"name": "MONTREAL",
"state": "Quebec",
"country": "Canada",
"countryCode": "CA",
"locode": "CAMTR",
"coordinates": { "lat": 45.557, "lng": -73.5167 },
"timezone": "America/Toronto"
},
"date": "2024-08-23T06:34:00-04:00",
"actual": true,
"predictiveEta": null
},
"postpod": {
"location": {
"name": "VANCOUVER",
"state": "British Columbia",
"country": "Canada",
"countryCode": "CA",
"locode": "CAVAN",
"coordinates": { "lat": 49.3036, "lng": -123.048 },
"timezone": "America/Vancouver"
},
"date": "2024-09-06T02:48:01-07:00",
"actual": false,
"predictiveEta": null
}
}
}
Chaque lieu de l'expédition
Pour afficher chaque lieu par lequel passe l'expédition, ports de transbordement compris, et pour les nommer ou les relier dans l'ordre, utilisez la liste locations de la réponse. Elle donne chaque lieu de l'expédition, avec ses coordonnées.
{
"locations": [
{
"name": "LIVERPOOL",
"state": "England",
"country": "United Kingdom",
"countryCode": "GB",
"locode": "GBLIV",
"coordinates": { "lat": 53.4224, "lng": -3.00837 },
"timezone": "Europe/London"
},
{
"name": "Elland",
"state": "England",
"country": "United Kingdom",
"countryCode": "GB",
"locode": "GBEND",
"coordinates": { "lat": 53.41, "lng": -1.5 },
"timezone": "Europe/London"
},
{
"name": "MONTREAL",
"state": "Quebec",
"country": "Canada",
"countryCode": "CA",
"locode": "CAMTR",
"coordinates": { "lat": 45.557, "lng": -73.5167 },
"timezone": "America/Toronto"
},
{
"name": "Brampton",
"state": "Ontario",
"country": "Canada",
"countryCode": "CA",
"locode": "CABRP",
"coordinates": { "lat": 43.6834, "lng": -79.7663 },
"timezone": "America/Toronto"
},
{
"name": "VANCOUVER",
"state": "British Columbia",
"country": "Canada",
"countryCode": "CA",
"locode": "CAVAN",
"coordinates": { "lat": 49.3036, "lng": -123.048 },
"timezone": "America/Vancouver"
}
]
}
Route possible de l'expédition
Pour afficher une route que le navire pourrait suivre du port de chargement au port de déchargement, escales aux ports de transbordement comprises, utilisez routeData.routeSegments. Ce champ est renvoyé quand le paramètre de requête route vaut true, sa valeur par défaut.
Les segments de route sont une succession de trajets entre des lieux. Chaque segment contient un path — un tableau de coordonnées — et un routeType, SEA ou LAND. Ensemble, ils dessinent une route possible de l'expédition, libre d'affichage sur une carte.
L'extrait ci-dessous garde les premières coordonnées d'un segment sur cinq ; un trajet réel contient bien plus de points.
{
"routeData": {
"routeSegments": [
{
"path": [
{ "lat": 53.41042, "lng": -2.97761 },
{ "lat": 53.40698, "lng": -2.88649 },
{ "lat": 53.40112, "lng": -2.79663 }
],
"routeType": "LAND"
}
]
}
}
Traverser le 180e méridien
Les outils de cartographie comme Mapbox tracent dans le mauvais sens une route qui traverse l'océan Pacifique : entre un point de longitude 135 et un point de longitude -157, la ligne traverse toute la carte au lieu de franchir le 180e méridien.
Pour l'éviter, dans un trajet qui franchit le 180e méridien, ajoutez 360 à la longitude de chaque point où elle devient négative. L'expédition de test gratuite ZZZZ0000000 permet de tester la correction.
Ce trajet, tel que l'API le renvoie :
{
"path": [
{ "lat": 33.2347, "lng": 135.7899 },
{ "lat": 37.12, "lng": -157.5674 }
]
}
devient, une fois corrigé :
{
"path": [
{ "lat": 33.2347, "lng": 135.7899 },
{ "lat": 37.12, "lng": 202.4326 }
]
}
Le tutoriel Mapbox Draw a line across the 180th meridian montre la même correction en JavaScript.