Trovare le attività

Questo documento descrive i modi in cui puoi trovare informazioni sulle attività da un browser o un server. Fleet Engine supporta due modi per trovare le attività:

• Cerca attività: puoi cercare le attività in base ai seguenti ID:

  • ID attività: utilizzato da utenti come gli operatori del parco veicoli che hanno accesso alla visualizzazione completa dei dati delle attività.
  • ID tracciamento: utilizzato dal software client per fornire informazioni limitate a un utente finale, ad esempio quando è previsto l'arrivo di un pacco a casa sua.

  Assicurati di comprendere la differenza tra l'ID attività e l'ID monitoraggio attività. Non sono la stessa cosa. Consulta la sezione Campi di attività di base nella guida sulle attività pianificate.

• Elenca attività: accesso ampio alle attività, destinato solo agli utenti attendibili.

Cercare le attività

Questa sezione descrive come cercare le attività in base all'ID attività o all'ID monitoraggio. Deve soddisfare i seguenti requisiti:

• Le ricerche per ID monitoraggio devono rispettare le regole di visibilità riportate in Regole di visibilità per gli oggetti monitorati.

• Utilizza il token più limitato possibile per limitare i rischi per la sicurezza. Ad esempio, se utilizzi un token consumer per la consegna, tutte le chiamate restituiscono solo le informazioni pertinenti per quell'utente finale, come il mittente o il destinatario di una spedizione. Fleet Engine oscura tutte le altre informazioni nelle risposte. Per ulteriori informazioni sui token, consulta la pagina Token web JSON.

Cerca attività per ID attività

Puoi cercare un'attività tramite il relativo ID da un ambiente server utilizzando gRPC o REST. Gli esempi seguenti mostrano come utilizzare la libreria gRPC per Java o una richiesta REST per GetTask.

 static final String PROJECT_ID = "my-delivery-co-gcp-project";
 static final String TASK_ID = "task-8597549";

 DeliveryServiceBlockingStub deliveryService =
   DeliveryServiceGrpc.newBlockingStub(channel);

 // Task request
 String taskName = "providers/" + PROJECT_ID + "/tasks/" + TASK_ID;
 GetTaskRequest getTaskRequest = GetTaskRequest.newBuilder()  // No need for the header
     .setName(taskName)
     .build();

 try {
   Task task = deliveryService.getTask(getTaskRequest);
 } catch (StatusRuntimeException e) {
   Status s = e.getStatus();
   switch (s.getCode()) {
      case NOT_FOUND:
        break;

      case PERMISSION_DENIED:
        break;
   }
   return;
 }

    # Set JWT, PROJECT_ID, and TASK_ID in the local environment
    curl -H "Authorization: Bearer ${JWT}" \
      "https://fleetengine.googleapis.com/v1/providers/${PROJECT_ID}/tasks/${TASK_ID}"

Cercare le attività per ID monitoraggio

Gli esempi riportati di seguito mostrano come cercare le attività in base al relativo ID tracciabilità della spedizione utilizzando gRPC o una chiamata REST HTTP a GetTaskTrackingInfo.

static final String PROJECT_ID = "my-delivery-co-gcp-project";
static final String TRACKING_ID = "TID-7449w087464x5";

DeliveryServiceBlockingStub deliveryService =
  DeliveryServiceGrpc.newBlockingStub(channel);

// Tasks request
String parent = "providers/" + PROJECT_ID;
GetTaskTrackingInfoRequest getTaskTrackingInfoRequest = GetTaskTrackingInfoRequest.newBuilder()  // No need for the header
    .setParent(parent)
    .setTrackingId(TRACKING_ID)
    .build();

try {
  TaskTrackingInfo taskTrackingInfo = deliveryService.getTaskTrackingInfo(getTaskTrackingInfoRequest);
} catch (StatusRuntimeException e) {
  Status s = e.getStatus();
  switch (s.getCode()) {
     case NOT_FOUND:
       break;

     case PERMISSION_DENIED:
       break;
  }
  return;
}

# Set JWT, PROJECT_ID, and TRACKING_ID in the local environment
curl -H "Authorization: Bearer ${JWT}" \
  "https://fleetengine.googleapis.com/v1/providers/${PROJECT_ID}/taskTrackingInfo/${TRACKING_ID}"

Elenca attività

L'elenco delle attività richiede un accesso ampio alle attività. Le attività di elenco sono destinate solo agli utenti fidati. Utilizza i token di autenticazione Delivery Fleet Reader o Delivery Admin quando effettui richieste di attività dell'elenco. Per ulteriori informazioni, consulta la sezione Ruoli degli account di servizio.

Elenchi paginati

Gli elenchi di attività sono suddivisi in pagine. Nelle richieste di elenco di attività è possibile specificare una dimensione di pagina. Se viene specificata una dimensione della pagina, il numero di attività restituite non è superiore alla dimensione della pagina specificata. Se non è presente alcuna dimensione di pagina, viene utilizzata una predefinita ragionevole. Se le dimensioni della pagina richieste superano un valore massimo interno, viene utilizzato il valore massimo interno.

Un elenco di attività può includere un token per la lettura della pagina successiva dei risultati. Per recuperare la pagina successiva, emetti di nuovo la stessa richiesta insieme al token di pagina. Quando il token di pagina restituito è vuoto, non sono disponibili altre attività per il recupero.

Campi per l'elenco delle attività

Fleet Engine oscura i seguenti campi quando elenca le attività:

• VehicleStop.planned_location
• VehicleStop.state
• VehicleStop.TaskInfo.taskId

Utilizza i seguenti formati di campo in base alle proposte di miglioramento delle API di Google:

Filtrare le attività elencate

Puoi filtrare le attività elencate in base alla maggior parte delle proprietà. Per la sintassi delle query di filtro, consulta AIP-160. Se non viene specificata alcuna query di filtro, vengono elencate tutte le attività.

La tabella seguente mostra le proprietà delle attività valide che puoi utilizzare per filtrare:

Consulta l'AIP-160 per un elenco completo degli operatori di query di filtro.

Esempi di attività dell'elenco

L'esempio seguente mostra come elencare le attività per un attributo deliveryVehicleId e un attributo task, sia con la libreria gRPC Java sia con la chiamata REST HTTP a ListTasks.

Una risposta corretta può comunque essere vuota. Una risposta vuota indica che non sono associate attività al deliveryVehicleId fornito.

 static final String PROJECT_ID = "my-delivery-co-gcp-project";
 static final String TRACKING_ID = "TID-7449w087464x5";

 DeliveryServiceBlockingStub deliveryService =
   DeliveryServiceGrpc.newBlockingStub(channel);

 // Tasks request
 String parent = "providers/" + PROJECT_ID;
 ListTasksRequest listTasksRequest = ListTasksRequest.newBuilder()  // No need for the header
     .setParent(parent)
     .setFilter("delivery_vehicle_id = 123 AND attributes.foo = true")
     .build();

 try {
   ListTasksResponse listTasksResponse = deliveryService.listTasks(listTasksRequest);
 } catch (StatusRuntimeException e) {
   Status s = e.getStatus();
   switch (s.getCode()) {
      case NOT_FOUND:
        break;

      case PERMISSION_DENIED:
        break;
   }
   return;
 }

    // JSON representation
    {
      "tasks": [
        {
          object (Task)
        }
      ],
      "nextPageToken": string,
      "totalSize": integer
    }

 # Set JWT, PROJECT_ID, and VEHICLE_ID in the local environment
 curl -H "Authorization: Bearer ${JWT}" \
   "https://fleetengine.googleapis.com/v1/providers/${PROJECT_ID}/tasks?filter=state%20%3D%20OPEN%20AND%20delivery_vehicle_id%20%3D%20${VEHICLE_ID}"

Passaggi successivi

• Gestire le spedizioni