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

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

    متوسط عائد النقرة

    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"
        }
    }
}