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

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