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

المطوّرون المقيمون في المنطقة الاقتصادية الأوروبية (EEA)

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

    RPC

    const (fieldMask = "routes.localizedValues")

  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.localizedValues' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

مثال على إجابة

يعرض الردّ قيمًا مترجَمة للحقول distance وduration وstaticDuration:

{
    "localizedValues": {
        "distance": {
            "text": "15,5 km"
         },
        "duration": {
            "text": "16 Minuten"
        },
        "staticDuration": {
            "text": "16 Minuten"
        }
    }
}