Crea un veicolo per la consegna per le attività programmate

Questo documento descrive come creare un veicolo da un ambiente server utilizzando gRPC o REST. Puoi creare un veicolo dall'SDK Driver, a condizione che abbia eseguito il provisioning dell'app come ambiente attendibile utilizzando le credenziali appropriate.

Per capire come utilizzare l'SDK Driver per creare veicoli, consulta quanto segue:

Per creare un nuovo veicolo da un ambiente server, crea una Richiesta di CreateDeliveryVehicle a Fleet Engine. Utilizza la CreateDeliveryVehicleRequest per definire gli attributi del nuovo un veicolo per le consegne.

Campi per i veicoli delle attività pianificate

Quando crei un DeliveryVehicle, imposta i seguenti campi facoltativi:

  • attributes
  • last_location
  • type

Per creare un veicolo senza impostare campi facoltativi, puoi uscire dalla Impostazione del campo DeliveryVehicle annullata in CreateDeliveryVehicleRequest.

Crea un esempio di veicolo

Puoi utilizzare la libreria Java gRPC per creare un veicolo o REST.

Java

  static final String PROJECT_ID = "my-delivery-co-gcp-project";
  static final String VEHICLE_ID = "vehicle-8241890"; // Avoid auto-incrementing IDs.

  DeliveryServiceBlockingStub deliveryService =
    DeliveryServiceGrpc.newBlockingStub(channel);

  // Vehicle settings
  String parent = "providers/" + PROJECT_ID;
  DeliveryVehicle vehicle = DeliveryVehicle.newBuilder()
    .addAttributes(DeliveryVehicleAttribute.newBuilder()
      .setKey("route_number").setValue("1"))  // Opaque to the Fleet Engine
    .build();

  // Vehicle request
  CreateDeliveryVehicleRequest createVehicleRequest =
    CreateDeliveryVehicleRequest.newBuilder()  // No need for the header
        .setParent(parent)
        .setDeliveryVehicleId(VEHICLE_ID)     // Vehicle ID assigned by the Provider
        .setDeliveryVehicle(vehicle)
        .build();

  // Error handling
  // If Fleet Engine does not have vehicle with that ID and the credentials of the
  // requestor pass, the service creates the vehicle successfully.

  try {
    DeliveryVehicle createdVehicle =
      deliveryService.createDeliveryVehicle(createVehicleRequest);
  } catch (StatusRuntimeException e) {
    Status s = e.getStatus();
    switch (s.getCode()) {
       case ALREADY_EXISTS:
         break;
       case PERMISSION_DENIED:
         break;
    }
    return;
  }

REST

Per creare un veicolo da un ambiente server, esegui una chiamata REST HTTP a CreateDeliveryVehicle:

POST https://fleetengine.googleapis.com/v1/providers/<project_id>/deliveryVehicles?deliveryVehicleId=<id>

Il corpo del messaggio POST rappresenta l'entità DeliveryVehicle da creare. Puoi specifica i seguenti campi facoltativi:

  • attributes
  • lastLocation
  • type
  # Set $JWT, $PROJECT_ID, and $VEHICLE_ID in the local
  # environment
  curl -X POST "https://fleetengine.googleapis.com/v1/providers/${PROJECT_ID}/deliveryVehicles?deliveryVehicleId=${VEHICLE_ID}" \
    -H "Content-type: application/json" \
    -H "Authorization: Bearer ${JWT}" \
  --data-binary @- << EOM
  {
    "attributes": [{"key": "model", "value": "sedan"}],
    "lastLocation": {"location": {"latitude": 12.1, "longitude": 14.5}}
  }
  EOM

Per creare un veicolo senza impostare nessun campo, lascia il corpo del messaggio POST richiesta vuota. Il veicolo appena creato estrae quindi un ID veicolo dal parametro deliveryVehicleId nell'URL POST.

Esempio:

  # Set $JWT, $PROJECT_ID, and $VEHICLE_ID in the local
  # environment
  curl -X POST "https://fleetengine.googleapis.com/v1/providers/${PROJECT_ID}/deliveryVehicles?deliveryVehicleId=${VEHICLE_ID}" \
    -H "Content-type: application/json" \
    -H "Authorization: Bearer ${JWT}"

Passaggi successivi