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

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

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

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

لتضمين قيم مترجَمة في الردّ، عليك إجراء ما يلي:

  1. اطلب قيمًا معدَّلة بما يناسب المنطقة المحلية في قناع الحقل. على سبيل المثال:

    REST

    -H X-Goog-FieldMask: localizedValues

    RPC

    const (fieldMask = "localizedValues")

  2. إذا كنت تريد القيم المترجَمة بلغة أو نظام وحدات معيّنَين، حدِّد رمز اللغة ونظام الوحدات:

    "languageCode": "language_code",
"units": "METRIC | IMPERIAL",

    على سبيل المثال، يحدّد مقتطف الرمز هذا اللغة على أنّها الألمانية (de) والوحدات المترية:

    "languageCode": "de",
"units": "METRIC",

    لمزيد من المعلومات، يُرجى الاطّلاع على اللغات المتاحة.