การเดินทางหลายจุดหมายเป็นการเดินทางสุดพิเศษซึ่งผู้บริโภคจองเวลาพร้อมกับคนขับซึ่งอาจจะจอดแวะอย่างน้อย 1 จุดก่อนจะไปถึงจุดหมายที่ผู้บริโภคขอในตอนแรก
ความแตกต่างที่สำคัญระหว่างการเดินทางหลายจุดหมายและเที่ยวเดียวคือ ในกรณีการเดินทางหลายจุดหมาย ผู้ดำเนินการอาจจะหยุดหรือหยุดพักระหว่างต้นทางกับจุดส่งได้อย่างน้อย 1 ครั้ง
บทแนะนำนี้จะแนะนำกระบวนการสร้างการเดินทางหลายจุดหมายให้คุณ นอกจากนี้ยังแสดงวิธีการที่คุณสามารถผสานรวมการเดินทางนั้นเข้ากับแอปพลิเคชันของผู้บริโภคเพื่อให้ลูกค้าเห็นภาพความคืบหน้าของการเดินทางจากโทรศัพท์ของตน คุณผสานรวมนี้โดยใช้ ConsumerSDK
ข้อกำหนดเบื้องต้น
หากต้องการทำให้บทแนะนำนี้จบลง คุณต้องดำเนินการต่อไปนี้
ตั้งค่า Fleet Engine ดูข้อมูลเพิ่มเติมได้ที่ Fleet Engine: การตั้งค่าเริ่มต้น
ผสานรวมแอปกับ SDK ไดรเวอร์ ดูข้อมูลเพิ่มเติมได้ที่การเริ่มต้น SDK ของไดรเวอร์สำหรับ Android และคู่มือการผสานรวมสำหรับ SDK ของไดรเวอร์สำหรับ iOS
ผสานรวมแอปที่แสดงต่อผู้ใช้เข้ากับ SDK สำหรับผู้บริโภค ดูข้อมูลเพิ่มเติมได้ที่การเริ่มต้นใช้งาน SDK สำหรับผู้บริโภคสำหรับ Android และการเริ่มต้นใช้งาน SDK สำหรับผู้บริโภคสำหรับ iOS
ตั้งค่าโทเค็นการให้สิทธิ์ ดูข้อมูลเพิ่มเติมเกี่ยวกับโทเค็นการให้สิทธิ์ได้ที่การสร้าง JSON Web Token สำหรับการให้สิทธิ์ในคู่มือเริ่มต้นใช้งาน Fleet Engine และการตรวจสอบสิทธิ์และการให้สิทธิ์ในเอกสาร Consumer SDK สำหรับ Fleet Engine
ขั้นตอนที่ 1 สร้างยานพาหนะใน Fleet Engine
ยานพาหนะคือวัตถุที่แสดงถึงยานพาหนะในยานพาหนะของคุณ คุณต้องสร้างการดำเนินการใน Fleet Engine เพื่อติดตามผู้ใช้ในแอปสำหรับผู้บริโภค
คุณสามารถสร้างยานพาหนะโดยใช้วิธีใดวิธีหนึ่งต่อไปนี้
- gRPC
- เรียกใช้เมธอด
CreateVehicle()
ด้วยข้อความคำขอCreateVehicleRequest
คุณต้องมีสิทธิ์ของผู้ใช้ Fleet Engine ระดับสูงเพื่อโทรหาCreateVehicle()
- REST
- โทร
https://fleetengine.googleapis.com/v1/providers.vehicles.create
คำเตือน
ข้อควรระวังต่อไปนี้จะปรากฏเมื่อคุณสร้างยานพาหนะ
อย่าลืมตั้งค่าสถานะเริ่มต้นของรถเป็น
OFFLINE
วิธีนี้ช่วยให้ Fleet Engine ค้นพบรถของคุณเพื่อจับคู่การเดินทางได้provider_id
ของยานพาหนะต้องตรงกับรหัสโปรเจ็กต์ของโปรเจ็กต์ Google Cloud ที่มีบัญชีบริการซึ่งใช้สำหรับการเรียกใช้ Fleet Engine แม้ว่าบัญชีบริการหลายบัญชีจะเข้าถึง Fleet Engine ของผู้ให้บริการบริการร่วมเดินทางรายเดียวกันได้ แต่ขณะนี้ Fleet Engine ยังไม่รองรับบัญชีบริการจากโปรเจ็กต์ Google Cloud ต่างๆ ที่เข้าถึงรถคันเดียวกันการตอบกลับที่แสดงผลจาก
CreateVehicle()
มีอินสแตนซ์Vehicle
ระบบจะลบอินสแตนซ์หลังจากผ่านไป 7 วันหากไม่มีการอัปเดตโดยใช้UpdateVehicle()
คุณควรโทรหาGetVehicle()
ก่อนโทรหาCreateVehicle()
เพื่อยืนยันว่าไม่มีรถอยู่แล้ว หาก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;
}
ขั้นตอนที่ 2 เปิดใช้การติดตามตำแหน่ง
การติดตามตำแหน่งหมายถึงการติดตามตำแหน่งของรถในระหว่างการเดินทาง ซึ่งแอปคนขับจะส่งการวัดและส่งข้อมูลทางไกลไปยัง Fleet Engine ซึ่งมีตำแหน่งปัจจุบันของยานพาหนะ ระบบใช้สตรีมข้อมูลตำแหน่งที่อัปเดตอยู่ตลอดเวลา เพื่อถ่ายทอดความคืบหน้าของรถตลอดเส้นทางการเดินทาง เมื่อเปิดใช้การติดตามตำแหน่ง แอปคนขับจะเริ่มส่งการวัดและส่งข้อมูลทางไกลนี้ที่ความถี่เริ่มต้น 1 ครั้งทุก 5 วินาที
คุณเปิดใช้การติดตามตำแหน่งสำหรับ Android และ iOS โดยทำดังนี้
เรียกใช้ Driver SDK สำหรับเมธอด Android
enableLocationTracking()
ตั้งค่า Driver SDK สำหรับพร็อพเพอร์ตี้บูลีนของ iOS
locationTrackingEnabled
เป็นtrue
ตัวอย่าง
ตัวอย่างโค้ดต่อไปนี้แสดงวิธีเปิดใช้การติดตามตําแหน่ง
Java
RidesharingVehicleReporter vehicleReporter = ...;
vehicleReporter.enableLocationTracking();
Kotlin
val vehicleReporter = ...
vehicleReporter.enableLocationTracking()
Swift
vehicleReporter.locationTrackingEnabled = true
Objective-C
_vehicleReporter.locationTrackingEnabled = YES;
ขั้นตอนที่ 3 ตั้งค่าสถานะของรถให้ออนไลน์
คุณนำยานพาหนะมารับบริการ (กล่าวคือ เพื่อให้สามารถใช้งาน) ได้โดยตั้งค่าสถานะของรถเป็นออนไลน์ แต่คุณไม่สามารถทำเช่นนั้นได้จนกว่าคุณจะเปิดใช้การติดตามตำแหน่ง
คุณตั้งค่าสถานะของรถให้ออนไลน์สําหรับ Android และ iOS ดังนี้
เรียกใช้ Driver SDK สำหรับเมธอด Android
setVehicleState(VehicleState.ONLINE)
เรียกใช้ Driver SDK สำหรับเมธอด iOS
vehicleReporter.update(.online)
ตัวอย่าง
ตัวอย่างโค้ดต่อไปนี้แสดงวิธีตั้งสถานะของรถเป็น ONLINE
Java
vehicleReporter.setVehicleState(VehicleState.ONLINE);
Kotlin
vehicleReporter.setVehicleState(VehicleState.ONLINE)
Swift
vehicleReporter.update(.online)
Objective-C
[_vehicleReporter updateVehicleState:GMTDVehicleStateOnline];
ขั้นตอนที่ 4 สร้างการเดินทางใน Fleet Engine
หากต้องการสร้างการเดินทางหลายจุดหมาย คุณต้องสร้างออบเจ็กต์ Trip
เหมือนกับที่สร้างสำหรับปลายทางเดียว
การเดินทางคือวัตถุที่แสดงถึงการเดินทาง ซึ่งเป็นจุดพิกัดทางภูมิศาสตร์ของคอลเล็กชัน รวมถึงต้นทาง จุดอ้างอิง และจุดออกจาก
คุณต้องสร้างออบเจ็กต์ Trip
1 รายการสำหรับคำขอการเดินทางแต่ละรายการ เพื่อให้จับคู่คำขอกับยานพาหนะและติดตามได้
- คุณสร้างการเดินทางได้โดยเรียกใช้เมธอด
CreateTrip()
พร้อมข้อความคำขอCreateTripRequest
ระบุแอตทริบิวต์ที่จำเป็น
ต้องระบุฟิลด์ต่อไปนี้เพื่อสร้างการเดินทางหลายจุดหมาย
parent
- สตริงที่มีรหัสผู้ให้บริการ ซึ่งต้องเหมือนกับรหัสโปรเจ็กต์ของโปรเจ็กต์ Google Cloud ที่มีบัญชีบริการซึ่งใช้สำหรับการเรียกใช้ Fleet Engine
trip_id
- สตริงที่คุณสร้างซึ่งระบุการเดินทางนี้แบบไม่ซ้ำ
trip
- ออบเจ็กต์ "Trip" ที่จะสร้าง
คุณต้องตั้งค่าฟิลด์ต่อไปนี้ในออบเจ็กต์ Trip
ที่ส่งผ่านไปยัง CreateTripRequest
trip_type
TripType.EXCLUSIVE
pickup_point
- จุดเริ่มต้นของการเดินทาง
dropoff_point
- จุดส่งของการเดินทาง คุณไม่จำเป็นต้องกรอกข้อมูลในช่องนี้ในระหว่างการสร้างการเดินทาง และจะตั้งค่าในภายหลังได้โดยเรียกใช้ "UpdateTrip"
intermediate_destinations
- รายการปลายทางระดับกลางที่คนขับจะเข้าชมในระหว่างการรับและส่ง การสร้างการเดินทางไม่จำเป็นต้องมีช่องนี้เหมือนกับการออก และตั้งค่าได้โดยเรียก "UpdateTrip"
ตัวอย่าง
ตัวอย่างการผสานรวมแบ็กเอนด์ต่อไปนี้จะแสดงวิธีสร้างการเดินทางไปยังหลายจุดหมายสุดพิเศษที่มีจุดรับสินค้า จุดส่ง และจุดหมายกลาง 1 แห่ง
static final String PROJECT_ID = "my-rideshare-co-gcp-project";
static final String TRIP_ID = "multi-destination-trip-A";
TripServiceBlockingStub tripService = TripService.newBlockingStub(channel);
// Trip initial settings.
String parent = "providers/" + PROJECT_ID;
Trip trip = Trip.newBuilder()
.setTripType(TripType.EXCLUSIVE)
.setPickupPoint(
TerminalLocation.newBuilder().setPoint(
LatLng.newBuilder()
.setLatitude(-6.195139).setLongitude(106.820826)))
.setNumberOfPassengers(1)
.setDropoffPoint(
TerminalLocation.newBuilder().setPoint(
LatLng.newBuilder()
.setLatitude(-6.1275).setLongitude(106.6537)))
// Add the list of intermediate destinations.
.addAllIntermediateDestinations(
ImmutableList.of(
TerminalLocation.newBuilder().setPoint(
LatLng.newBuilder()
.setLatitude(-6.195139).setLongitude(106.820826)).build()))
.build();
// Create the Trip request.
CreateTripRequest createTripRequest = CreateTripRequest.newBuilder()
.setParent(parent)
.setTripId(TRIP_ID) // Trip ID assigned by the Provider server.
.setTrip(trip) // Initial state is NEW.
.build();
// Error handling.
try {
Trip createdTrip =
tripService.createTrip(createTripRequest);
} catch (StatusRuntimeException e) {
Status s = e.getStatus();
switch (s.getCode()) {
case ALREADY_EXISTS: // Trip already exists.
break;
case PERMISSION_DENIED:
break;
}
return;
}
ขั้นตอนที่ 5 อัปเดตการเดินทางโดยใช้รหัสรถและจุดอ้างอิง
คุณต้องกำหนดค่าการเดินทางด้วยรหัสรถเพื่อให้ Fleet Engine ติดตามรถตลอดเส้นทางได้
- คุณอัปเดตการเดินทางด้วยรหัสรถยนต์ได้โดยโทรหาปลายทาง
UpdateTrip
ด้วยUpdateTripRequest
ใช้ช่องupdate_mask
เพื่อระบุว่าคุณกำลังอัปเดตรหัสยานพาหนะ
Notes
หากคุณไม่ได้ระบุปลายทางหรือปลายทางระดับกลางเมื่อสร้างการเดินทาง คุณจะระบุปลายทางได้เสมอ
หากจำเป็นต้องเปลี่ยนยานพาหนะระหว่างการเดินทาง คุณจะต้องตั้งค่าสถานะการเดินทางกลับไปเป็นการเดินทางใหม่ จากนั้นอัปเดตการเดินทาง (อย่างที่ทำด้านบน) ด้วยรหัสยานพาหนะใหม่
ตัวอย่าง
ตัวอย่างการผสานรวมแบ็กเอนด์ต่อไปนี้แสดงวิธีอัปเดตการเดินทางเพื่อเพิ่มรายการปลายทางระดับกลางและตั้งค่ารหัสยานพาหนะ
static final String PROJECT_ID = "my-rideshare-co-gcp-project";
static final String TRIP_ID = "multi-destination-trip-A";
String tripName = "providers/" + PROJECT_ID + "/trips/" + TRIP_ID;
TripServiceBlockingStub tripService = TripService.newBlockingStub(channel);
// The trip settings to be updated.
Trip trip = Trip.newBuilder()
// Add the list of intermediate destinations.
.addAllIntermediateDestinations(
ImmutableList.of(
TerminalLocation.newBuilder().setPoint(
LatLng.newBuilder()
.setLatitude(-6.195139).setLongitude(106.820826)).build()))
.setVehicleId("8241890")
.build();
// The trip update request.
UpdateTripRequest updateTripRequest = UpdateTripRequest.newBuilder()
.setName(tripName)
.setTrip(trip)
.setUpdateMask(
FieldMask.newBuilder()
.addPaths("intermediate_destinations")
.addPaths("vehicle_id")
.build())
.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 PERMISSION_DENIED:
break;
}
return;
}
ขั้นตอนที่ 6 ฟังอัปเดตการเดินทางในแอปผู้บริโภค
สำหรับ Android คุณฟังการอัปเดตข้อมูลจากการเดินทางได้โดยรับออบเจ็กต์
TripModel
จากTripModelManager
และลงทะเบียน ListenerTripModelCallback
สำหรับ iOS คุณฟังข้อมูลอัปเดตจากการเดินทางได้โดยรับออบเจ็กต์
GMTCTripModel
จากGMTCTripService
และลงทะเบียนสมาชิกGMTCTripModelSubscriber
Listener TripModelCallback
และผู้สมัครใช้บริการ GMTCTripModelSubscriber
อนุญาตให้แอปของคุณได้รับการอัปเดตความคืบหน้าของการเดินทางเป็นระยะๆ ในการรีเฟรชแต่ละครั้งโดยอิงตามช่วงเวลาการรีเฟรชอัตโนมัติ
มีเพียงค่าที่เปลี่ยนแปลงเท่านั้นที่จะทริกเกอร์การเรียกกลับได้ ไม่เช่นนั้นโค้ดเรียกกลับ
จะยังคงปิดเสียงอยู่
ระบบจะเรียกใช้เมธอด TripModelCallback.onTripUpdated()
และ tripModel(_:didUpdate:updatedPropertyFields:)
เสมอ ไม่ว่าข้อมูลจะมีการเปลี่ยนแปลงหรือไม่ก็ตาม
ตัวอย่างที่ 1
ตัวอย่างโค้ดต่อไปนี้แสดงวิธีรับ TripModel
จาก TripModelManager
/GMTCTripService
และตั้งค่า Listener
Java
// 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);
Kotlin
// 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)
Swift
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)
Objective-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
Java
// 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) {
// ...
}
};
Kotlin
// 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>) {
// ...
}
}
Swift
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.
}
...
}
Objective-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 สำหรับเมธอด Android
TripModel.getTripInfo()
การเรียกใช้วิธีการนี้ไม่บังคับให้รีเฟรชข้อมูล แม้ว่าข้อมูลจะยังคงรีเฟรชตามความถี่ในการรีเฟรชดาวน์โหลดพร็อพเพอร์ตี้ Consumer SDK สำหรับ iOS
GMTCTripModel.currentTrip
ขั้นตอนที่ 7 แสดงเส้นทางในแอปผู้บริโภค
คุณสามารถเข้าถึง API องค์ประกอบอินเทอร์เฟซผู้ใช้ของผู้ใช้การโดยสารและการนำส่ง ดังนี้
ดาวน์โหลดออบเจ็กต์
ConsumerController
สำหรับ Consumer SDK สำหรับ Android ดูข้อมูลเพิ่มเติมได้ที่การใช้ API องค์ประกอบอินเทอร์เฟซผู้ใช้ดาวน์โหลดออบเจ็กต์
GMTCMapView
สำหรับ Consumer SDK สำหรับ iOS ดูข้อมูลเพิ่มเติมได้ที่การใช้ API องค์ประกอบอินเทอร์เฟซผู้ใช้
ตัวอย่าง
ตัวอย่างโค้ดต่อไปนี้แสดงวิธีเริ่มอินเทอร์เฟซผู้ใช้ของการแชร์เส้นทาง
Java
JourneySharingSession session = JourneySharingSession.createInstance(tripModel);
consumerController.showSession(session);
Kotlin
val session = JourneySharingSession.createInstance(tripModel)
consumerController.showSession(session)
Swift
let journeySharingSession = GMTCJourneySharingSession(tripModel: tripModel)
mapView.show(journeySharingSession)
Objective-C
GMTCJourneySharingSession *journeySharingSession =
[[GMTCJourneySharingSession alloc] initWithTripModel:tripModel];
[self.mapView showMapViewSession:journeySharingSession];
โดยค่าเริ่มต้น Consumer SDK จะแสดงเฉพาะจุดที่ใช้งานอยู่ในเส้นทาง แต่คุณมีตัวเลือกในการแสดงช่วงที่เหลือ ซึ่งรวมถึงปลายทางระดับกลางและการออกจากเส้นทาง
ถ้าต้องการแสดงข้อมูลเกี่ยวกับจุดอ้างอิงจากการเดินทางอื่นๆ คุณสามารถเข้าถึงจุดอ้างอิงทั้งหมดที่เกี่ยวข้องกับการเดินทางนั้น ดังนี้
เรียกใช้ Consumer SDK สำหรับเมธอด Android
TripModel.getTripInfo()
จากนั้นโทรหาTripInfo.getRemainingWaypoints()
เพื่อรับTripWaypoint
ออบเจ็กต์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
สำหรับการเดินทางหลายจุดหมาย นอกเหนือจากการอัปเดตสถานะการเดินทางตามการเดินทางปลายทางเดียวแล้ว คุณต้องอัปเดต intermediateDestinationIndex
และระบุ intermediateDestinationsVersion
ในคำขออัปเดตทุกครั้งที่ไปถึงปลายทางระดับกลางด้วย คุณต้องใช้สถานะต่อไปนี้จากการแจงนับ TripStatus
ENROUTE_TO_PICKUP
ARRIVED_AT_PICKUP
ENROUTE_TO_INTERMEDIATE_DESTINATION
ARRIVED_AT_INTERMEDIATE_DESTINATION
ENROUTE_TO_DROPOFF
COMPLETE
ตัวอย่าง
ตัวอย่างการผสานรวมแบ็กเอนด์ต่อไปนี้จะแสดงวิธีสร้างการเดินทางหลายจุดหมายที่ผ่านจุดรับสินค้าแล้ว และขณะนี้อยู่ระหว่างเส้นทางไปยังปลายทางระดับกลางแห่งแรก
static final String PROJECT_ID = "my-rideshare-co-gcp-project";
static final String TRIP_ID = "multi-destination-trip-A";
String tripName = "providers/" + PROJECT_ID + "/trips/" + TRIP_ID;
// Get the trip object from either the Fleet Engine or storage.
Trip trip = …;
TripServiceBlockingStub tripService = TripService.newBlockingStub(channel);
// The trip settings to be updated.
Trip trip = Trip.newBuilder()
// Trip status cannot return to a previous state once it has passed.
.setTripStatus(TripStatus.ENROUTE_TO_INTERMEDIATE_DESTINATION)
// Enroute to the first intermediate destination.
.setIntermediateDestinationIndex(0)
// You must provide an intermediate_destinations_version to ensure that you
// have the same intermediate destinations list as the Fleet Engine.
.setIntermediateDestinationsVersion(
trip.getIntermediateDestinationsVersion())
.build();
// The trip update request.
UpdateTripRequest updateTripRequest = UpdateTripRequest.newBuilder()
.setName(tripName)
.setTrip(trip)
.setUpdateMask(
FieldMask.newBuilder()
.addPaths("trip_status")
.addPaths("intermediate_destination_index")
// intermediate_destinations_version must not be in the update mask.
.build())
.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: // Either the trip status is invalid, or the
// intermediate_destinations_version doesn't
// match the Fleet Engine’s.
break;
case PERMISSION_DENIED:
break;
}
return;
}