قيم الاستجابة المترجمة هي حقل استجابة إضافي يوفر نصًا مترجمًا لقيم المعلمات التي يتم عرضها. يتم توفير النص المترجَم لمدة الرحلة والمسافة ونظام الوحدة (المتري أو الإمبراطوري). ويمكنك طلب قيم معدَّلة بما يناسب السوق المحلية باستخدام قناع حقل، ويمكنك إما تحديد اللغة ونظام الوحدة أو استخدام القيم التي استنتجناها من واجهة برمجة التطبيقات. لمعرفة التفاصيل، يُرجى الاطّلاع على 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.
لطلب قيم مترجَمة
لتضمين قيم مترجَمة في الرد، عليك تنفيذ ما يلي:
اطلب قيمًا مترجَمة في قناع الحقل. مثلاً:
وقت الاستراحة
-H X-Goog-FieldMask: routes.localized_values
متوسط عائد النقرة
const (fieldMask = "routes.localized_values")
إذا كنت تريد عرض القيم المترجَمة بلغة معيّنة أو نظام وحدات معيّن، حدِّد رمز اللغة ونظام الوحدة:
"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" } } }