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

مقادیر پاسخ موضعی یک فیلد پاسخ اضافی است که متن محلی را برای مقادیر پارامترهای برگشتی ارائه می دهد. متن محلی برای مدت زمان سفر، مسافت و سیستم واحد (متریک یا امپریالیستی) ارائه شده است. شما با استفاده از یک فیلد ماسک، مقادیر محلی را درخواست می کنید، و می توانید زبان و سیستم واحد را مشخص کنید یا از مقادیر استنتاج شده توسط 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. مقادیر محلی شده را در ماسک فیلد خود درخواست کنید. به عنوان مثال:

    استراحت

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