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

מפתחים באזור הכלכלי האירופי (EEA)

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

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

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

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

    REST

    -H X-Goog-FieldMask: routes.localizedValues

    RPC

    const (fieldMask = "routes.localizedValues")

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

דוגמה לתשובה

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

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