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

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

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

• השיטה 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"
        }
    }
}