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

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

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

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

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

   REST

   -H X-Goog-FieldMask: routes.localized_values

   RPC

   const (fieldMask = "routes.localized_values")

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

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

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

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

   "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.localized_values' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

דוגמה לתגובה

התשובה תחזיר ערכים שהותאמו לשוק המקומי עבור distance, duration ו- staticDuration שדות:

{
    "localizedValues": {
        "distance": {
            "text": "15,5 km"
         },
        "duration": {
            "text": "16 Minuten"
        },
        "staticDuration": {
            "text": "16 Minuten"
        }
    }
}