במסמך הזה מתואר איך ליצור נסיעה אחת ליעד, להגדיר את היעד הנכון שדות, ולהקצות אותו לרכב למילוי. ההנחה היא שהגדרת את Fleet מנוע חיפוש ושיצרת כלי רכב, אפליקציה תקינה לנהג (אופציונלי) אפליקציה לצרכן. תוכלו להיעזר במדריכים הבאים שקשורים לנושא:
מידע בסיסי על יצירת נסיעה
בקטע הזה מתוארים פרטי הבקשה שדרושים ליצירת נסיעה ב: מנוע Fleet. יוצרים בקשת יצירה באמצעות gRPC ו-REST.
שדות נסיעה
צריך להשתמש בשדות הבאים כדי ליצור נסיעה ב-Fleet Engine. אפשר להשתמש לסוגים השונים של הנסיעות: יעד אחד או יעד מרובה, גב אל גב או נסיעות קבוצתיות משותפות. שלך יכול לספק את השדות האופציונליים כשיוצרים את הנסיעה, או להגדיר אותם מאוחר יותר כשתעדכנו את הנסיעה.
שם | נדרש? | תיאור |
---|---|---|
הורה | כן | מחרוזת שכוללת את מזהה הפרויקט. המזהה הזה חייב להיות אותו המזהה שבו אתם משתמשים בכל השילוב של Fleet Engine, עם אותו חשבון שירות תפקידים. |
trip_id | כן | מחרוזת שנוצרה לזיהוי ייחודי של הנסיעה. יש למזהי נסיעות הגבלות מסוימות, כפי שמצוין בחומר העזר. |
trip_type | כן | מגדירים את TripType לערכים הבאים בהתאם לסוג הנסיעה שיוצרים:
|
pickup_point | כן | נקודת המוצא של הנסיעה. |
יעדי ביניים | כן | נסיעות מרובות יעדים בלבד: רשימת יעדי הביניים שהנהג מבקר בהם ביניהם
של איסוף ומסירה. בדומה ל- |
vehicle_waypoints | כן | נסיעות במאגר משותף בלבד: השדה הזה תומך בשילוב של ציוני הדרך מכמה נסיעות.
היא מכילה את כל ציוני הדרך שנותרו בכלי הרכב, וגם
בתור נקודות הדרך לאיסוף ולהורדה בנסיעה הזו. אפשר להגדיר את השדה הזה
באמצעות התקשרות אל |
number_of_passengers | לא | מספר הנוסעים בנסיעה. |
dropoff_point | לא | יעד הנסיעה. |
vehicle_id | לא | המזהה של הרכב שהוקצה לנסיעה. |
דוגמה: טיול ביעד אחד
הדוגמה הבאה ממחישה איך יוצרים טיול לגרנד אינדונזיה
איסט מול. בנסיעה משתתפים שני נוסעים, היא בלעדית והסטטוס שלה הוא
NEW
provider_id
של הנסיעה חייב להיות זהה לזה של Google Cloud
מזהה הפרויקט. בדוגמאות מוצג פרויקט ב-Google Cloud עם מזהה הפרויקט.
my-rideshare-co-gcp-project
הפרויקט הזה חייב לכלול גם חשבון שירות
כדי לקרוא ל-Fleet Engine. למידע נוסף, ראו תפקידי חשבון שירות.
static final String PROJECT_ID = "my-rideshare-co-gcp-project";
TripServiceBlockingStub tripService = TripService.newBlockingStub(channel);
// Trip initial settings.
String parent = "providers/" + PROJECT_ID;
Trip trip = Trip.newBuilder()
.setTripType(TripType.EXCLUSIVE) // Use TripType.SHARED for carpooling.
.setPickupPoint( // Grand Indonesia East Mall.
TerminalLocation.newBuilder().setPoint(
LatLng.newBuilder()
.setLatitude(-6.195139).setLongitude(106.820826)))
.setNumberOfPassengers(2)
// Provide the drop-off point if available.
.setDropoffPoint(
TerminalLocation.newBuilder().setPoint(
LatLng.newBuilder()
.setLatitude(-6.1275).setLongitude(106.6537)))
.build();
// Create trip request
CreateTripRequest createTripRequest = CreateTripRequest.newBuilder()
.setParent(parent)
.setTripId("trip-8241890") // Trip ID assigned by the provider.
.setTrip(trip) // The 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:
break;
case PERMISSION_DENIED:
break;
}
return;
}