Fahrzeuge suchen

Im Rahmen des On-Demand-Fahrdienstes können Sie mit der Methode SearchVehicles Fahrzeuge in der Nähe finden.

Mit der Methode SearchVehicles können Sie in Ihrer mobilen App für Endnutzer verfügbare Fahrzeuge in der Nähe finden, die am besten für eine bestimmte Fahrt oder eine Lieferanfrage geeignet sind. Die SearchVehicles API gibt eine sortierte Liste von Fahrzeugen zurück, deren Attribute mit den angeforderten Fahrtattributen übereinstimmen. Die Sortierung erfolgt nach Ihrer Wahl entweder nach der voraussichtlichen Ankunftszeit, der Entfernung oder der direkten Entfernung vom Abholort.

Methode SearchVehicles verwenden

So verwenden Sie SearchVehicles:

1. Erstellen Sie eine SearchVehiclesRequest basierend auf der zuzuweisenden Fahrt.
2. Rufen Sie die SearchVehicles API (vehicleService.searchVehicles) mit der erstellten Anfrage auf.
3. Verarbeiten Sie die von der API zurückgegebene SearchVehicleResponse.

Felder von SearchVehiclesRequest

Verwenden Sie die folgenden erforderlichen Attributfelder, um eine SearchVehiclesRequest zu erstellen:

Eine vollständige Liste der Felder von SearchVehicleRequest finden Sie in der Referenzdokumentation.

Szenarien für SearchVehiclesRequest

In diesem Abschnitt finden Sie Beispiele für die Erstellung einer SearchVehiclesRequest.

Angenommen, ein Kunde möchte im Restaurant X abgeholt werden und Sie haben vier Fahrzeuge:

• Fahrzeug 1: 3.500 m vom Restaurant X entfernt.
• Fahrzeug 2: 100 m vom Restaurant X entfernt mit einer aktiven Fahrt mit Abholung und Zielort an den Standorten A und B.
• Fahrzeug 3: 200 m vom Restaurant X entfernt mit einem verbleibenden Zielort in großer Entfernung.
• Fahrzeug 4: 1.000 m vom Restaurant X entfernt.

Im Folgenden werden verschiedene Anfragen nach dem zurückgegebenen Fahrzeug angezeigt.

     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
    

Felder von SearchVehiclesResponse

Eine SearchVehiclesResponse besteht aus einer Liste von VehicleMatch-Entitäten, die nach dem angegebenen Attribut „order_by“ in der SearchVehiclesRequest sortiert sind. Jede VehicleMatch-Entität hat die folgenden Felder:

Eine vollständige Liste der VehicleMatch-Felder finden Sie unter:

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

Filterabfragen verwenden

SearchVehicles und ListVehicles unterstützen das Filtern nach Fahrzeugattributen mit einer Filterabfrage.

Filterabfragen unterstützen NUR das Filtern nach benutzerdefinierten Attributen für Fahrzeuge und können nicht für andere Felder verwendet werden. Wenn sie in einer Suche verwendet werden, die andere Feldkriterien wie minimum_capacity oder vehicle_types enthält, fungiert die Filterabfrage als AND-Klausel.

Wenn Sie beispielsweise nach einem Fahrzeug mit einer Mindestkapazität von 6 suchen und ein attributes wie „haustierfreundlich“ filtern, werden nur Fahrzeuge zurückgegeben, die sowohl haustierfreundlich sind als auch mindestens 6 Fahrgäste befördern können.

Informationen zur Syntax von Filterabfragen finden Sie unter AIP-160. Details zum Erstellen von Fahrzeugattributen finden Sie im Leitfaden Fahrzeugfelder aktualisieren im Feld „Fahrzeug attribute“.

Beispiel für SearchVehicles

Im folgenden Beispiel wird gezeigt, wie Sie die SearchVehicles API mit der Java gRPC-Bibliothek verwenden. Eine vollständige Liste der unterstützten Sprachen finden Sie unter Clientbibliotheken für On-Demand-Fahrdienste.

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.

Nächste Schritte

• DeleteVehicle