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

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

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

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

استخدِم كلًّا من Routes Preferred API وNavigation SDK للاستفادة إلى أقصى حدّ من ميزة تخطيط المسار.

تفعيل طريقة ComputeCustomRoutes

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

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

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

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

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

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

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

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

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

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

للحصول على معلومات عن احتساب رسوم الطرق، يُرجى الاطّلاع على مقالة احتساب رسوم الطرق.

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