Modifier l'emplacement d'un véhicule de livraison

Approches

Pour optimiser les performances de Fleet Engine, fournissez-lui un flux de mises à jour de la position des véhicules au moins une fois par minute et au plus une fois toutes les cinq secondes. Pour fournir ces mises à jour, procédez de l'une des manières suivantes :

  • Utiliser le SDK Driver : option la plus simple.
  • Utiliser du code personnalisé : utile si les positions sont relayées via votre backend, ou si vous utilisez des appareils autres qu'Android ou iOS. Cette approche est décrite dans ce document.

Quelle que soit la manière dont vous fournissez les mises à jour de la position des véhicules, votre backend est responsable de la mise à jour de Fleet Engine lorsqu'un véhicule de livraison est en route vers un arrêt et lorsqu'il arrive à un arrêt. Cela inclut le dépôt lui-même. Fleet Engine ne détecte pas automatiquement ces événements.

Exemples de mise à jour de la position des véhicules

Pour mettre à jour la position d'un véhicule dans Fleet Engine, vous pouvez utiliser la bibliothèque Java gRPC ou REST, comme illustré dans l'exemple suivant. Pour obtenir la liste complète des langues disponibles, consultez la page Bibliothèques clientes pour les services de tâches planifiées.

Java

  static final String PROJECT_ID = "my-delivery-co-gcp-project";
  static final String VEHICLE_ID = "vehicle-8241890";

  DeliveryServiceBlockingStub deliveryService =
    DeliveryServiceGrpc.newBlockingStub(channel);

  // Vehicle settings
  String vehicleName = "providers/" + PROJECT_ID + "/deliveryVehicles/" + VEHICLE_ID;
  DeliveryVehicle myDeliveryVehicle = DeliveryVehicle.newBuilder()
      .setLastLocation(DeliveryVehicleLocation.newBuilder()
          .setSupplementalLocation(LatLng.newBuilder()
              .setLatitude(37.3382)
              .setLongitude(121.8863))
          .setSupplementalLocationTime(now())
          .setSupplementalLocationSensor(DeliveryVehicleLocationSensor.CUSTOMER_SUPPLIED_LOCATION)
          .setSupplementalLocationAccuracy(DoubleValue.of(15.0)))  // Optional
      .build();

  // DeliveryVehicle request
  UpdateDeliveryVehicleRequest updateDeliveryVehicleRequest =
    UpdateDeliveryVehicleRequest.newBuilder()  // No need for the header
        .setName(vehicleName)
        .setDeliveryVehicle(myDeliveryVehicle)
        .setUpdateMask(FieldMask.newBuilder()
            .addPaths("last_location"))
        .build();

  try {
    DeliveryVehicle updatedDeliveryVehicle =
        deliveryService.updateDeliveryVehicle(updateDeliveryVehicleRequest);
  } catch (StatusRuntimeException e) {
    Status s = e.getStatus();
    switch (s.getCode()) {
       case NOT_FOUND:
         break;
       case PERMISSION_DENIED:
         break;
    }
    return;
  }

REST

PATCH https://fleetengine.googleapis.com/v1/providers/<project_id>/deliveryVehicles/<id>?updateMask=last_location

Informations sur la demande

Le corps de la requête doit contenir une entité DeliveryVehicle qui spécifie les champs comme suit :

  • Champs obligatoires :

    ChampValeur
    lastLocation.supplementalLocation Position du véhicule.
    lastLocation.supplementalLocationTime Dernier timestamp connu indiquant que le véhicule se trouvait à cet emplacement.
    lastLocation.supplementalLocationSensor Doit être renseigné avec CUSTOMER_SUPPLIED_LOCATION.

  • Champs facultatifs :

    ChampValeur
    lastLocation.supplementalLocationAccuracy Précision de la position fournie, en mètres. 

  # Set JWT, PROJECT_ID, VEHICLE_ID, TASK1_ID, and TASK2_ID in the local
  # environment
  curl -X PATCH "https://fleetengine.googleapis.com/v1/providers/${PROJECT_ID}/deliveryVehicles/${VEHICLE_ID}?updateMask=remainingVehicleJourneySegments" \
    -H "Content-type: application/json" \
    -H "Authorization: Bearer ${JWT}" \
    --data-binary @- << EOM
  {
    "lastLocation": {
      "supplementalLocation": {"latitude": 12.1, "longitude": 14.5},
      "supplementalLocationTime": "$(date -u --iso-8601=seconds)",
      "supplementalLocationSensor": "CUSTOMER_SUPPLIED_LOCATION",
      "supplementalLocationAccuracy": 15
    }
  }
  EOM

Étape suivante