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