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à:

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

  • ID attività: utilizzato da utenti come gli operatori di flotte 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 di monitoraggio attività. Non sono la stessa cosa. Consulta la sezione Campi di base delle attività nella guida alle attività pianificate.

• Elenca attività: un 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. Ha i seguenti requisiti:

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

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

Cercare un'attività per ID attività

Puoi cercare un'attività in base al relativo ID da un ambiente server utilizzando gRPC o REST. Gli esempi seguenti mostrano come utilizzare la libreria gRPC 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 seguenti mostrano come cercare le attività in base al relativo ID monitoraggio 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à

L'elenco delle attività richiede un ampio accesso 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 elenchi di attività. Per ulteriori informazioni, consulta Ruoli dei service account.

Impaginare gli elenchi

Gli elenchi di attività sono paginati. È 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 quando elenca le attività:

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

Utilizza i seguenti formati dei campi 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à 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 seguente tabella mostra le proprietà delle attività valide che puoi utilizzare per il filtraggio:

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

Elenco di esempi di attività

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

Una risposta riuscita può comunque essere vuota. Una risposta vuota indica che non ci sono attività associate 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 spedizioni