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

מפתחים באזור הכלכלי האירופי (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: routes.localizedValues

    RPC

    const (fieldMask = "routes.localizedValues")

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

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

    לדוגמה, קטע הקוד הבא מציין את השפה כגרמנית (de) ואת היחידות כשיטה המטרית:

    "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"
        }
    }
}