חיפוש רכבים

כחלק משירות הנסיעות לפי דרישה, אתם יכולים למצוא כלי רכב בקרבת מקום באמצעות השיטה SearchVehicles.

השיטה SearchVehicles מאפשרת לכם למצוא כלי רכב זמינים בקרבת מקום באפליקציה לנייד לצרכנים, שהכי מתאימים לנסיעה ספציפית או לבקשת משלוח. ‫SearchVehicles API מחזיר רשימה מדורגת של רכבים שהמאפיינים שלהם תואמים למאפייני הנסיעה המבוקשים. הדירוג מוצג לפי הבחירה שלכם: זמן הגעה משוער, מרחק או מרחק בקו ישר מנקודת האיסוף.

שימוש בשיטה SearchVehicles

כדי להשתמש ב-SearchVehicles, פועלים לפי התהליך הכללי הזה:

1. יוצרים SearchVehiclesRequest על סמך הנסיעה שרוצים להקצות.
2. קוראים ל-API‏ SearchVehicles (vehicleService.searchVehicles) עם הבקשה שנוצרה.
3. מעבדים את SearchVehicleResponse שמוחזר מה-API.

שדות בבקשה SearchVehiclesRequest

כדי ליצור SearchVehiclesRequest, צריך להשתמש בשדות החובה הבאים של המאפיינים:

במאמרי העזרה אפשר לראות את כל השדות של SearchVehicleRequest.

תרחישים של בקשות מסוג SearchVehiclesRequest

בקטע הזה מוצגות דוגמאות לאופן שבו יוצרים SearchVehiclesRequest.

לדוגמה, נניח שלקוח רוצה שיאספו אותו ממסעדה X, ויש לכם ארבעה כלי רכב:

• רכב 1: במרחק 3,500 מטר ממסעדה X.
• רכב 2: נמצא במרחק של 100 מטר ממסעדה X, בנסיעה פעילה עם איסוף והורדה במיקומים א' וב'.
• רכב 3: נמצא במרחק 200 מטר ממסעדת X, ויש לו עוד עצירה אחת רחוקה מאוד.
• רכב 4: נמצא במרחק של 1,000 מטר ממסעדת X.

בהמשך מוצגות בקשות שונות לפי כלי הרכב שהן מחזירות.

     Pickup at RestaurantX, radius = 1200m, order by PICKUP_POINT_ETA
    

     Pickup at RestaurantX, radius = 1200m, order by PICKUP_POINT_ETA, is_back_to_back enabled
    

     Pickup at RestaurantX, radius = 1200m, order by PICKUP_POINT_ETA, current_trips_present = ALL
    

שדות של SearchVehiclesResponse

‫SearchVehiclesResponse: רשימה של ישויות VehicleMatch, מדורגות לפי מאפיין order_by שצוין ב-SearchVehiclesRequest. לכל ישות VehicleMatch יש את השדות הבאים:

VehicleMatchלרשימה מלאה של שדות

• ‫VehicleMatch message (gRPC)
• ‫VehicleMatch resource (REST)

שימוש בשאילתות סינון

ב-SearchVehicles וב-ListVehicles אפשר לסנן לפי מאפייני רכב באמצעות שאילתת סינון.

שאילתות סינון תומכות רק בסינון לפי מאפיינים מותאמים אישית של כלי רכב, ואי אפשר להשתמש בהן בשדות אחרים. כשמשתמשים בשאילתת המסנן בחיפוש שכולל קריטריונים אחרים של שדות, כמו minimum_capacity או vehicle_types, היא פועלת כמו תנאי AND.

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

דוגמאות לתחביר של שאילתות סינון מופיעות ב-AIP-160. פרטים על יצירת מאפייני רכב מופיעים במאמר שדה מאפייני הרכב במדריך עדכון שדות של רכב.

דוגמה לשימוש ב-SearchVehicles

בדוגמה הבאה מוצג שימוש ב-SearchVehicles API באמצעות ספריית Java gRPC. רשימה מלאה של השפות הנתמכות מופיעה במאמר ספריות לקוח לשירותי נסיעות על פי דרישה.

static final String PROJECT_ID = "project-id";

VehicleServiceBlockingStub vehicleService =
    VehicleService.newBlockingStub(channel);

String parent = "providers/" + PROJECT_ID;
SearchVehiclesRequest searchVehiclesRequest = SearchVehiclesRequest.newBuilder()
    .setParent(parent)
    .setPickupPoint( // Grand Indonesia East Mall
        TerminalLocation.newBuilder().setPoint(
            LatLng.newBuilder().setLatitude(-6.195139).setLongitude(106.820826)))
    .setDropoffPoint( // Balai Sidang Jkt Convention Center
        TerminalLocation.newBuilder().setPoint(
            LatLng.newBuilder().setLatitude(-6.213796).setLongitude(106.807195)))
    .setPickupRadiusMeters(2000)
    .setCount(10)
    .setMinimumCapacity(2)
    .addTripTypes(TripType.EXCLUSIVE)
    .addVehicleTypes(VehicleType.newBuilder().setCategory(Category.AUTO).build())
    .setCurrentTripsPresent(CurrentTripsPresent.ANY)
    .setFilter("attributes.on_trip=\"false\"")
    .setOrderBy(VehicleMatchOrder.PICKUP_POINT_ETA)
    .build();

try {
  SearchVehiclesResponse searchVehiclesResponse =
      vehicleService.searchVehicles(searchVehiclesRequest);
} catch (StatusRuntimeException e) {
  Status s = e.getStatus();
  switch (s.getCode()) {
    case NOT_FOUND:
      break;
    case PERMISSION_DENIED:
      break;
  }
  return;
}

List<VehicleMatch> vehicleMatches =
    searchVehicleResponse.getMatchesList();

// Each VehicleMatch contains a Vehicle entity and information about the
// distance and ETA to the pickup point and drop-off point.

המאמרים הבאים

• DeleteVehicle