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

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

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

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

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

{ "localized_values":
  {
    "distance": { "text": "31,0 Meile/n" },
    "duration": { "text": 38 Minuten}.
    "static_duration": { "text": 36 Minuten}.
  }
}

אם לא מציינים את השפה או את מערכת היחידות, המערכת של ה-API מסיקה את השפה והיחידות באופן הבא:

  • השיטה ComputeRoutes מסיקה את המיקום ואת יחידות המרחק מנקודת הציון של המקור. לכן, בבקשת ניתוב בארה"ב, ה-API מסיק את השפה 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",

    מידע נוסף זמין במאמר שפות התמיכה.