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

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

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

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