کار با پلی‌لاین‌ها

توسعه‌دهندگان منطقه اقتصادی اروپا (EEA)

متد computeRoutes مسیری را که توسط یک چندخطی به عنوان بخشی از پاسخ نمایش داده می‌شود، برمی‌گرداند. شما می‌توانید دو نوع چندخطی درخواست کنید:

  • چندخطی پایه (پیش‌فرض) ، نشان‌دهنده یک مسیر است اما بدون اطلاعات ترافیکی تعبیه‌شده در چندخطی. درخواست‌هایی که یک چندخطی پایه را برمی‌گردانند، با نرخ پایه مسیرها محاسبه می‌شوند. درباره محاسبه هزینه برای API مسیرها بیشتر بدانید.
  • چندخطی آگاه از ترافیک ، حاوی اطلاعاتی در مورد شرایط ترافیک در طول مسیر است. شرایط ترافیک بر اساس دسته‌های سرعت ( NORMAL ، SLOW ، TRAFFIC_JAM ) که در یک بازه مشخص از چندخطی قابل اجرا هستند، بیان می‌شوند. درخواست‌های مربوط به چندخطی آگاه از ترافیک با نرخ ترجیحی مسیرها محاسبه می‌شوند. درباره محاسبه هزینه برای API مسیرها بیشتر بدانید.
  • چندخطی چندوجهی ، شامل جزئیات حمل و نقل و همچنین اطلاعات ترافیکی است. درخواست‌های چندخطی چندوجهی با نرخ ترجیحی مسیرها محاسبه می‌شوند. درباره محاسبه هزینه برای API مسیرها بیشتر بدانید.

چندخطی پایه (پیش‌فرض)

یک چندخطی توسط یک شیء Polyline نمایش داده می‌شود؛ یک مسیر آرایه‌ای از مختصات LatLngAltitude است. برای برگرداندن یک چندخطی ساده، متد computeRoutes را با خاصیت fields که روی path تنظیم شده است، فراخوانی کنید، سپس متد createPolylines را روی نمونه مسیر فراخوانی کنید تا یک شیء Polyline دریافت کنید.

مثال زیر نحوه درخواست یک چندخطی ساده را نشان می‌دهد:

// Define a basic routes request.
const requestWithBasicPolyline = {
  origin: '155 Steuart St, San Francisco, CA 94105',
  destination: '450 Powell St, San Francisco, CA 94102',
  travelMode: 'WALKING',
  fields: ['path'],  // Request path field to get a polyline.
};

چندخطی آگاه از ترافیک

برای درخواست یک چندخطی آگاه از ترافیک، ویژگی‌های زیر را به درخواست خود اضافه کنید:

  1. ویژگی travelMode را روی DRIVING تنظیم کنید.
  2. ویژگی routingPreference را روی TRAFFIC_AWARE تنظیم کنید.
  3. ویژگی extraComputations را روی TRAFFIC_ON_POLYLINE تنظیم کنید.
  4. فیلدهای path ، speedPaths و routeLabels را مشخص کنید.

مثال زیر نحوه درخواست یک چندخطی آگاه از ترافیک را نشان می‌دهد:

// Define a traffic aware routes request.
const requestWithTraffic = {
  origin: '200 King St San Francisco, CA 94107',
  destination: 'Pier 41, San Francisco, CA 94133',
  travelMode: 'DRIVING',
  routingPreference: 'TRAFFIC_AWARE',
  extraComputations: ['TRAFFIC_ON_POLYLINE'],
  fields: ['speedPaths'],
};

نمایش چندخطی‌ها روی نقشه

برای نمایش چندخطی‌ها روی نقشه، تابع createPolylines روی شیء مسیر فراخوانی کنید، سپس از متد setMap برای تنظیم نقشه چندخطی روی شیء نقشه استفاده کنید. شیء نقشه برای نمایش چندخطی روی نقشه استفاده می‌شود.

مثال زیر نحوه نمایش یک چندخطی روی نقشه را نشان می‌دهد:

  // Call createPolylines to create polylines for the first route.
  mapPolylines = routes[0].createPolylines();
  // Add polylines to the map.
  mapPolylines.forEach((polyline) => polyline.setMap(map));