Questo documento descrive come creare un veicolo da un ambiente server utilizzando gRPC o REST. Puoi creare un veicolo dall'SDK Driver, fornito di aver eseguito il provisioning dell'app come ambiente attendibile utilizzando e credenziali.
Per capire come utilizzare l'SDK Driver per creare veicoli, consulta quanto segue:
- SDK Driver per le attività pianificate
- Ruoli dell'account di servizio in Nozioni di base su Fleet Engine.
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
, imposti 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 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 alcun campo, lascia il corpo del messaggio POST
richiesta vuota. Il veicolo appena creato estrae un ID veicolo dalla
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}"