يوضّح هذا المستند كيفية إدراج مركبات التسليم.
البيئات والقيود
يمكنك إدراج مركبات التسليم من بيئة خادم أو متصفّح. السائق لا تتيح حزمة تطوير البرامج (SDK) عرض بيانات مركبات التسليم.
تتطلب مركبات تسليم القوائم وصولاً واسع النطاق إلى مركبات التسليم مُخصصة للمستخدمين الموثوق بهم فقط. استخدِم Delivery Fleet Reader أو Fleet Engine الرموز المميزة لمشرف التسليم عند تقديم طلبات مركبات تسليم القوائم
تم إخفاء الحقول التالية في مركبات التسليم المدرَجة بسبب تأثيرها على حجم الردّ:
CurrentRouteSegment
RemainingVehicleJourneySegments
الاستخدام
يمكنك إدراج المركبات حسب فلاتر السمات وحدود إطار العرض. إذا حددت بدون فلتر أو إطار عرض، يشمل الردّ جميع مركبات التسليم.
قائمة بفلاتر السمات
يمكنك إدراج مركبات التسليم من خلال الفلترة باستخدام السمة attributes
الخاصة بها. بالنسبة
على سبيل المثال، لطلب بحث عن سمة تتضمّن المفتاح my_key
والقيمة my_value
، استخدِم
attributes.my_key = my_value
لإجراء طلب عن سمات متعدّدة، يمكنك ضم طلبات البحث
باستخدام عاملي التشغيل AND
وOR
المنطقيين كما في attributes.key1 = value1 AND
attributes.key2 = value2
. راجع AIP-160 للحصول على وصف كامل
لبناء جملة استعلام عامل التصفية. في حال دمج الفلاتر مع حدود إطار العرض، سيتم تطبيق الفلتر
يعمل كعامل تشغيل AND
مرتبط بإطار العرض. راجِع فلتر سمات المركبات
للحصول على التفاصيل.
قائمة بحدود إطار عرض
يمكنك فلترة مركبات التسليم المدرَجة حسب الموقع الجغرافي باستخدام طلب viewport
.
. تحدِّد مَعلمة طلب viewport
إطارات العرض باستخدام حدودَين.
الإحداثيات: خط عرض وخط طول high
(شمال شرق) وlow
(جنوب غربي)
زوج الإحداثيات. يتم رفض الطلبات إذا كانت تحتوي على خط عرض عالٍ
الذي يكون أقل جغرافيًا من خط عرض منخفض.
عرض الردود
يتم تقسيم قوائم مركبات التسليم إلى صفحات تلقائيًا باستخدام حجم صفحة معقول. في حال حذف إذا حددت حجم صفحة، فسيعرض الطلب عدد المركبات فقط المحدد بواسطة الحد، أو أقل. إذا تجاوز حجم الصفحة المطلوب الحجم الداخلي الحد الأقصى للقيمة، يتم استخدام الحد الأقصى الداخلي. الصفحة الافتراضية والحد الأقصى بحجم 100 مركبة.
يمكن أن تتضمن قائمة مركبات التوصيل رمزًا مميزًا لقراءة الصفحة التالية من نتائجك. لا يتوفّر الرمز المميّز للصفحة في الردّ إلا عند توفّر المزيد من صفحات التسليم المركبات المتاحة للاسترجاع. لاسترداد الصفحة التالية من المهام، استخدم الرمز المميز للصفحة مع طلب مماثل لطلبك السابق طلبك.
إدراج أمثلة على المركبات
يمكنك استخدام مكتبة Java gRPC أو REST لإدراج مركبات التسليم في منطقة معينة بتصنيف معين. لا يزال الرد الناجح فارغ. وعندما يحدث ذلك، يعني ذلك أنّه ما مِن مركبات تحمل السمة المحدّدة. موجودة في إطار العرض المحدد.
Java
static final String PROJECT_ID = "my-delivery-co-gcp-project";
DeliveryServiceBlockingStub deliveryService =
DeliveryServiceGrpc.newBlockingStub(channel);
// Tasks request
String parent = "providers/" + PROJECT_ID;
ListDeliveryVehiclesRequest listDeliveryVehiclesRequest =
ListDeliveryVehiclesRequest.newBuilder() // No need for the header
.setParent(parent)
.setViewport(
Viewport.newBuilder()
.setHigh(LatLng.newBuilder()
.setLatitude(37.45)
.setLongitude(-122.06)
.build())
.setLow(LatLng.newBuilder()
.setLatitude(37.41)
.setLongitude(-122.11)
.build())
.setFilter("attributes.my_key = my_value")
.build();
try {
ListDeliveryVehiclesResponse listDeliveryVehiclesResponse =
deliveryService.listDeliveryVehicles(listDeliveryVehiclesRequest);
} catch (StatusRuntimeException e) {
Status s = e.getStatus();
switch (s.getCode()) {
case NOT_FOUND:
break;
case PERMISSION_DENIED:
break;
}
return;
}
راحة
# HTTP request
html GET https://fleetengine.googleapis.com/v1/providers/<project_id>/deliveryVehicles
# Request with a filter
# Request sets JWT, PROJECT_ID, and VEHICLE_ID in the local environment
curl -H "Authorization: Bearer ${JWT}" \
"https://fleetengine.googleapis.com/v1/providers/${PROJECT_ID}/deliveryVehicles?filter=attributes.my_key%20%3D%20my_value%20&viewport.high.latitude=37.45&viewport.high.longitude=-122.06&viewport.low.latitude=37.41&viewport.low.longitude=-122.11"
إذا كان البحث ناجحًا، سيحتوي نص الاستجابة على بيانات تحتوي على ما يلي: البنية:
// JSON representation
{
"deliveryVehicles": [
{
object (DeliveryVehicle)
}
],
"nextPageToken": string,
"totalSize": integer
}