Podejścia
Aby uzyskać najlepszą wydajność we Fleet Engine, zapewnij jej strumień pojazdów lokalizacja jest aktualizowana co najmniej raz na minutę, ale nie częściej niż co 5 sekund. Zaktualizuj informacje na jeden z tych sposobów:
- Użyj pakietu Driver SDK: najprostsza opcja.
- Użyj kodu niestandardowego: przydatne, gdy lokalizacje są przekazywane przez Twój backend, lub jeśli korzystasz z urządzeń z systemem innym niż Android lub iOS. Tematy w tym dokumencie: jak ważna jest pokora.
Niezależnie od tego, jak przekazujesz aktualizacje o lokalizacji pojazdu, wewnętrzna baza danych odpowiada za aktualizowanie Fleet Engine, gdy pojazd dostawczy jest w drodze a kiedy na postoju. Obejmuje to również magazyn. Fleet Engine nie wykrywa ich automatycznie.
Aktualizowanie przykładowych lokalizacji pojazdu
Możesz użyć biblioteki gRPC Java, aby zaktualizować lokalizację pojazdu we flocie. Engine lub użyj 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
Szczegóły prośby
Treść żądania musi zawierać encję DeliveryVehicle
, która określa
następujące pola:
Pola wymagane:
Pole Wartość lastLocation.supplementalLocation
Lokalizacja pojazdu. lastLocation.supplementalLocationTime
Ostatnia znana sygnatura czasowa, kiedy pojazd znajdował się w tym miejscu. lastLocation.supplementalLocationSensor
Pole powinno zawierać wartość CUSTOMER_SUPPLIED_LOCATION
.Pola opcjonalne:
Pole Wartość lastLocation.supplementalLocationAccuracy
Dokładność podanej lokalizacji w metrach.
# 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