דף זה תורגם על ידי Cloud Translation API.

אחזור נתוני נסיעה ישירות מ-Flet Engine

במדריך הזה מוסבר איך לאחזר נתוני נסיעות ישירות מ-Fleet Engine, כחלופה לשימוש ב-Consumer SDK. הגישה הזו מאפשרת לכם לשלוט טוב יותר בחוויית המשתמש שלכם, ועדיין ליהנות מהמיקום המדויק של הרכב בזמן אמת, מזמן ההגעה המשוער ומנתיבי הנסיעה של Fleet Engine.

פרטים על השימוש ב-Consumer SDK מופיעים במאמר שיתוף מסלולי נסיעה לנסיעות על פי דרישה.

אחזור פרטי הנסיעה

כדי לאחזר פרטי נסיעה ישירות מ-Fleet Engine, צריך להפעיל את השיטה GetTrip ולציין את התצוגה JOURNEY_SHARING_V1S. אפשר לעיין במאמרים העזרה של RPC או של REST.

בדרך כלל, השרת יבדוק את סטטוס כל נסיעה בשירות הנסיעות בזמן שהנוסע עוקב באופן פעיל אחרי התקדמות הרכב. בדרך כלל, עדכוני המיקום של הרכב מתבצעים כל 10 שניות, והמערכת אמורה לבצע סקרים באותו קצב. אפשר לעקוב אחרי השדה Trip.last_location.update_time כדי לראות אם בוצעו עדכונים מאז הקריאה הקודמת ל-GetTrip.

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

String tripName = "providers/" + PROJECT_ID + "/trips/" + TRIP_ID;
GetTripRequest getTripRequest =
    GetTripRequest.newBuilder()
        .setName(tripName)
        .setView(JOURNEY_SHARING_V1S)
        .build();
Trip trip = tripService.getTrip(getTripRequest);

השדות הבאים של אובייקט Trip שנוצר מאוכלסים במידע העדכני ביותר על הנסיעה:

`name`	`trip_status`	`remaining_waypoints`
`vehicle_id`	`trip_type`	`last_location`
`number_of_passengers`	`pickup_point`	`view (== JOURNEY_SHARING_V1S)`
`actual_pickup_point`	`intermediate_destinations`	`intermediate_destination_index`
`pickup_time`	`intermediate_destinations_version`	`dropoff_point`
`actual_dropoff_point`	`dropoff_time`

אחזור של נקודות הדרך הנותרות בנסיעה

הישות Trip מכילה שדה חוזר מסוג TripWaypoint. השדה הזה כולל את כל נקודות העצירה שהרכב יצטרך לעבור בהן, לפי הסדר, לפני נקודת ההורדה הסופית של הנסיעה. ציון התצוגה 'שיתוף המסלול' מורה ל-Fleet Engine להוסיף מידע מעודכן ל-remaining_waypoints[0]‏ TripWaypoint. בתצוגות אחרות, שאינן 'שיתוף המסלול', נקודת הציון הזו בדרך בדרך כלל לא משקפת את המיקום העדכני ביותר של הרכב שהוקצה. אפשר לעיין במאמרים העזרה של RPC או REST.

מידע נוסף זמין בקטע סטטוס הנסיעה ונקודות הדרך שנותרו לרכב במדריך מבוא לנסיעות.

דוגמה לשדה remaining_waypoints לנסיעה, נסיעה א':

[0]	location.point = trip.pickup_point.point
	`trip_id` = "trip_A"
	`waypoint_type` = `PICKUP_WAYPOINT_TYPE`
	path_to_waypoint = LatLng[]	קו הרוחב והאורך הראשון מהנתיב שנותר לאיסוף
		LatLng השני מהנתיב שנותר לאיסוף
		...
		last LatLng from remaining path to pickup
		pickup_point, אם הוא שונה מהאחרון
	traffic_data
	distance_meters = distance from current vehicle_location along path_to_waypoint to pickup
	eta = updated ETA
	duration = updated duration

[1]	location.point = trip.dropoff_point.point
	trip_id = "trip_A"
	waypoint_type = DROP_OFF_WAYPOINT_TYPE
	path_to_waypoint = LatLng[]	קו הרוחב והאורך הראשון מהקטע של הורדת הנוסע
		קו הרוחב והאורך השניים מהקטע של מסירת ההזמנה
		...
		קו הרוחב והאורך האחרון מקטע המסירה
		dropoff_point, אם שונה מהנקודה האחרונה
	traffic_data
	distance_meters = distance from pickup along path_to_waypoint to dropoff
	eta = updated ETA
	duration = drop-off leg duration

בנסיעות רצופות ובנסיעות שיתופיות, הרשימה הזו עשויה לכלול נקודות דרך מנסיעות אחרות שצריך לעבור עליהן לפני הנסיעה הזו. לדוגמה, נניח שנסיעה ב'ב' משויכת לאותו רכב שנסיעה ב'א' משויכת אליו. לאחר מכן, השדה remaining_waypoints של נסיעה א' יאוכלס באופן הבא. רוב השדות הושמטו כדי לשמור על תמציתיות, אבל הם יאוכלסו בהתאם לדוגמה הקודמת.

[0]	trip_id = "trip_A"
[0]	waypoint_type = PICKUP_WAYPOINT_TYPE
[1]	trip_id = "trip_B"
[1]	waypoint_type = PICKUP_WAYPOINT_TYPE
[2]	trip_id = "trip_B"
[2]	waypoint_type = DROP_OFF_WAYPOINT_TYPE
[3]	trip_id = "trip_A"
[3]	waypoint_type = DROP_OFF_WAYPOINT_TYPE

השדה remaining_waypoint של נסיעה ב' יהיה מאוכלס באופן דומה, אבל רק שלוש הרשומות הראשונות יופיעו, כי נקודת ההורדה של נסיעה א' לא נכללת במסלול של נסיעה ב'.