חיפוש רכבים

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

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

שימוש בשיטה SearchVehicles

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

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

שדות של SearchVehiclesRequest

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

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

תרחישים של SearchVehiclesRequest

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

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

• רכב 1: במרחק 3,500 מטרים מ-RestaurantX.
• רכב 2: נמצא במרחק של 100 מטרים מ-RestaurantX, בנסיעה פעילה עם איסוף והורדה במיקומים א' וב'.
• רכב 3: במרחק 200 מטרים מ-RestaurantX, עם נקודת מסירה אחת שנותרה במרחק רב.
• רכב 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

בדוגמה הבאה מוסבר איך להשתמש ב-API של SearchVehicles באמצעות ספריית 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