Aktualizowanie lokalizacji pojazdu dostawczego

Podejścia

Aby uzyskać najlepszą wydajność za pomocą Fleet Engine, udostępniaj jej strumień aktualizacji lokalizacji pojazdu co najmniej raz na minutę, a 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: przydaje się, jeśli lokalizacje są przekazywane przez backend lub jeśli używasz urządzeń innych niż z Androidem lub iOS. Ten dokument opisuje ten sposób.

Niezależnie od tego, jak dostarczasz informacje o lokalizacji pojazdu, Twój backend jest odpowiedzialny za aktualizowanie silnika floty, gdy pojazd dostawczy jest w drodze do przystanku i gdy do niego dojeżdża. Obejmuje to sam dworzec. Fleet Engine nie wykrywa tych zdarzeń automatycznie.

Przykłady aktualizacji lokalizacji pojazdu

Możesz użyć biblioteki gRPC Java, aby zaktualizować lokalizację pojazdu we flocie silnika lub użyć 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 pola w ten sposób:

  • Pola wymagane:

    PoleWartość
    lastLocation.supplementalLocation Lokalizacja pojazdu.
    lastLocation.supplementalLocationTime Ostatnia znana sygnatura czasowa, kiedy pojazd znajdował się w tej lokalizacji.
    lastLocation.supplementalLocationSensor Powinno być wypełnione wartością CUSTOMER_SUPPLIED_LOCATION.

  • Pola opcjonalne:

    PoleWartość
    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

Co dalej?