तरीके
Fleet Engine से सबसे अच्छी परफ़ॉर्मेंस पाने के लिए, हर मिनट में कम से कम एक बार और हर पांच सेकंड में ज़्यादा से ज़्यादा एक बार, वाहन की जगह की जानकारी के अपडेट उपलब्ध कराएं. ये अपडेट उपलब्ध कराने के लिए, इनमें से कोई एक तरीका इस्तेमाल करें:
- **Driver SDK** का इस्तेमाल करना: यह सबसे आसान विकल्प है.
- कस्टम कोड का इस्तेमाल करना: यह विकल्प तब काम आता है, जब जगह की जानकारी आपके बैकएंड के ज़रिए रिले की जाती है, या जब Android या iOS के अलावा किसी अन्य डिवाइस का इस्तेमाल किया जाता है. इस दस्तावेज़ में, इस तरीके के बारे में बताया गया है.
वाहन की जगह की जानकारी के अपडेट उपलब्ध कराने के तरीके से कोई फ़र्क़ नहीं पड़ता. हालांकि, डिलीवरी करने वाला वाहन किसी स्टॉप पर जाते समय और वहां पहुंचने पर, Fleet Engine को अपडेट करने की ज़िम्मेदारी आपके बैकएंड की होती है. इसमें डिपो भी शामिल है. Fleet Engine, इन इवेंट का पता अपने-आप नहीं लगाता.
वाहन की जगह की जानकारी अपडेट करने के उदाहरण
Fleet Engine में किसी वाहन की जगह की जानकारी अपडेट करने के लिए, Java gRPC लाइब्रेरी या REST का इस्तेमाल किया जा सकता है. जैसा कि यहां दिए गए उदाहरण में दिखाया गया है. जिन भाषाओं में सुविधा उपलब्ध है उनकी पूरी सूची देखने के लिए, शेड्यूल किए गए टास्क की सेवाओं के लिए क्लाइंट लाइब्रेरी लेख पढ़ें.
Java
static final String PROJECT_ID = "my-delivery-co-gcp-project";
static final String VEHICLE_ID = "vehicle-8241890";
DeliveryServiceBlockingStub deliveryService =
DeliveryServiceGrpc.newBlockingStub(channel);
// Vehicle settings
String vehicleName = "providers/" + PROJECT_ID + "/deliveryVehicles/" + VEHICLE_ID;
DeliveryVehicle myDeliveryVehicle = DeliveryVehicle.newBuilder()
.setLastLocation(DeliveryVehicleLocation.newBuilder()
.setSupplementalLocation(LatLng.newBuilder()
.setLatitude(37.3382)
.setLongitude(121.8863))
.setSupplementalLocationTime(now())
.setSupplementalLocationSensor(DeliveryVehicleLocationSensor.CUSTOMER_SUPPLIED_LOCATION)
.setSupplementalLocationAccuracy(DoubleValue.of(15.0))) // Optional
.build();
// DeliveryVehicle request
UpdateDeliveryVehicleRequest updateDeliveryVehicleRequest =
UpdateDeliveryVehicleRequest.newBuilder() // No need for the header
.setName(vehicleName)
.setDeliveryVehicle(myDeliveryVehicle)
.setUpdateMask(FieldMask.newBuilder()
.addPaths("last_location"))
.build();
try {
DeliveryVehicle updatedDeliveryVehicle =
deliveryService.updateDeliveryVehicle(updateDeliveryVehicleRequest);
} catch (StatusRuntimeException e) {
Status s = e.getStatus();
switch (s.getCode()) {
case NOT_FOUND:
break;
case PERMISSION_DENIED:
break;
}
return;
}
REST
PATCH https://fleetengine.googleapis.com/v1/providers/<project_id>/deliveryVehicles/<id>?updateMask=last_location
अनुरोध की जानकारी
अनुरोध के मुख्य हिस्से में, DeliveryVehicle इकाई शामिल होनी चाहिए. इसमें फ़ील्ड इस तरह से तय किए जाने चाहिए:
ज़रूरी फ़ील्ड:
फ़ील्ड मान lastLocation.supplementalLocationवाहन की जगह की जानकारी. lastLocation.supplementalLocationTimeवह आखिरी टाइमस्टैंप जब वाहन इस जगह पर था. lastLocation.supplementalLocationSensorइसमें CUSTOMER_SUPPLIED_LOCATIONकी वैल्यू होनी चाहिए.ये फ़ील्ड ज़रूरी नहीं हैं:
फ़ील्ड मान lastLocation.supplementalLocationAccuracyदी गई जगह की जानकारी की सटीक जानकारी, मीटर में.
# Set JWT, PROJECT_ID, VEHICLE_ID, TASK1_ID, and TASK2_ID in the local
# environment
curl -X PATCH "https://fleetengine.googleapis.com/v1/providers/${PROJECT_ID}/deliveryVehicles/${VEHICLE_ID}?updateMask=remainingVehicleJourneySegments" \
-H "Content-type: application/json" \
-H "Authorization: Bearer ${JWT}" \
--data-binary @- << EOM
{
"lastLocation": {
"supplementalLocation": {"latitude": 12.1, "longitude": 14.5},
"supplementalLocationTime": "$(date -u --iso-8601=seconds)",
"supplementalLocationSensor": "CUSTOMER_SUPPLIED_LOCATION",
"supplementalLocationAccuracy": 15
}
}
EOM