عندما تحدد أفضل مسار لرحلة مشاركة الرحلات، قد لا يكون المسار الأسرع هو الخيار الأفضل دائمًا. قد ترغب في التخطيط لمسارك.
تتيح لك Routes Preferred API التخطيط لمسار من خلال تحديد
هدف مسار باستخدام طريقة ComputeCustomRoutes.
يمكن أن تساعدك الطريقة ComputeCustomRoutes أيضًا في الامتثال للمسار عن طريق السماح لك بتقليل الفرق بين المسار الذي حدده عامل التشغيل والمسار الذي يقودك إليه.
يمكنك استخدام كل من واجهة برمجة التطبيقات Routes Preferred API وحزمة تطوير البرامج (SDK) للتنقّل لتحقيق الاستفادة الكاملة من تخطيط المسارات.
تفعيل طريقة ComputeCustomRoutes
قبل أن تتمكّن من استخدام طريقة ComputeCustomRoutes في الرمز، يجب
تفعيلها. لمزيد من المعلومات حول تفعيل طرق واجهة برمجة التطبيقات المفضلة للمسارات،
راجع البدء.
استخدام طريقة ComputeCustomRoutes
تتطلب طريقة ComputeCustomRoutes تحديد قناع حقل
الاستجابة في الإدخال. يمكنك توفير قناع حقل الاستجابة باستخدام مَعلمة عنوان URL $fields أو fields أو عنوان HTTP/gRPC X-Goog-FieldMask. لمزيد من المعلومات، يُرجى الاطّلاع على مَعلمات النظام.
قيمة قناع الحقل هي قائمة بمسارات الحقول مفصولة بفواصل. كل مسار حقل هو قائمة مفصولة بالنقاط تضم أسماء الحقول التي تمثل التسلسل الهرمي للرسالة. اسم الحقل هو مفتاح كائن JSON أو اسم علامة حقل Protobuf. يبدأ مسار الحقل من نوع رسالة الردّ من المستوى الأعلى، ويُتبعه اختياريًا بنقطة واحدة أو أكثر، ثم المستوى التالي لاسم الحقل. بشكل عام، يتم إنشاء مسارات الحقول بالطريقة التالية:
topLevelField[.secondLevelField][.thirdLevelField][...]
قناع حقل الحالة الخاصة هو حرف بدل "*"، يحدد جميع الحقول على مستوى الجذر.
يمكنك الاطّلاع على ما يلي للحصول على مزيد من المعلومات:
للحصول على أمثلة على استخدام طريقة ComputeCustomRoutes، يمكنك الاطّلاع على
أمثلة على حساب مسار مخصّص (تجريبي).
جارٍ احتساب رسوم العبور
للحصول على معلومات حول طريقة احتساب رسوم العبور، يمكنك الاطّلاع على احتساب رسوم رسوم العبور.
للحصول على أمثلة حول احتساب رسوم العبور، يمكنك الاطّلاع على أمثلة على الطرق المخصّصة.