مقادیر پاسخ محلیشده، یک فیلد پاسخ اضافی هستند که متن محلیشده را برای مقادیر پارامترهای برگشتی ارائه میدهند. متن محلیشده برای مدت زمان سفر، مسافت و سیستم واحد (متریک یا امپریال) ارائه میشود. شما با استفاده از یک ماسک فیلد، مقادیر محلیشده را درخواست میکنید و میتوانید زبان و سیستم واحد را مشخص کنید یا از مقادیر استنباطشده توسط API استفاده کنید. برای جزئیات بیشتر، به LocalizedValues مراجعه کنید.
برای مثال، اگر کد زبانی را برای واحدهای آلمانی (de) و امپریال مشخص کنید، مقداری برای distanceMeters برابر با ۴۹۸۸۹.۷ دریافت میکنید، اما متن محلیشدهای را نیز دریافت میکنید که اندازهگیری فاصله را در واحدهای آلمانی و امپریال ارائه میدهد، بنابراین "۳۱ Meile".
برای درخواست مقادیر محلی، مراحل زیر را انجام دهید:
- فیلد
localizedValuesرا به ویژگیfieldsازComputeRoutesRequestاضافه کنید. - به صورت اختیاری، میتوانید زبان و سیستم واحد را با استفاده از ویژگیهای
languageCodeوunitsازComputeRoutesRequestمشخص کنید.
در اینجا مثالی از درخواست مقادیر محلی شده آورده شده است:
const requestWithLocalizedValues = { origin: 'San Diego, CA', destination: 'Ensenada, MX', travelMode: 'DRIVING', language: 'es', units: google.maps.UnitSystem.METRIC, fields: ['path', 'localizedValues', 'distanceMeters', 'durationMillis'], };
اگر زبان یا سیستم واحد را مشخص نکنید، متد computeRoutes موقعیت مکانی و واحدهای فاصله را از نقطه مسیر مبدا استنباط میکند. بنابراین برای یک درخواست مسیریابی در ایالات متحده، API زبان en-US و واحدهای IMPERIAL را استنباط میکند.
برای خواندن مقادیر محلی route.localizedValues استفاده کنید. برای مثال:
const localizedValues = route.localizedValues; const distance = localizedValues.distanceMeters; const duration = localizedValues.duration; const durationStatic = localizedValues.staticDuration;