Aktualizowanie lokalizacji pojazdu dostawczego

Podejścia

Aby uzyskać najlepszą wydajność Fleet Engine, przesyłaj do niego strumień aktualizacji lokalizacji pojazdu co najmniej raz na minutę i co najwyżej raz na 5 sekund. Aby dostarczać te aktualizacje, użyj jednej z tych metod:

  • Użyj pakietu Driver SDK: najprostsza opcja.
  • Użyj kodu niestandardowego: przydatne, jeśli lokalizacje są przekazywane przez Twój backend, lub jeśli używasz urządzeń innych niż Android lub iOS. Ten dokument opisuje to podejście.

Niezależnie od tego, jak dostarczasz aktualizacje lokalizacji pojazdu, Twój backend jest odpowiedzialny za aktualizowanie Fleet Engine, gdy pojazd dostawczy jest w drodze do miejsca docelowego i gdy do niego dotrze. Obejmuje to sam magazyn. Fleet Engine nie wykrywa tych zdarzeń automatycznie.

Przykłady aktualizacji lokalizacji pojazdu

Aby zaktualizować lokalizację pojazdu w Fleet Engine, możesz użyć biblioteki gRPC w języku Java lub interfejsu REST, jak pokazano w tym przykładzie. Pełną listę obsługiwanych języków znajdziesz w artykule Biblioteki klienta dla usług zadań zaplanowanych.

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 Ostatni znany znacznik czasu, gdy pojazd znajdował się w tej lokalizacji.
    lastLocation.supplementalLocationSensor Powinien być wypełniony 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?