التعامل مع الخطوط المتعددة

المطوّرون في المنطقة الاقتصادية الأوروبية

تعرض الطريقة computeRoutes المسار الممثّل بخط متعدد الأضلاع كجزء من الرد. يمكنك طلب نوعَين من الخطوط المتعددة:

  • خطوط متعددة أساسية (تلقائية): تمثّل مسارًا بدون معلومات حركة المرور المضمّنة في الخطوط المتعددة. يتم تحصيل رسوم من الطلبات التي تعرض خطًا متعدد الأضلاع أساسيًا وفقًا لسعر Routes Basic. مزيد من المعلومات حول الفوترة في Routes API
  • الخط المتعدد الأضلاع الذي يتضمّن معلومات عن حركة المرور: يحتوي على معلومات حول أحوال حركة المرور على طول المسار. يتم التعبير عن أحوال حركة المرور من خلال فئات السرعة (NORMAL وSLOW وTRAFFIC_JAM) التي تنطبق على فترة زمنية معيّنة من الخط المتعدد الأضلاع. يتم تحصيل رسوم عن طلبات الخطوط المتعددة الأضلاع التي تراعي حركة المرور وفقًا لسعر "المسارات المفضّلة". مزيد من المعلومات حول الفوترة في Routes API
  • الخط المتعدد الأوضاع: يحتوي على تفاصيل النقل العام بالإضافة إلى معلومات حركة المرور. يتم تحصيل رسوم طلبات الخطوط المتعددة الأنماط بسعر "مسارات Google المفضّلة". مزيد من المعلومات حول الفوترة في Routes 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));