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

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

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

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

درباره پوشش‌های فیلد

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

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

برای اطلاعات بیشتر، انتخاب اطلاعات برای برگرداندن را ببینید.

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

هنگام نمایش نتایج به کاربران، باید بیانیه حق نشر زیر را اضافه کنید:

Powered by Google, ©YEAR Google

برای مثال:

Powered by Google, ©2023 Google

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

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

برای مثال، مسیری در پاسخ حاوی این موارد است:

"originIndex": 1,
"destinationIndex": 0

این ویژگی‌ها نشان می‌دهند که مسیر از نقطه‌مسیر مبدأ در نمایه ۱ در آرایه ورودی و از نقطه‌مسیر مقصد در نمایه ۰ محاسبه شده است.

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

"originIndex": 4,
"destinationIndex": 1

مسیر از نقطه‌مسیر مبدأ در نمایه ۴ در آرایه ورودی و از نقطه‌مسیر مقصد در نمایه ۱ در آرایه ورودی محاسبه شده است.

درباره اطلاعات مسیر در پاسخ

پاسخ میانای برنامه‌سازی کاربردی حاوی آرایه‌ای است که در آن هر عنصر آرایه مسیر را از یک نقطه‌مسیر مبدأ به یک نقطه‌مسیر مقصد تعریف می‌کند. این عناصر RouteMatrixElements در روش gRPC یا بدنه پاسخ در پاسخ HTTP هستند.

همراه با ویژگی‌های originIndex و destinationIndex، هر عنصر فقط حاوی اطلاعات پایه مختص آن مسیر است، مثل distanceMeters، duration، و travelAdvisory. برای دریافت اطلاعات دقیق‌تر درباره مسیر، مثلاً چندخطی، از computeRoutes استفاده کنید.

پاسخ این فرم را دارد:

[
  // 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)
    }
  }
  …
]