Memperbarui lokasi kendaraan pengiriman

Pendekatan

Untuk mendapatkan performa terbaik dengan Fleet Engine, berikan aliran update lokasi kendaraan setidaknya sekali setiap menit dan paling banyak sekali setiap 5 detik. Gunakan salah satu cara berikut untuk memberikan update ini:

  • Menggunakan Driver SDK: Opsi paling sederhana.
  • Menggunakan kode kustom: berguna jika lokasi diteruskan melalui backend Anda, atau jika Anda menggunakan perangkat selain Android atau iOS. Dokumen ini membahas pendekatan tersebut.

Terlepas dari cara Anda memberikan update lokasi kendaraan, backend Anda bertanggung jawab untuk mengupdate Fleet Engine saat kendaraan pengiriman sedang dalam perjalanan ke perhentian dan saat kendaraan tiba di perhentian. Hal ini mencakup depot itu sendiri. Fleet Engine tidak mendeteksi peristiwa ini secara otomatis.

Contoh update lokasi kendaraan

Untuk mengupdate lokasi kendaraan di Fleet Engine, Anda dapat menggunakan library gRPC Java atau REST, seperti yang ditunjukkan dalam contoh berikut. Untuk mengetahui daftar lengkap bahasa yang didukung, lihat Library klien untuk layanan tugas terjadwal.

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

Detail permintaan

Isi permintaan harus berisi entity DeliveryVehicle yang menentukan kolom sebagai berikut:

  • Kolom yang wajib diisi:

    KolomNilai
    lastLocation.supplementalLocation Lokasi kendaraan.
    lastLocation.supplementalLocationTime Stempel waktu terakhir yang diketahui saat kendaraan berada di lokasi ini.
    lastLocation.supplementalLocationSensor Harus diisi dengan CUSTOMER_SUPPLIED_LOCATION.

  • Kolom opsional:

    KolomNilai
    lastLocation.supplementalLocationAccuracy Akurasi lokasi yang diberikan, dalam meter. 

  # 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

Langkah berikutnya