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

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

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

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

درباره ماسک‌های صحرایی

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

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

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

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

هنگام نمایش نتایج به کاربران، باید عبارت کپی‌رایت زیر را درج کنید:

Powered by Google, © YEAR Google

برای مثال:

Powered by Google, ©2023 Google

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

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

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

"originIndex": 1,
"destinationIndex": 0

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

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

"originIndex": 4,
"destinationIndex": 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)
    }
  }
  …
]