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

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

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

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

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

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

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

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

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

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

Powered by Google, ©YEAR Google

برای مثال:

Powered by Google, ©2023 Google

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

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

برای مثال، مسیر در پاسخ شامل موارد زیر است:

"originIndex": 1,
"destinationIndex": 0

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

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

"originIndex": 4,
"destinationIndex": 1

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

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

پاسخ API حاوی آرایه‌ای است که در آن هر عنصر آرایه مسیر را از یک ایستگاه بین راهی مبدأ به یک ایستگاه بین راهی مقصد تعریف می‌کند. این عناصر در 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)
    }
  }
  …
]