مقادیر محلی را درخواست کنید

مقادیر پاسخ محلی‌شده، یک فیلد پاسخ اضافی هستند که متن محلی‌شده را برای مقادیر پارامترهای برگشتی ارائه می‌دهند. متن محلی‌شده برای مدت زمان سفر، مسافت و سیستم واحد (متریک یا امپریال) ارائه می‌شود. شما با استفاده از یک ماسک فیلد، مقادیر محلی‌شده را درخواست می‌کنید و می‌توانید زبان و سیستم واحد را مشخص کنید یا از مقادیر استنباط‌شده توسط API استفاده کنید. برای جزئیات بیشتر، به LocalizedValues ​​مراجعه کنید.

برای مثال، اگر کد زبانی را برای واحدهای آلمانی (de) و امپریال مشخص کنید، مقداری برای distanceMeters برابر با ۴۹۸۸۹.۷ دریافت می‌کنید، اما متن محلی‌شده‌ای را نیز دریافت می‌کنید که اندازه‌گیری فاصله را در واحدهای آلمانی و امپریال ارائه می‌دهد، بنابراین "۳۱ 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. مقادیر محلی را در ماسک فیلد خود درخواست کنید. برای مثال:

   استراحت

   -H X-Goog-FieldMask: routes.localizedValues

   آر پی سی

   const (fieldMask = "routes.localizedValues")

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