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

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

تتيح لك واجهة برمجة التطبيقات 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
• مرجع REST API

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

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

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

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