تتوفر
واجهة برمجة تطبيقات المسارات المفضلة حاليًا لعملاء محددين فقط. يمكنك
التواصل مع فريق المبيعات لمعرفة المزيد من المعلومات.
تستخدم Google تكنولوجيا الذكاء الاصطناعي لترجمة المحتوى إلى لغتك المفضّلة، وقد تتضمّن بعض الأخطاء.
اختيار الحقول المراد إرجاعها
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
عند استدعاء الطريقة ComputeRoutes()، عليك تحديد الحقول التي تريد عرضها في الرد. يمكنك إجراء ذلك باستخدام قناع حقل استجابة، والذي تقدّمه مع مَعلمة عنوان URL $fields أو fields، أو باستخدام عنوان HTTP/gRPC X-Goog-FieldMask. لمزيد من المعلومات، يُرجى الاطّلاع على مَعلمات النظام.
قناع الحقل
قيمة قناع الحقل هي قائمة مسارات حقول مفصولة بفواصل. كل مسار حقل
هو قائمة بأسماء الحقول مفصولة بنقاط تمثّل التسلسل الهرمي للرسالة. اسم الحقل هو إما مفتاح عنصر JSON أو اسم علامة حقل protobuf. يبدأ مسار الحقل بنوع رسالة الردّ من المستوى الأعلى، ويمكن أن يتبعه اختياريًا نقطة واحدة أو أكثر، ثم مستوى اسم الحقل التالي. بشكل عام، يتم إنشاء مسارات الحقول بالطريقة التالية:
topLevelField[.secondLevelField][.thirdLevelField][...]
قناع الحقل الخاص هو حرف البدل "*" الذي يختار جميع الحقول على مستوى الجذر.
أمثلة
يوضّح المثال التالي كيفية ضبط أقنعة الحقول لطريقة
ComputeRoutes().
مثال 1
قناع الحقل لجميع الحقول المتاحة (للفحص اليدوي)
X-Goog-FieldMask: *
مثال 2
قناع الحقل الخاص بالمدة والمسافة والمضلّع على مستوى المسار (مثال على إعداد الإنتاج).
X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline
ننصح بعدم استخدام قناع حقل الردّ الذي يتضمّن حرف البدل (*)، أو تحديد قناع الحقل على المستوى الأعلى (المسارات) في مرحلة الإنتاج. اختيار الحقول التي
تحتاجها فقط:
يسمح ذلك لخادمنا بحفظ دورات المعالجة، ما يتيح لنا عرض نتائجك بوقت استجابة أقل.
يضمن أداءً مستقرًا لوقت الاستجابة. قد نضيف المزيد من حقول الاستجابة في المستقبل، وقد تتطلّب هذه الحقول الجديدة وقتًا إضافيًا للمعالجة. في حال اختيار جميع الحقول، أو إذا اخترت جميع الحقول على المستوى الأعلى، قد ينخفض الأداء لأنّ أي حقل جديد نضيفه سيتم تضمينه تلقائيًا في ردّك.
يؤدي ذلك إلى حجم استجابة أصغر، ما يعني معدل نقل بيانات أعلى للشبكة.
لمزيد من المعلومات حول كيفية إنشاء مسارات الحقول، يُرجى الاطّلاع على field_mask.proto.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2026-10-21 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","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"]],["تاريخ التعديل الأخير: 2026-10-21 (حسب التوقيت العالمي المتفَّق عليه)"],[],["To specify which fields to return from the `ComputeRoutes()` method, use a response field mask via the `$fields`, `fields` URL parameter, or the `X-Goog-FieldMask` header. Field masks use comma-separated field paths, formatted as `topLevelField[.secondLevelField]`. Avoid the wildcard `*` or top-level `routes` in production. Instead, specify needed fields, like `routes.duration,routes.distanceMeters,routes.polyline`, to reduce latency, ensure stable performance, and decrease response size.\n"]]
