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