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

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

    "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"
        }
    }
}