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