Trovare le attività

Questo documento descrive i modi in cui puoi trovare le informazioni sulle attività da un server o un browser. 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 della flotta che hanno accesso alla visualizzazione completa dei dati delle attività.
  • ID monitoraggio: utilizzato dal software client per fornire informazioni limitate a un utente finale, ad esempio quando è prevista la consegna di un pacco a casa sua.

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

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

Cerca attività

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

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

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

Cerca attività per ID attività

Puoi cercare un'attività in base al suo ID attività da un ambiente server utilizzando gRPC o REST. Gli esempi seguenti mostrano come utilizzare la libreria Java gRPC o una richiesta REST a 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}"

Cerca attività per ID di monitoraggio

Gli esempi seguenti mostrano come cercare le attività in base al relativo ID di monitoraggio della spedizione utilizzando gRPC o una chiamata HTTP REST 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à

Le richieste di elenco delle attività richiedono un accesso ampio alle attività. L'elenco delle attività è destinato solo agli utenti attendibili. Utilizza i token di autenticazione di Delivery Fleet Reader o Delivery Admin quando effettui richieste di elenco delle attività. Per saperne di più, consulta Ruoli degli account di servizio per altre informazioni.

Impagina gli elenchi

Gli elenchi di attività sono impaginati. È possibile specificare una dimensione della pagina nelle richieste di elenco delle attività. Se viene specificata una dimensione della pagina, il numero di attività restituite non è superiore alla dimensione della pagina specificata. Se non è presente alcuna dimensione della pagina, viene utilizzato un valore predefinito ragionevole. Se la dimensione della pagina richiesta supera un valore massimo interno, viene utilizzato il valore massimo interno.

Un elenco di attività può includere un token per leggere la pagina successiva dei risultati. Per recuperare la pagina successiva, invia 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 durante l'elenco delle attività

Fleet Engine oscura i seguenti campi durante l'elenco delle attività:

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

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

Filtra le attività elencate

Puoi filtrare le attività elencate in base alla maggior parte delle proprietà delle attività. 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 il filtraggio:

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

Esempi di elenco di attività

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

Una risposta riuscita 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

• Gestisci le spedizioni