Cerca veicoli

Nell'ambito del servizio di corse on demand di Mobility, puoi trovare i veicoli nelle vicinanze utilizzando il metodo SearchVehicles.

Il metodo SearchVehicles ti consente di trovare i veicoli disponibili nelle vicinanze nella tua app mobile per i consumatori più adatti a una specifica richiesta di corsa o consegna. L'API SearchVehicles restituisce un elenco classificato di veicoli i cui attributi corrispondono a quelli della corsa richiesta. Il ranking è ordinato in base alla tua scelta tra l'orario di arrivo stimato, la distanza o la distanza in linea retta dal punto di partenza.

Utilizza il metodo SearchVehicles

Per utilizzare SearchVehicles, segui questa procedura generale:

1. Crea un SearchVehiclesRequest in base alla corsa da assegnare.
2. Chiama l'API SearchVehicles (vehicleService.searchVehicles) con la richiesta creata.
3. Elabora l'oggetto SearchVehicleResponse restituito dall'API.

Campi SearchVehiclesRequest

Utilizza i seguenti campi degli attributi obbligatori per creare un SearchVehiclesRequest:

Consulta la documentazione di riferimento per visualizzare l'insieme completo dei campi SearchVehicleRequest.

Scenari di SearchVehiclesRequest

Questa sezione mostra esempi di come creare un SearchVehiclesRequest.

Ad esempio, supponiamo che un cliente voglia essere prelevato presso il ristorante X e che tu abbia quattro veicoli:

• Veicolo 1: a 3500 m dal RistoranteX.
• Veicolo 2: a 100 m dal RistoranteX con una corsa attiva con un ritiro e una consegna nelle località A e B.
• Veicolo 3: a 200 m dal RistoranteX con una consegna rimanente molto lontana.
• Veicolo 4: a 1000 m dal RistoranteX.

Di seguito sono riportate varie richieste in base al veicolo che restituiscono.

     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
    

Campi SearchVehiclesResponse

Un SearchVehiclesResponse è costituito da un elenco di entità VehicleMatch, classificate in base all'attributo order_by specificato in SearchVehiclesRequest. Ogni entità VehicleMatch ha i seguenti campi:

Per un elenco completo dei campi VehicleMatch, consulta:

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

Utilizza le query di filtro

SearchVehicles e ListVehicles supportano l'applicazione di filtri agli attributi del veicolo utilizzando una query con filtro.

Le query di filtro supportano SOLO il filtro in base agli attributi personalizzati per i veicoli e non possono essere utilizzate per altri campi. Se utilizzata in una ricerca che include altri criteri di campo, come minimum_capacity o vehicle_types, la query di filtro funziona come una clausola AND.

Ad esempio, se cerchi un veicolo con una capacità minima di 6 persone e filtri un attributes come "animali ammessi", i tuoi criteri restituiranno solo i veicoli che ammettono animali domestici e possono trasportare almeno 6 passeggeri.

Per la sintassi delle query di filtro, consulta AIP-160 per esempi. Per informazioni dettagliate sulla creazione degli attributi del veicolo, consulta Campo degli attributi del veicolo nella guida Aggiorna i campi del veicolo.

Esempio di SearchVehicles

L'esempio seguente mostra come utilizzare l'API SearchVehicles utilizzando la libreria gRPC Java. Per un elenco completo delle lingue supportate, consulta Librerie client per i servizi di corse on demand.

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.

Passaggi successivi

• DeleteVehicle