Method: networks.shipments.route

Acheminer un nouvel envoi. Comme pour la création, cette opération implique un changement d'état.

Requête HTTP

POST https://middlemileoptimization.googleapis.com/v1/{parent=networks/*}/shipments:route

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
parent

string

Obligatoire. Le réseau parent, c'est-à-dire le réseau sur lequel la livraison doit être acheminée Format : "networks/{network}"

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON
{
  "shipment": {
    object (Shipment)
  }
}
Champs
shipment

object (Shipment)

Obligatoire. Colis à acheminer.

Corps de la réponse

Message de réponse pour la méthode shipments.route.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON
{
  "shipment": {
    object (Shipment)
  },
  "paths": [
    {
      object (Path)
    }
  ],
  "lines": [
    {
      object (GeneratedLineAndRotation)
    }
  ]
}
Champs
shipment

object (Shipment)

Envoi qui vient d'être créé.

paths[]

object (Path)

Chemins modifiés en raison de l'acheminement du colis. Ce champ contient au moins une entrée, à savoir le chemin d'accès au colis qui a dû être acheminé. Il peut contenir d'autres chemins d'accès pour d'autres livraisons, reflétant des changements d'état internes.

lines[]

object (GeneratedLineAndRotation)

Rotations des lignes créées lors de l'acheminement du colis. Il peut être vide ou contenir des rotations pour d'autres envois, reflétant les changements d'état interne.

GeneratedLineAndRotation

Une rotation d'une ligne générée par cette API et non par le client API. Elle est intrinsèquement moins contraignante et peut utiliser n'importe quel véhicule (sauf si le client API décide du contraire lors des appels suivants).

Représentation JSON
{
  "arrivalTimes": {
    string: {
      object (DateTime)
    },
    ...
  },
  "departureTimes": {
    string: {
      object (DateTime)
    },
    ...
  }
}
Champs
arrivalTimes

map (key: string, value: object (DateTime))

Uniquement en sortie. Faire correspondre les ID de hub et les heures. Cette carte est censée avoir les mêmes clés (moins le hub source, sans heure d'arrivée).

Objet contenant une liste de paires "key": value. Exemple : { "name": "wrench", "mass": "1.3kg", "count": "3" }.

departureTimes

map (key: string, value: object (DateTime))

Uniquement en sortie. Faire correspondre les ID de hub et les heures. Cette carte est censée avoir les mêmes clés (moins le hub de destination, sans heure de départ).

Objet contenant une liste de paires "key": value. Exemple : { "name": "wrench", "mass": "1.3kg", "count": "3" }.