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

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