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

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