طلب قيم مترجَمة

قِيم الردود المترجَمة هي حقل ردود إضافي يوفّر نصًا مترجَمًا لقيم المَعلمات التي تم إرجاعها. يتم توفير نص مترجَم لمدة الرحلة والمسافة ونظام الوحدات (متري أو إمبراطوري). يمكنك طلب قيم مترجمة باستخدام قناع حقل، ويمكنك تحديد اللغة ونظام الوحدات أو استخدام القيم التي تستنتجها واجهة برمجة التطبيقات. لمزيد من التفاصيل، راجِع LocalizedValues.

على سبيل المثال، إذا حدّدت رمز اللغة الألمانية (de) ووحدات القياس الإنجليزية، ستحصل على قيمة distanceMeters تبلغ 49889.7، بالإضافة إلى نص مترجَم يقدّم قياس المسافة باللغة الألمانية ووحدات القياس الإنجليزية، أي "31 Meile".

في ما يلي مثال على القيم المترجَمة التي ستظهر لك:

{ "localized_values":
  {
    "distance": { "text": "31,0 Meile/n" },
    "duration": { "text": 38 Minuten}.
    "static_duration": { "text": 36 Minuten}.
  }
}

في حال عدم تحديد اللغة أو نظام الوحدات، تستنتج واجهة برمجة التطبيقات اللغة والوحدات على النحو التالي:

• تستنتج الطريقة ComputeRoutes وحدات الموقع الجغرافي والمسافة من نقطة الطريق الأصلية. لذلك، بالنسبة إلى طلب توجيه في الولايات المتحدة، تستنتج واجهة برمجة التطبيقات en-US اللغة وIMPERIAL الوحدات.
• يتم تلقائيًا ضبط طريقة ComputeRouteMatrix على اللغة "en-US" ووحدات القياس المترية.

لطلب قيم معدَّلة بما يناسب المنطقة المحلية

لتضمين قيم مترجَمة في الردّ، عليك اتّباع الخطوات التالية:

1. اطلب قيمًا معدَّلة بما يناسب المنطقة المحلية في قناع الحقل. على سبيل المثال:

   REST

   -H X-Goog-FieldMask: routes.localizedValues

   RPC

   const (fieldMask = "routes.localizedValues")

2. إذا كنت تريد القيم المترجَمة بلغة أو نظام وحدات معيّنَين، حدِّد رمز اللغة ونظام الوحدات:

   "languageCode": "language_code",
   "units": "METRIC | IMPERIAL",

   على سبيل المثال، يحدّد مقتطف الرمز التالي اللغة الألمانية (de) ووحدات القياس المترية:

   "languageCode": "de",
   "units": "METRIC",

   لمزيد من المعلومات، يُرجى الاطّلاع على اللغات المتاحة.

مثال على الطلب

curl -X POST -d '{
  "origin": { "location": {
    "latLng": { "latitude": 37.7873146, "longitude": -122.4159327 } }
  },
  "destination": { "location": {
    "latLng": { "latitude": 37.7621008, "longitude": -122.4382503 } }
  },
  "travelMode": "DRIVE",
  "computeAlternativeRoutes": true,
  "languageCode": "de",
  "units": "METRIC"
}' \
-H 'Content-Type: application/json' \
-H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: routes.localizedValues' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

مثال على إجابة

تعرض الاستجابة قيمًا مترجمة للحقول distance وduration وstaticDuration:

{
    "localizedValues": {
        "distance": {
            "text": "15,5 km"
         },
        "duration": {
            "text": "16 Minuten"
        },
        "staticDuration": {
            "text": "16 Minuten"
        }
    }
}