ایجاد و نمایش سفرهای پشت سر هم

سفرهای پشت سر هم سفرهای انحصاری و مستقلی هستند که یکی پس از دیگری اتفاق می‌افتند، جایی که راننده متعهد می‌شود که مصرف‌کننده بعدی را قبل از تکمیل سفر فعلی تحویل بگیرد.

تفاوت اصلی بین سفر پشت سر هم و سفر تک مقصدی این است که در سفر پشت سر هم، اپراتور سفر می تواند یک سفر را به وسیله نقلیه ای که قبلاً سفرهایی تعیین شده است اختصاص دهد.

این آموزش شما را در فرآیند ایجاد یک سفر پشت سر هم راهنمایی می کند. همچنین نشان می دهد که چگونه می توانید آن سفر را با برنامه مصرف کننده خود ادغام کنید تا مشتریان شما بتوانند پیشرفت سفر را از طریق تلفن خود تجسم کنند. شما این ادغام را با استفاده از Consumer SDK انجام می دهید.

همچنین ببینید: ایجاد و نمایش یک سفر مقصد واحد .

پیش نیازها

برای تکمیل این آموزش حتما موارد زیر را کامل کنید:

1. Fleet Engine را راه اندازی کنید. برای اطلاعات بیشتر، Fleet Engine: Initial setup را ببینید.

2. برنامه خود را با Driver SDK ادغام کنید. برای اطلاعات بیشتر، به راه‌اندازی SDK درایور برای Android و راهنمای یکپارچه‌سازی برای Driver SDK برای iOS مراجعه کنید.

3. برنامه مصرف کننده خود را با Consumer SDK ادغام کنید. برای اطلاعات بیشتر، شروع به کار با Consumer SDK برای Android و شروع به کار با Consumer SDK برای iOS را ببینید.

4. توکن های مجوز را تنظیم کنید. برای کسب اطلاعات بیشتر در مورد نشانه‌های مجوز، به ایجاد یک نشانه وب JSON برای مجوز در راهنمای شروع به کار با Fleet Engine و احراز هویت و مجوز در مستندات Consumer SDK برای Fleet Engine مراجعه کنید.

مرحله 1. یک وسیله نقلیه در Fleet Engine ایجاد کنید

وسایل نقلیه اشیایی هستند که نشان دهنده وسایل نقلیه در ناوگان شما هستند. شما باید آنها را در Fleet Engine ایجاد کنید تا بتوانید آنها را در برنامه مصرف کننده ردیابی کنید.

می توانید با استفاده از یکی از دو روش زیر یک وسیله نقلیه ایجاد کنید:

gRPC

متد CreateVehicle() را با پیام درخواست CreateVehicleRequest فراخوانی کنید. برای فراخوانی CreateVehicle() باید امتیازات Fleet Engine Super User را داشته باشید.

باقی مانده

با https://fleetengine.googleapis.com/v1/providers.vehicles. create .

هشدارها

هشدارهای زیر هنگام ایجاد وسیله نقلیه اعمال می شود.

• مطمئن شوید که وضعیت اولیه خودرو را روی OFFLINE تنظیم کنید. این تضمین می کند که Fleet Engine می تواند وسیله نقلیه شما را برای تطبیق سفر پیدا کند.

• provider_id وسیله نقلیه باید با شناسه پروژه Google Cloud Project که شامل حساب‌های سرویس مورد استفاده برای فراخوانی Fleet Engine است، باشد. در حالی که چندین حساب خدمات می توانند به Fleet Engine برای یک ارائه دهنده اشتراک سواری دسترسی داشته باشند، Fleet Engine در حال حاضر از حساب های خدماتی از پروژه های مختلف Google Cloud که به خودروهای مشابه دسترسی دارند پشتیبانی نمی کند.

• پاسخ برگشتی از CreateVehicle() حاوی نمونه Vehicle است. اگر با استفاده از UpdateVehicle() به‌روزرسانی نشده باشد، نمونه پس از هفت روز حذف می‌شود. باید قبل از فراخوانی CreateVehicle() GetVehicle() فراخوانی کنید تا تأیید کنید که وسیله نقلیه از قبل وجود ندارد. اگر GetVehicle() یک خطای NOT_FOUND برگرداند، باید با فراخوانی CreateVehicle() ادامه دهید. برای اطلاعات بیشتر، وسایل نقلیه و چرخه عمر آنها را ببینید.

مثال

نمونه کد ارائه دهنده زیر نحوه ایجاد یک وسیله نقلیه در Fleet Engine را نشان می دهد.

static final String PROJECT_ID = "my-rideshare-co-gcp-project";

VehicleServiceBlockingStub vehicleService = VehicleService.newBlockingStub(channel);

String parent = "providers/" + PROJECT_ID;

Vehicle vehicle = Vehicle.newBuilder()
    .setVehicleState(VehicleState.OFFLINE)  // Initial state
    .addSupportedTripTypes(TripType.EXCLUSIVE)
    .setMaximumCapacity(4)
    .setVehicleType(VehicleType.newBuilder().setCategory(VehicleType.Category.AUTO))
    .build();

CreateVehicleRequest createVehicleRequest = CreateVehicleRequest.newBuilder()
    .setParent(parent)
    .setVehicleId("8241890")  // Vehicle ID assigned by solution provider.
    .setVehicle(vehicle)      // Initial state.
    .build();

// The Vehicle is created in the OFFLINE state, and no initial position is
// provided.  When the driver app calls the rideshare provider, the state can be
// set to ONLINE, and the driver app updates the vehicle location.
try {
  Vehicle createdVehicle = vehicleService.createVehicle(createVehicleRequest);
} catch (StatusRuntimeException e) {
  Status s = e.getStatus();
  switch (s.getCode()) {
    case ALREADY_EXISTS:
      break;
    case PERMISSION_DENIED:
      break;
  }
  return;
}

برای ایجاد Vehicle که از سفرهای پشت سر هم پشتیبانی می کند، باید فیلد backToBackEnabled در شی Vehicle که به CreateVehicleRequest ارسال شده است را true تنظیم کنید.

Vehicle vehicle = Vehicle.newBuilder()
    .setVehicleState(VehicleState.OFFLINE)
    .addSupportedTripTypes(TripType.EXCLUSIVE)
    .setMaximumCapacity(4)
    .setVehicleType(VehicleType.newBuilder().setCategory(VehicleType.Category.AUTO))
    .setBackToBackEnabled(true) // Set as 'true' so vehicle can be assigned back-to-back trips.
    .build();

مرحله 2. ردیابی موقعیت مکانی را فعال کنید

ردیابی موقعیت مکانی به ردیابی مکان وسیله نقلیه در طول سفر اشاره دارد، جایی که برنامه راننده تله متری را به موتور ناوگان ارسال می کند، که حاوی مکان فعلی خودرو است. این جریان دائماً به روز شده اطلاعات موقعیت برای انتقال پیشرفت وسیله نقلیه در طول مسیر سفر استفاده می شود. هنگامی که ردیابی موقعیت مکانی را فعال می کنید، برنامه راننده شروع به ارسال این تله متری با فرکانس پیش فرض هر پنج ثانیه یک بار می کند.

ردیابی موقعیت مکانی را برای اندروید و iOS به صورت زیر فعال می کنید:

• متد Driver SDK for Android enableLocationTracking() را فراخوانی کنید.

• Driver SDK for iOS ویژگی boolean locationTrackingEnabled را روی true تنظیم کنید.

توجه: احراز هویت تماس‌ها با Driver SDK برای APIهای Android به یک نشانه احراز هویت نیاز دارد که از نقش «درایور» استفاده می‌کند و باید دارای vehicle_id باشد.

مثال

مثال کد زیر نحوه فعال کردن ردیابی موقعیت مکانی را نشان می دهد.

جاوا

RidesharingVehicleReporter vehicleReporter = ...;

vehicleReporter.enableLocationTracking();

کاتلین

val vehicleReporter = ...

vehicleReporter.enableLocationTracking()

سریع

vehicleReporter.locationTrackingEnabled = true

هدف-C

_vehicleReporter.locationTrackingEnabled = YES;

مرحله 3. وضعیت خودرو را روی حالت آنلاین تنظیم کنید

شما یک وسیله نقلیه را با تنظیم وضعیت آن بر روی آنلاین به خدمت می آورید (یعنی آن را برای استفاده در دسترس قرار می دهید)، اما تا زمانی که ردیابی موقعیت مکانی را فعال نکرده باشید نمی توانید این کار را انجام دهید.

وضعیت خودرو را به صورت آنلاین برای Android و iOS به صورت زیر تنظیم می کنید:

• با متد Driver SDK for Android setVehicleState(VehicleState.ONLINE) تماس بگیرید.

• درایور SDK برای روش iOS vehicleReporter.update(.online) تماس بگیرید.

مثال

مثال کد زیر نحوه تنظیم وضعیت خودرو را بر روی ONLINE نشان می دهد.

جاوا

vehicleReporter.setVehicleState(VehicleState.ONLINE);

کاتلین

vehicleReporter.setVehicleState(VehicleState.ONLINE)

سریع

vehicleReporter.update(.online)

هدف-C

[_vehicleReporter updateVehicleState:GMTDVehicleStateOnline];

مرحله 4. یک سفر در Fleet Engine ایجاد کنید

برای ایجاد یک سفر پشت سر هم، یک شی Trip درست مانند یک سفر تک مقصد ایجاد می کنید.

سفر شیئی است که یک سفر را نشان می دهد که مجموعه نقاط مختصات جغرافیایی شامل مبدا، ایستگاه های بین راه و نقاط سقوط است. شما باید برای هر درخواست سفر یک شی Trip ایجاد کنید تا بتوان درخواست را با یک وسیله نقلیه مطابقت داد و سپس ردیابی کرد.

• با فراخوانی متد CreateTrip() با پیام درخواست CreateTripRequest یک سفر ایجاد کنید.

ارائه ویژگی های مورد نیاز

برای ایجاد یک سفر پشت سر هم، باید فیلدهای زیر را تهیه کنید:

parent

رشته ای که شامل شناسه ارائه دهنده است. این باید با شناسه پروژه Google Cloud Project که حاوی حساب‌های سرویس مورد استفاده برای فراخوانی Fleet Engine است، باشد.

trip_id

رشته‌ای که ایجاد می‌کنید، که به‌طور منحصربه‌فردی این سفر را مشخص می‌کند.

trip

شی Trip برای ایجاد.

فیلدهای زیر باید در شی Trip ارسال شده به CreateTripRequest تنظیم شوند:

trip_type

TripType.EXCLUSIVE

pickup_point

نقطه مبدا سفر

dropoff_point

نقطه خروج سفر این فیلد در ایجاد سفر مورد نیاز نیست و می‌تواند بعداً با تماس UpdateTrip تنظیم شود.

توجه: استفاده از CreateTrip() به اعتبار حساب ممتاز ذکر شده در Fleet Engine: Initial setup نیاز دارد.

مثال

نمونه ادغام باطن زیر نحوه ایجاد یک سفر و اختصاص آن به یک وسیله نقلیه را نشان می دهد.

// A vehicle with ID 'my-vehicle' is already created and it is assigned to a trip with ID 'current-trip'.

static final String PROJECT_ID = "my-rideshare-co-gcp-project";
static final String VEHICLE_ID =" my-vehicle";
static final String TRIP_ID = "back-to-back-trip");

TripServiceBlockingStub tripService = TripService.newBlockingStub(channel);

String parent = "providers/" + PROJECT_ID;

Trip trip = Trip.newBuilder()
    .setTripType(TripType.EXCLUSIVE)
    .setPickupPoint(
        TerminalLocation.newBuilder().setPoint(
            LatLng.newBuilder()
                .setLatitude(-6.195139).setLongitude(106.820826)))
    .setDropoffPoint(
        TerminalLocation.newBuilder().setPoint(
            LatLng.newBuilder()
                .setLatitude(-6.1275).setLongitude(106.6537)))
    .setVehicleId(VEHICLE_ID)
    .build();

// Create trip request
CreateTripRequest createTripRequest = CreateTripRequest.newBuilder()
    .setParent(parent)
    .setTripId(TRIP_ID)
    .setTrip(trip)
    .build();

// Error handling.
try {
  // Fleet Engine automatically assigns a 'waypoints' list to the trip containing
  // the vehicle's current trip waypoints.
  Trip createdTrip =
      tripService.createTrip(createTripRequest);
} catch (StatusRuntimeException e) {
  Status s = e.getStatus();
  switch (s.getCode()) {
    case ALREADY_EXISTS:
      break;
    case PERMISSION_DENIED:
      break;
  }
  return;
}

مرحله 5. سفر را با شناسه وسیله نقلیه و ایستگاه های بین راهی به روز کنید

شما باید سفر را با شناسه وسیله نقلیه پیکربندی کنید تا Fleet Engine بتواند وسیله نقلیه را در مسیر خود ردیابی کند. برای پشت سر هم، یک سفر به یک وسیله نقلیه اختصاص داده می شود، حتی اگر قبلاً به آن اختصاص داده شده باشد.

توجه: اگر ادغام باطن شما SearchVehicles را فراخوانی می‌کند، باید فیلد «includeBackToBack» SearchVehiclesRequest را true تنظیم کنید تا اگر وسایل نقلیه قبلاً به سفری اختصاص داده شده باشند، بازگردانده شوند.

• می‌توانید سفر را با شناسه وسیله نقلیه با تماس با نقطه پایانی UpdateTrip با UpdateTripRequest به‌روزرسانی کنید. از قسمت update_mask برای مشخص کردن اینکه در حال به روز رسانی شناسه خودرو هستید استفاده کنید.

پس از اینکه سفر را به وسیله نقلیه اختصاص دادید، Fleet Engine به طور خودکار نقاط بین مسیرهای مرتبط با سفرهای پشت سر هم را به قسمت ایستگاه های بین راهی خودرو اضافه می کند. قسمت remainingWaypoints یک سفر حاوی فهرستی از تمام نقاط بین راهی، از جمله نقاطی از سفرهای همزمان، است که قبل از پایان سفر از آنها بازدید می شود.

برای مثال، دو سفر پشت سر هم در نظر بگیرید: سفر A و سفر B. این وسیله نقلیه مصرف کننده را برای سفر A دریافت کرده است، و در حالی که در مسیر به سمت محل تخلیه است، راننده درخواستی دریافت می کند که مصرف کننده دیگری را برای سفر بعدی ( سفر B ) دریافت کند.

• فراخوانی getVehicle() لیستی از نقاط بین باقیمانده ( remainingWaypoints ) را برمی گرداند که حاوی
  A _Drop-off → B _Pickup → B _Drop-off .
• هر دو getTrip() یا onTripRemainingWaypointsUpdated برای سفر A لیستی از نقاط بین باقیمانده ( remainingWaypoints ) را برمی گرداند که حاوی A _Drop-off است.
• یا getTrip() یا onTripRemainingWaypointsUpdated callback برای سفر B لیستی از نقاط بین باقیمانده ( remainingWaypoints ) را برمی گرداند که حاوی A _Drop-off → B _Pickup → و B _Drop-off است.

مرحله 6. به به روز رسانی سفر در برنامه مصرف کننده گوش دهید

• برای اندروید، می‌توانید با دریافت یک شی TripModel از TripModelManager و ثبت یک شنونده TripModelCallback ، به به‌روزرسانی‌های داده از سفر گوش دهید.

• برای iOS، می‌توانید با دریافت یک شی GMTCTripModel از GMTCTripService و ثبت نام مشترک GMTCTripModelSubscriber ، به به‌روزرسانی‌های داده از سفر گوش دهید.

یک شنونده TripModelCallback و مشترک GMTCTripModelSubscriber به برنامه شما اجازه می‌دهد تا به‌روزرسانی‌های دوره‌ای پیشرفت سفر را در هر بازخوانی بر اساس فاصله بازخوانی خودکار دریافت کند. فقط مقادیری که تغییر می‌کنند می‌توانند پاسخ تماس را راه‌اندازی کنند. در غیر این صورت، پاسخ به تماس بی‌صدا می‌ماند.

متدهای TripModelCallback.onTripUpdated() و tripModel(_:didUpdate:updatedPropertyFields:) همیشه فراخوانی می شوند، صرف نظر از هرگونه تغییر داده.

مثال 1

نمونه کد زیر نحوه دریافت TripModel از TripModelManager / GMTCTripService و تنظیم شنونده بر روی آن را نشان می دهد.

جاوا

// Start journey sharing after a trip has been created via Fleet Engine.
TripModelManager tripModelManager = consumerApi.getTripModelManager();

// Get a TripModel object.
TripModel tripModel = tripModelManager.getTripModel(tripName);

// Register a listener on the trip.
TripModelCallback tripCallback = new TripModelCallback() {
  ...
};
tripModel.registerTripCallback(tripCallback);

// Set the refresh interval.
TripModelOptions tripModelOptions = TripModelOptions.builder()
    .setRefreshInterval(5000) // interval in milliseconds, so 5 seconds
    .build();
tripModel.setTripModelOptions(tripModelOptions);

// The trip stops auto-refreshing when all listeners are unregistered.
tripModel.unregisterTripCallback(tripCallback);

کاتلین

// Start journey sharing after a trip has been created via Fleet Engine.
val tripModelManager = consumerApi.getTripModelManager()

// Get a TripModel object.
val tripModel = tripModelManager.getTripModel(tripName)

// Register a listener on the trip.
val tripCallback = TripModelCallback() {
  ...
}

tripModel.registerTripCallback(tripCallback)

// Set the refresh interval.
val tripModelOptions =
  TripModelOptions.builder()
    .setRefreshInterval(5000) // interval in milliseconds, so 5 seconds
    .build()

tripModel.setTripModelOptions(tripModelOptions)

// The trip stops auto-refreshing when all listeners are unregistered.
tripModel.unregisterTripCallback(tripCallback)

سریع

let tripService = GMTCServices.shared().tripService

// Create a tripModel instance for listening for updates from the trip
// specified by the trip name.
let tripModel = tripService.tripModel(forTripName: tripName)

// Register for the trip update events.
tripModel.register(self)

// Set the refresh interval (in seconds).
tripModel.options.autoRefreshTimeInterval = 5

// Unregister for the trip update events.
tripModel.unregisterSubscriber(self)

هدف-C

GMTCTripService *tripService = [GMTCServices sharedServices].tripService;

// Create a tripModel instance for listening for updates from the trip
// specified by the trip name.
GMTCTripModel *tripModel = [tripService tripModelForTripName:tripName];

// Register for the trip update events.
[tripModel registerSubscriber:self];

// Set the refresh interval (in seconds).
tripModel.options.autoRefreshTimeInterval = 5;

// Unregister for the trip update events.
[tripModel unregisterSubscriber:self];

مثال 2

نمونه کد زیر نحوه تنظیم یک شنونده TripModelCallback و مشترک GMTCTripModelSubscriber را نشان می دهد.

جاوا

// Implements a callback for the trip model so your app can listen for trip
// updates from Fleet Engine.
TripModelCallback subscriber =
  new TripModelCallback() {

    @Override
    public void onTripStatusUpdated(TripInfo tripInfo, @TripStatus int status) {
      // ...
    }

    @Override
    public void onTripActiveRouteUpdated(TripInfo tripInfo, List<LatLng> route) {
      // ...
    }

    @Override
    public void onTripVehicleLocationUpdated(
        TripInfo tripInfo, @Nullable VehicleLocation vehicleLocation) {
      // ...
    }

    @Override
    public void onTripPickupLocationUpdated(
        TripInfo tripInfo, @Nullable TerminalLocation pickup) {
      // ...
    }

    @Override
    public void onTripPickupTimeUpdated(TripInfo tripInfo, @Nullable Long timestampMillis) {
      // ...
    }

    @Override
    public void onTripDropoffLocationUpdated(
        TripInfo tripInfo, @Nullable TerminalLocation dropoff) {
      // ...
    }

    @Override
    public void onTripDropoffTimeUpdated(TripInfo tripInfo, @Nullable Long timestampMillis) {
      // ...
    }

    @Override
    public void onTripETAToNextWaypointUpdated(
        TripInfo tripInfo, @Nullable Long timestampMillis) {
      // ...
    }

    @Override
    public void onTripActiveRouteRemainingDistanceUpdated(
        TripInfo tripInfo, @Nullable Integer distanceMeters) {
      // ...
    }

    @Override
    public void onTripUpdateError(TripInfo tripInfo, TripUpdateError error) {
      // ...
    }

    @Override
    public void onTripUpdated(TripInfo tripInfo) {
      // ...
    }

    @Override
    public void onTripRemainingWaypointsUpdated(
        TripInfo tripInfo, List<TripWaypoint> waypointList) {
      // ...
    }

    @Override
    public void onTripIntermediateDestinationsUpdated(
        TripInfo tripInfo, List<TerminalLocation> intermediateDestinations) {
      // ...
    }

    @Override
    public void onTripRemainingRouteDistanceUpdated(
        TripInfo tripInfo, @Nullable Integer distanceMeters) {
      // ...
    }

    @Override
    public void onTripRemainingRouteUpdated(TripInfo tripInfo, List<LatLng> route) {
      // ...
    }
  };

کاتلین

// Implements a callback for the trip model so your app can listen for trip
// updates from Fleet Engine.
val subscriber =
  object : TripModelCallback() {
    override fun onTripStatusUpdated(tripInfo: TripInfo, status: @TripStatus Int) {
      // ...
    }

    override fun onTripActiveRouteUpdated(tripInfo: TripInfo, route: List<LatLng>) {
      // ...
    }

    override fun onTripVehicleLocationUpdated(
      tripInfo: TripInfo,
      vehicleLocation: VehicleLocation?
    ) {
      // ...
    }

    override fun onTripPickupLocationUpdated(tripInfo: TripInfo, pickup: TerminalLocation?) {
      // ...
    }

    override fun onTripPickupTimeUpdated(tripInfo: TripInfo, timestampMillis: Long?) {
      // ...
    }

    override fun onTripDropoffLocationUpdated(tripInfo: TripInfo, dropoff: TerminalLocation?) {
      // ...
    }

    override fun onTripDropoffTimeUpdated(tripInfo: TripInfo, timestampMillis: Long?) {
      // ...
    }

    override fun onTripETAToNextWaypointUpdated(tripInfo: TripInfo, timestampMillis: Long?) {
      // ...
    }

    override fun onTripActiveRouteRemainingDistanceUpdated(
      tripInfo: TripInfo,
      distanceMeters: Int?
    ) {
      // ...
    }

    override fun onTripUpdateError(tripInfo: TripInfo, error: TripUpdateError) {
      // ...
    }

    override fun onTripUpdated(tripInfo: TripInfo) {
      // ...
    }

    override fun onTripRemainingWaypointsUpdated(
      tripInfo: TripInfo,
      waypointList: List<TripWaypoint>
    ) {
      // ...
    }

    override fun onTripIntermediateDestinationsUpdated(
      tripInfo: TripInfo,
      intermediateDestinations: List<TerminalLocation>
    ) {
      // ...
    }

    override fun onTripRemainingRouteDistanceUpdated(tripInfo: TripInfo, distanceMeters: Int?) {
      // ...
    }

    override fun onTripRemainingRouteUpdated(tripInfo: TripInfo, route: List<LatLng>) {
      // ...
    }
  }

سریع

class TripModelSubscriber: NSObject, GMTCTripModelSubscriber {

  func tripModel(_: GMTCTripModel, didUpdate trip: GMTSTrip?, updatedPropertyFields: GMTSTripPropertyFields) {
    // Update the UI with the new `trip` data.
    updateUI(with: trip)
    ...
  }

  func tripModel(_: GMTCTripModel, didUpdate tripStatus: GMTSTripStatus) {
    // Handle trip status did change.
  }

  func tripModel(_: GMTCTripModel, didUpdateActiveRoute activeRoute: [GMTSLatLng]?) {
    // Handle trip active route did update.
  }

  func tripModel(_: GMTCTripModel, didUpdate vehicleLocation: GMTSVehicleLocation?) {
    // Handle vehicle location did update.
  }

  func tripModel(_: GMTCTripModel, didUpdatePickupLocation pickupLocation: GMTSTerminalLocation?) {
    // Handle pickup location did update.
  }

  func tripModel(_: GMTCTripModel, didUpdateDropoffLocation dropoffLocation: GMTSTerminalLocation?) {
    // Handle drop off location did update.
  }

  func tripModel(_: GMTCTripModel, didUpdatePickupETA pickupETA: TimeInterval) {
    // Handle the pickup ETA did update.
  }

  func tripModel(_: GMTCTripModel, didUpdateDropoffETA dropoffETA: TimeInterval) {
    // Handle the drop off ETA did update.
  }

  func tripModel(_: GMTCTripModel, didUpdateRemaining remainingWaypoints: [GMTSTripWaypoint]?) {
    // Handle updates to the pickup, dropoff or intermediate destinations of the trip.
  }

  func tripModel(_: GMTCTripModel, didFailUpdateTripWithError error: Error?) {
    // Handle the error.
  }

  func tripModel(_: GMTCTripModel, didUpdateIntermediateDestinations intermediateDestinations: [GMTSTerminalLocation]?) {
    // Handle the intermediate destinations being updated.
  }

  ...
}

هدف-C

@interface TripModelSubscriber : NSObject <GMTCTripModelSubscriber>
@end

@implementation TripModelSubscriber

- (void)tripModel:(GMTCTripModel *)tripModel
            didUpdateTrip:(nullable GMTSTrip *)trip
    updatedPropertyFields:(GMTSTripPropertyFields)updatedPropertyFields {
  // Update the UI with the new `trip` data.
  [self updateUIWithTrip:trip];
  ...
}

- (void)tripModel:(GMTCTripModel *)tripModel didUpdateTripStatus:(enum GMTSTripStatus)tripStatus {
  // Handle trip status did change.
}

- (void)tripModel:(GMTCTripModel *)tripModel
    didUpdateActiveRoute:(nullable NSArray<GMTSLatLng *> *)activeRoute {
  // Handle trip route did update.
}

- (void)tripModel:(GMTCTripModel *)tripModel
    didUpdateVehicleLocation:(nullable GMTSVehicleLocation *)vehicleLocation {
  // Handle vehicle location did update.
}

- (void)tripModel:(GMTCTripModel *)tripModel
    didUpdatePickupLocation:(nullable GMTSTerminalLocation *)pickupLocation {
  // Handle pickup location did update.
}

- (void)tripModel:(GMTCTripModel *)tripModel
    didUpdateDropoffLocation:(nullable GMTSTerminalLocation *)dropoffLocation {
  // Handle drop off location did update.
}

- (void)tripModel:(GMTCTripModel *)tripModel didUpdatePickupETA:(NSTimeInterval)pickupETA {
  // Handle the pickup ETA did update.
}

- (void)tripModel:(GMTCTripModel *)tripModel
    didUpdateRemainingWaypoints:(nullable NSArray<GMTSTripWaypoint *> *)remainingWaypoints {
  // Handle updates to the pickup, dropoff or intermediate destinations of the trip.
}

- (void)tripModel:(GMTCTripModel *)tripModel didUpdateDropoffETA:(NSTimeInterval)dropoffETA {
  // Handle the drop off ETA did update.
}

- (void)tripModel:(GMTCTripModel *)tripModel didFailUpdateTripWithError:(nullable NSError *)error {
  // Handle the error.
}

- (void)tripModel:(GMTCTripModel *)tripModel
    didUpdateIntermediateDestinations:
        (nullable NSArray<GMTSTerminalLocation *> *)intermediateDestinations {
  // Handle the intermediate destinations being updated.
}
…
@end

شما می توانید در هر زمان به اطلاعات سفر به شرح زیر دسترسی داشته باشید:

• با متد Consumer SDK برای اندروید TripModel.getTripInfo() تماس بگیرید. فراخوانی این روش به اجبار به‌روزرسانی داده نمی‌شود، اگرچه داده‌ها همچنان در فرکانس تازه‌سازی به‌روزرسانی می‌شوند.

• Consumer SDK برای ویژگی iOS GMTCTripModel.currentTrip را دریافت کنید.

مرحله 7. نمایش سفر در برنامه مصرف کننده

به صورت زیر می توانید به API های عنصر رابط کاربری Rides and Deliveries دسترسی داشته باشید:

• شی Consumer SDK برای Android ConsumerController را دریافت کنید. برای اطلاعات بیشتر، به استفاده از APIهای عنصر رابط کاربری مراجعه کنید.

• شئ Consumer SDK برای iOS GMTCMapView را دریافت کنید. برای اطلاعات بیشتر، به استفاده از APIهای عنصر رابط کاربری مراجعه کنید.

مثال

مثال کد زیر نحوه شروع رابط کاربری اشتراک گذاری سفر را نشان می دهد.

جاوا

JourneySharingSession session = JourneySharingSession.createInstance(tripModel);
consumerController.showSession(session);

کاتلین

val session = JourneySharingSession.createInstance(tripModel)
consumerController.showSession(session)

سریع

let journeySharingSession = GMTCJourneySharingSession(tripModel: tripModel)
mapView.show(journeySharingSession)

هدف-C

GMTCJourneySharingSession *journeySharingSession =
    [[GMTCJourneySharingSession alloc] initWithTripModel:tripModel];
[self.mapView showMapViewSession:journeySharingSession];

سناریوی نمونه

یک سفر پشت سر هم را در نظر بگیرید که در آن وسیله نقلیه قبلاً مصرف کننده را برای اولین سفر گرفته است. هنگامی که راننده درخواستی برای تحویل گرفتن مصرف کننده دیگری پس از اتمام سفر فعلی دریافت می کند، وسیله نقلیه در مسیر حرکت به سمت نقطه تخلیه است.

در این مرحله از زمان، مصرف کننده برای اولین سفر موارد زیر را مشاهده می کند.

در همان مقطع زمانی، مصرف کننده برای سفر دوم موارد زیر را مشاهده می کند.

به طور پیش‌فرض، Consumer SDK فقط قسمت فعال مسیر را نشان می‌دهد، اما شما می‌توانید قسمت باقیمانده را که شامل مقصد می‌شود، نمایش دهید.

اگر می‌خواهید اطلاعاتی در مورد ایستگاه‌های بین سفرهای دیگر نمایش دهید، می‌توانید به تمام نقاط بین راهی مربوط به یک سفر به شرح زیر دسترسی داشته باشید:

• با متد Consumer SDK برای اندروید TripModel.getTripInfo() تماس بگیرید. سپس با TripInfo.getRemainingWaypoints() تماس بگیرید تا TripWaypoint s را دریافت کنید. هر شیء TripWaypoint شامل شناسه سفر، محل ایستگاه بین راهی و نوع ایستگاه بین راه است.

• Consumer SDK برای ویژگی iOS GMTCTripModel.currentTrip را دریافت کنید. سپس آرایه GMTSTrip.remainingWaypoints را برای دسترسی به GMTSTripWaypoint دریافت کنید. هر شیء GMTSTripWaypoint شامل شناسه سفر، محل ایستگاه بین راهی و نوع نقطه بین راه است.

مرحله 8. وضعیت سفر را در Fleet Engine مدیریت کنید

شما وضعیت یک سفر را با استفاده از یکی از مقادیر شمارش TripStatus مشخص می کنید. وقتی وضعیت سفر تغییر می کند (به عنوان مثال، تغییر از ENROUTE_TO_PICKUP به ARRIVED_AT_PICKUP )، باید وضعیت سفر را از طریق Fleet Engine به روز کنید. حالت سفر همیشه با مقدار NEW شروع می شود و با مقدار COMPLETE یا CANCELED به پایان می رسد. برای اطلاعات بیشتر، trip_status ببینید.

مثال

نمونه ادغام باطن زیر نحوه به روز رسانی حالت سفر در Fleet Engine را نشان می دهد.

static final String PROJECT_ID = "my-rideshare-co-gcp-project";
static final String TRIP_ID = "trip-8241890";

String tripName = "providers/" + PROJECT_ID + "/trips/" + TRIP_ID;

TripServiceBlockingStub tripService = TripService.newBlockingStub(channel);

// Trip settings to be updated.
Trip trip = Trip.newBuilder()
    .setTripStatus(TripStatus.ARRIVED_AT_PICKUP)
    .build();

// Trip update request
UpdateTripRequest updateTripRequest = UpdateTripRequest.newBuilder()
    .setName(tripName)
    .setTrip(trip)
    .setUpdateMask(FieldMask.newBuilder().addPaths("trip_status"))
    .build();

// Error handling.
try {
  Trip updatedTrip = tripService.updateTrip(updateTripRequest);
} catch (StatusRuntimeException e) {
  Status s = e.getStatus();
  switch (s.getCode()) {
    case NOT_FOUND:            // The trip doesn't exist.
      break;
    case FAILED_PRECONDITION:  // The given trip status is invalid.
      break;
    case PERMISSION_DENIED:
      break;
  }
  return;
}