בקשה לערכים מותאמים לשוק המקומי

מפתחים באזור הכלכלי האירופי (EEA)

ערכי תגובה מקומיים הם שדה תגובה נוסף שמספק טקסט מתורגם עבור ערכי פרמטרים שמוחזרים. טקסט מותאם לשפה המקומית מסופק עבור משך הנסיעה, המרחק ומערכת היחידות (מטרית או אימפריאלית). כדי לבקש ערכים מותאמים לשוק המקומי, משתמשים במסכת שדות. אפשר לציין את השפה ואת מערכת היחידות, או להשתמש בערכים שה-API מסיק. פרטים נוספים זמינים במאמר בנושא LocalizedValues.

לדוגמה, אם מציינים קוד שפה לגרמנית (de) ויחידות מידה אימפריאליות, מקבלים ערך של 49889.7 בשדה distanceMeters, אבל גם טקסט מותאם לשפה המקומית שמספק את מדידת המרחק בגרמנית וביחידות מידה אימפריאליות, כלומר '31 Meile'.

כדי לבקש ערכים מותאמים לשפה ולמיקום:

  1. מוסיפים את השדה localizedValues למאפיין fields של ComputeRoutesRequest.
  2. אפשר לציין את השפה ואת שיטת המדידה באמצעות המאפיינים languageCode ו-units של ComputeRoutesRequest.

דוגמה לבקשה של ערכים שהותאמו לשוק המקומי:

const requestWithLocalizedValues = {
  origin: 'San Diego, CA',
  destination: 'Ensenada, MX',
  travelMode: 'DRIVING',
  language: 'es',
  units: google.maps.UnitSystem.METRIC,
  fields: ['path', 'localizedValues', 'distanceMeters', 'durationMillis'],
};

אם לא מציינים את השפה או את מערכת היחידות, השיטה computeRoutes מסיקה את יחידות המיקום והמרחק מנקודת המוצא. לכן, עבור בקשת ניתוב בארה"ב, ה-API מסיק את en-US השפה IMPERIAL והיחידות.

כדי לקרוא ערכים מותאמים לשפה המקומית, משתמשים בפונקציה route.localizedValues. לדוגמה:

const localizedValues = route.localizedValues;
const distance = localizedValues.distanceMeters;
const duration = localizedValues.duration;
const durationStatic = localizedValues.staticDuration;