Approches
Pour optimiser les performances de Fleet Engine, fournissez un flux de véhicules votre position est mise à jour au moins une fois par minute et toutes les cinq secondes au maximum. Pour fournir ces mises à jour, utilisez l'une des méthodes suivantes:
- Utiliser le SDK Driver: option la plus simple.
- Utiliser un code personnalisé : utile si les positions sont relayées via votre backend ou si vous utilisez des appareils autres qu'Android ou iOS. Ce document présente cette approche.
Quelle que soit la manière dont vous fournissez les mises à jour de la position des véhicules, votre backend est chargé de mettre à jour Fleet Engine lorsqu'un véhicule de livraison se dirige vers un arrêt et lorsqu'il y arrive. y compris le dépôt lui-même. Fleet Engine ne détecte pas ces événements automatiquement.
Exemples de mises à jour de la position du véhicule
Vous pouvez utiliser la bibliothèque gRPC Java pour mettre à jour la position d'un véhicule dans Fleet Engine ou utiliser REST.
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
comme suit:
Champs obligatoires :
Champ Valeur lastLocation.supplementalLocation
Emplacement du véhicule. lastLocation.supplementalLocationTime
Dernier horodatage connu du véhicule à cet endroit. lastLocation.supplementalLocationSensor
Doit être renseigné avec CUSTOMER_SUPPLIED_LOCATION
.Champs facultatifs :
Champ Valeur lastLocation.supplementalLocationAccuracy
Précision de l'emplacement fourni, 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