تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
عند تحديد أفضل مسار لرحلة باستخدام ميزة "مشاركة الرحلة"، قد لا يكون المسار الأسرع هو الخيار الأفضل دائمًا. يمكنك
التخطيط لمسيرتك.
تتيح لك واجهة برمجة التطبيقات 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.
يبدأ مسار الحقل من نوع رسالة الردّ من المستوى الأعلى، ويليه اختياريًا نقطة واحدة أو أكثر، ثم المستوى التالي من اسم الحقل. بشكل عام، يتم إنشاء مسارات الحقول على النحو التالي:
تاريخ التعديل الأخير: 2024-11-23 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2024-11-23 (حسب التوقيت العالمي المتفَّق عليه)"],[[["The Routes Preferred API's `ComputeCustomRoutes` method enables planning routes based on objectives beyond the fastest route, such as compliance or driver preferences."],["`ComputeCustomRoutes` supports optimizing routes for `DRIVE` and `TWO_WHEELER` travel modes, but excludes intermediate waypoints and other travel modes."],["Using the Routes Preferred API with the Navigation SDK provides the best route planning outcomes, though they can utilize separate cloud projects."],["Before using the `ComputeCustomRoutes` method, enable it and verify your quota limits, requesting increases if necessary through Google Cloud Support."],["To specify desired data in the response, use field masks with the `ComputeCustomRoutes` method, selecting fields using dot-separated paths from the top-level response."]]],["The Routes Preferred API's `ComputeCustomRoutes` method allows route planning by specifying a route objective and minimizing deviations from the operator's selected route. This method supports `DRIVE` and `TWO_WHEELER` travel modes, excluding `via` waypoints. To use it, enable the method and specify a response field mask via `$fields`, `fields`, or `X-Goog-FieldMask`. Quota limits should be monitored. Use alongside the Navigation SDK to maximize route planning benefits. Additionally, toll fees can be calculated using this API.\n"]]
