قِيم الردود المعدَّلة بما يناسب المنطقة المحلية هي حقل ردود إضافي يوفّر نصًا معدَّلاً بما يناسب المنطقة المحلية لقيم المَعلمات التي يتم عرضها. يتم توفير نص مترجَم لمدة الرحلة والمسافة ونظام الوحدات (متري أو إمبراطوري). يمكنك طلب قيم مترجَمة باستخدام قناع حقل، ويمكنك إما تحديد اللغة ونظام الوحدات أو استخدام القيم التي تستنتجها واجهة برمجة التطبيقات. لمزيد من التفاصيل، راجِع LocalizedValues.
على سبيل المثال، إذا حدّدت رمز اللغة الألمانية (de) ووحدات القياس الإنجليزية، ستحصل على قيمة 49889.7 لسمة distanceMeters، بالإضافة إلى نص مترجَم يقدّم قياس المسافة باللغة الألمانية ووحدات القياس الإنجليزية، أي "31 Meile".
لطلب قيم مترجَمة، اتّبِع الخطوات التالية:
- أضِف الحقل
localizedValuesإلى السمةfieldsالخاصة بـComputeRoutesRequest. - يمكنك اختياريًا تحديد اللغة ونظام الوحدات باستخدام السمتَين
languageCodeوunitsالخاصتَين بالسمةComputeRoutesRequest.
في ما يلي مثال على طلب القيم المترجَمة:
const requestWithLocalizedValues = { origin: 'San Diego, CA', destination: 'Ensenada, MX', travelMode: 'DRIVING', language: 'es', units: google.maps.UnitSystem.METRIC, fields: ['path', 'localizedValues', 'distanceMeters', 'durationMillis'], };
إذا لم تحدّد اللغة أو نظام الوحدات، ستستنتج الطريقة computeRoutes وحدات الموقع الجغرافي والمسافة من نقطة الطريق الأصلية. لذلك، عند إرسال طلب توجيه في الولايات المتحدة، تستنتج واجهة برمجة التطبيقات en-US اللغة وIMPERIAL الوحدات.
لقراءة القيم المترجمة، استخدِم route.localizedValues. على سبيل المثال:
const localizedValues = route.localizedValues; const distance = localizedValues.distanceMeters; const duration = localizedValues.duration; const durationStatic = localizedValues.staticDuration;