Ta strona została przetłumaczona przez Cloud Translation API.

Aktualizowanie lokalizacji pojazdu dostawczego

Podejścia

Aby uzyskać najlepszą wydajność w przypadku usługi Fleet Engine, przesyłaj do niej strumień aktualizacji lokalizacji pojazdu co najmniej raz na minutę i maksymalnie co 5 sekund. Aby przesłać te informacje, użyj jednej z tych metod:

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. Ten dokument opisuje ten sposób.

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.

Przykłady aktualizacji 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ć element DeliveryVehicle, który określa pola w taki sposób:

Pola wymagane:

Pole	Wartość
`lastLocation.supplementalLocation`	Lokalizacja pojazdu.
`lastLocation.supplementalLocationTime`	Ostatnia znana sygnatura czasowa, kiedy pojazd znajdował się w tej lokalizacji.
`lastLocation.supplementalLocationSensor`	Pole powinno zawierać wartość `CUSTOMER_SUPPLIED_LOCATION`.

Pola opcjonalne:

Pole Wartość

lastLocation.supplementalLocationAccuracy Dokładność podanej lokalizacji w metrach.

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

Co dalej?

Uzyskaj pojazd dostawczy