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

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

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

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

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

    REST

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