عندما تحدد أفضل مسار لرحلة مشاركة الرحلات، فإن المسار الأسرع قد لا يكون دائمًا الخيار الأفضل. قد تريد لتخطيط مسارك.
تتيح لك 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][...]
قناع حقل الحالة الخاصة هو حرف بدل "*"، يحدد كل مستويات الجذر الحقول.
يمكنك الاطّلاع على ما يلي للحصول على مزيد من المعلومات:
للحصول على أمثلة على استخدام طريقة ComputeCustomRoutes، يمكنك الاطّلاع على
أمثلة على حساب مسار مخصّص (تجريبي).
جارٍ احتساب رسوم العبور
للحصول على معلومات حول احتساب رسوم العبور، يمكنك الاطّلاع على احتساب رسوم العبور:
للحصول على أمثلة حول حساب رسوم العبور، يمكنك الاطّلاع على أمثلة على المسارات المخصّصة