# Route d'une expédition

> La réponse de la Container Tracking API contient trois niveaux de données de route pour tracer une expédition sur une carte — le bloc route pour le POL et le POD, la liste locations pour chaque port, et routeData.routeSegments pour un trajet possible.

Pour afficher la route d'une expédition dans votre propre application, analysez la réponse de l'endpoint [`GET /shipment`](/fr/api/container-tracking/reference/get-shipment-detail) 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.

::callout{type="warning"}
La date de chaque lieu de `route` est la date du premier event connu à ce lieu. Pour le POL, c'est le plus souvent le gate in du conteneur ; pour le POD, c'est en général l'arrivée du navire. Pour la date d'un event précis, lisez les events dans `containers[].events`.
::

```json
{
  "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.

::callout{type="info"}
Les compagnies maritimes incluent rarement les escales intermédiaires dans leurs données de suivi de conteneurs : la liste `locations` de la Container Tracking API les contient donc rarement.
::

```json
{
  "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.

::callout{type="info"}
Les segments de route tiennent compte des dernières données connues sur le voyage du conteneur, pas de la position actuelle du navire. La position actuelle est donnée par `routeData.coordinates`.
::

L'extrait ci-dessous garde les premières coordonnées d'un segment sur cinq ; un trajet réel contient bien plus de points.

```json
{
  "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 :

```json
{
  "path": [
    { "lat": 33.2347, "lng": 135.7899 },
    { "lat": 37.12, "lng": -157.5674 }
  ]
}
```

devient, une fois corrigé :

```json
{
  "path": [
    { "lat": 33.2347, "lng": 135.7899 },
    { "lat": 37.12, "lng": 202.4326 }
  ]
}
```

Le tutoriel Mapbox [Draw a line across the 180th meridian](https://docs.mapbox.com/mapbox-gl-js/example/line-across-180th-meridian/) montre la même correction en JavaScript.
