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

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

   REST

   -H X-Goog-FieldMask: routes.localized_values

   RPC

   const (fieldMask = "routes.localized_values")

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