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

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

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

في ما يلي مثال لما يمكن أن تراه في القيم المترجمة:

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

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

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

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

لتضمين القيم المترجَمة في الردّ، عليك إجراء ما يلي:

1. اطلب قيمًا مترجَمة في قناع الحقل. مثال:

   وقت الاستراحة

   -H X-Goog-FieldMask: routes.localized_values

   استدعاء إجراء عن بُعد (RPC)

   const (fieldMask = "routes.localized_values")

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

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

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

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

   "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.localized_values' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

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

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

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