عند استدعاء الإجراء ComputeRoutes()، يجب عليك تحديد الحقول التي تريد عرضها في الاستجابة. يمكنك إجراء ذلك باستخدام قناع حقل الاستجابة الذي
توفِّره مع معلَمة عنوان URL $fields أو fields، أو باستخدام عنوان HTTP/gRPC X-Goog-FieldMask. لمزيد من المعلومات، يُرجى الاطّلاع على معلَمات النظام.
قناع الحقل
قيمة قناع الحقل هي قائمة مفصولة بفواصل من مسارات الحقول. كل مسار حقل هو قائمة بأسماء الحقول المفصولة بالنقاط التي تمثل التسلسل الهرمي للرسالة. ويكون اسم الحقل إما مفتاح كائن JSON أو اسم علامة حقل النموذج الأوّلي. يبدأ مسار الحقل من نوع رسالة الاستجابة من المستوى الأعلى، ثم يتبعه نقطة واحدة أو أكثر اختياريًا، ثم المستوى التالي من اسم الحقل. وبشكل عام، يتم إنشاء مسارات الحقول على النحو التالي:
topLevelField[.secondLevelField][.thirdLevelField][...]
قناع حقل الحالة الخاصة هو حرف بدل "*"، ويحدد جميع حقول مستوى الجذر.
أمثلة
يوضّح المثال التالي كيفية ضبط أقنعة الحقول لطريقة ComputeRoutes().
مثال 1
يتم وضع كمامة لكل الحقول المتاحة (للفحص اليدوي).
X-Goog-FieldMask: *
مثال 2
قناع حقل للمدة على مستوى المسار والمسافة والخطوط المتعددة (مثال على إعداد الإنتاج).
X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline
لا ننصح باستخدام قناع حقل الاستجابة (*) بأحرف البدل، أو تحديد قناع الحقل في المستوى الأعلى (المسارات) في الإنتاج. اختيار الحقول التي تحتاجها فقط:
تسمح لخادمنا بحفظ دورات المعالجة، ما يتيح لنا عرض نتائجك بوقت استجابة أقل.
يضمن أداء وقت الاستجابة الثابت. قد نضيف المزيد من حقول الاستجابة في المستقبل، وقد تتطلب هذه الحقول الجديدة وقتًا إضافيًا للحساب. إذا اختَرت جميع الحقول، أو إذا اختَرت جميع الحقول في المستوى الأعلى، قد تواجه تراجعًا في الأداء لأنّ أي حقل جديد نضيفه سيتم تضمينه تلقائيًا في ردّك.
ينتج عن استجابة بحجم أصغر، ما يؤدي إلى زيادة سرعة معالجة البيانات على الشبكة.
لمزيد من المعلومات حول كيفية إنشاء مسارات الحقول، راجِع field_mask.proto.