חיפוש רכבים

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

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

שימוש בשיטה 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 מטר מ-RestaurantX ונשארה תחנה אחת אחרונה רחוק.
• רכב 4: במרחק 1,000 מטר מ-RestaurantX.

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

     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 לקבלת דוגמאות. פרטים על יצירת מאפייני רכב מופיעים בקטע שדה מאפייני הרכב במדריך עדכון השדות של הרכב.

דוגמה לכלי חיפוש

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

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.

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

• יצירת נסיעה על פי דרישה