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

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