پاسخ ماتریس مسیر را مرور کنید

درخواست ماتریس مسیر، آرایه ای از ایستگاه های مسیر مبدا و مقصد را به عنوان ورودی می گیرد. سپس Routes API مسیر را از هر نقطه راه مبدأ به هر ایستگاه مقصد محاسبه می کند. به عنوان مثال، اگر شما دو نقطه راه مبدا و دو نقطه بین مقصد را مشخص کنید، API سپس چهار مسیر جداگانه را محاسبه می کند.

پاسخ API حاوی یک آرایه است که در آن هر عنصر آرایه مربوط به مسیر از یک نقطه راه مبدأ به یک نقطه بین مقصد است. بنابراین، اگر دو نقطه مسیر مبدا و دو نقطه بین مقصد را مشخص کنید، آرایه پاسخ شامل چهار عنصر است، یکی برای هر مسیر محاسبه شده.

با استفاده از پاسخ، می توانید گزینه های مسیر متفاوتی را در اختیار مشتریان خود قرار دهید و سپس به کاربر اجازه دهید مسیر مناسب را با توجه به نیاز خود انتخاب کند.

درباره ماسک های میدانی

وقتی متدی را برای محاسبه مسیر فراخوانی می‌کنید، باید یک فیلد ماسک را مشخص کنید که مشخص می‌کند کدام فیلدها را می‌خواهید در پاسخ برگردانید. هیچ لیست پیش فرضی از فیلدهای برگشتی وجود ندارد. اگر این لیست را حذف کنید، متدها با خطا مواجه می شوند.

مثال‌های این سند کل شی پاسخ را بدون در نظر گرفتن ماسک‌های فیلد نشان می‌دهند. در یک محیط تولید، پاسخ شما فقط شامل فیلدهایی می شود که به صراحت در فیلد ماسک مشخص کرده اید.

برای اطلاعات بیشتر، به انتخاب اطلاعاتی که باید بازگردانده شود مراجعه کنید.

درباره نمایش حق چاپ

هنگام نمایش نتایج به کاربران خود باید عبارت حق چاپ زیر را درج کنید:

Powered by Google, © YEAR Google

به عنوان مثال:

Powered by Google, ©2023 Google

مسیر را در پاسخ مشخص کنید

برای شناسایی هر مسیر در پاسخ از ویژگی های پاسخ originIndex و destinationIndex استفاده کنید. این ویژگی ها شامل شاخص صفر مبدأ ورودی و ایستگاه های مقصد ورودی است که برای محاسبه مسیر استفاده می شود. این بدان معناست که اولین نقطه راه مبدا و اولین نقطه بین مقصد در درخواست در آرایه شاخص 0 قرار دارند.

به عنوان مثال، یک مسیر در پاسخ شامل:

"originIndex": 1,
"destinationIndex": 0

این ویژگی ها نشان می دهد که مسیر از نقطه راه مبدا در شاخص 1 در آرایه ورودی و از نقطه بین مقصد در شاخص 0 محاسبه شده است.

برای مسیر بعدی:

"originIndex": 4,
"destinationIndex": 1

مسیر از نقطه راه مبدا در شاخص 4 در آرایه ورودی، و از نقطه راه مقصد در شاخص 1 در آرایه ورودی محاسبه شد.

در مورد پاسخ

شی JSON که پاسخ API را نشان می دهد حاوی یک آرایه است که در آن هر عنصر آرایه مسیر را از یک نقطه راه مبدا به یک نقطه بین مقصد تعیین می کند.

همراه با ویژگی های originIndex و destinationIndex ، هر مسیر حاوی اطلاعاتی خاص برای آن مسیر است، مانند distanceMeters ، duration و travelAdvisory .

پاسخ به شکل زیر است:

[
  // One array element for each combination of origin and destination waypoints.
  {
    // The route for source waypoint 0 and destination waypoint 0.
    "originIndex": 0,
    "destinationIndex": 0,
    "status": {
      object (Status)
    },
    "condition": enum (RouteMatrixElementCondition),
    "distanceMeters": integer,
    "duration": string,
    "staticDuration": string,
    "travelAdvisory": {
      object (RouteTravelAdvisory)
    },
    "fallbackInfo": {
      object (FallbackInfo)
    }
  }
  {
    // The route for source waypoint 0 and destination waypoint 1.
    "originIndex": 0,
    "destinationIndex": 1,
    "status": {
      object (Status)
    },
    "condition": enum (RouteMatrixElementCondition),
    "distanceMeters": integer,
    "duration": string,
    "staticDuration": string,
    "travelAdvisory": {
      object (RouteTravelAdvisory)
    },
    "fallbackInfo": {
      object (FallbackInfo)
    }
  }
  …
]