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

ערכי תגובה מתורגמים הם שדה תגובה נוסף שמספק טקסט מתורגם לערכי פרמטרים שהוחזרו. טקסטים מותאמים לשפה המקומית מסופקים עבור משך הנסיעה, המרחק ומערכת היחידות (מטרית או אימפריאלית). אתם מבקשים ערכים מותאמים לשפה באמצעות מסכת שדות, ויכולים לציין את השפה ואת מערכת היחידות או להשתמש בערכים שה-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"
        }
    }
}