التخطيط للمسار

عندما تحدد أفضل مسار لرحلة مشاركة الرحلات، فإن المسار الأسرع قد لا يكون دائمًا الخيار الأفضل. قد تريد لتخطيط مسارك.

تتيح لك Routes Preferred API التخطيط لمسار من خلال تحديد هدف المسار باستخدام طريقة ComputeCustomRoutes.

يمكن أن تساعد طريقة ComputeCustomRoutes أيضًا في الامتثال للمسار من خلال السماح يتم تقليل الفرق بين المسار الذي يحدده عامل التشغيل على الطريق.

استخدام كل من واجهة برمجة التطبيقات Routes Preferred API حزمة SDK للتنقّل لتحقيق الفائدة الكاملة لتخطيط المسار.

تفعيل طريقة ComputeCustomRoutes

قبل أن تتمكّن من استخدام طريقة ComputeCustomRoutes في الرمز، يجب: لتفعيلها. مزيد من المعلومات حول تفعيل واجهة برمجة التطبيقات Routes Preferred API راجع البدء.

استخدام طريقة ComputeCustomRoutes

تتطلب طريقة ComputeCustomRoutes تحديد ردّ قناع الحقل في الإدخال. يمكنك توفير قناع حقل الاستجابة باستخدام معلمة عنوان URL $fields أو fields أو باستخدام عنوان HTTP/gRPC X-Goog-FieldMask لمزيد من المعلومات، يُرجى مراجعة مَعلمات النظام

قيمة قناع الحقل هي قائمة بمسارات الحقول مفصولة بفواصل. كل مسار حقل عبارة عن قائمة مفصولة بالنقاط تضم أسماء الحقول التي تمثل التسلسل الهرمي للرسالة. اسم الحقل هو مفتاح كائن JSON أو اسم علامة حقل Protobuf. يبدأ مسار الحقل من أعلى مستوى لنوع رسالة الرد، ويتبعها اختياريًا بنقطة واحدة أو أكثر، ثم المستوى التالي لاسم الحقل. بشكل عام، يتم إنشاء مسارات الحقول بالطريقة التالية:

topLevelField[.secondLevelField][.thirdLevelField][...]

قناع حقل الحالة الخاصة هو حرف بدل "*"، يحدد كل مستويات الجذر الحقول.

يمكنك الاطّلاع على ما يلي للحصول على مزيد من المعلومات:

• مرجع واجهة برمجة التطبيقات gRPC API
• مرجع REST API

للحصول على أمثلة على استخدام طريقة ComputeCustomRoutes، يمكنك الاطّلاع على أمثلة على حساب مسار مخصّص (تجريبي).

جارٍ احتساب رسوم العبور

للحصول على معلومات حول احتساب رسوم العبور، يمكنك الاطّلاع على احتساب رسوم العبور:

للحصول على أمثلة حول حساب رسوم العبور، يمكنك الاطّلاع على أمثلة على المسارات المخصّصة