نظرة عامة على ميزة "البحث على طول المسار"

تتوفّر ميزات "البحث على طول المسار" في واجهات برمجة التطبيقات التالية في Places API (الإصدار الجديد):

• البحث النصي (جديد) فقط: البحث عن أماكن على طول مسار رحلة محدّد مسبقًا.
• "البحث النصي (الجديد)" و"البحث في الجوار (الجديد)": يتم احتساب ملخّص المسار من موقع جغرافي محدّد لنقطة انطلاق المسار إلى كل مكان في نتائج البحث.
• "البحث النصي (الجديد)" فقط: احتسِب ملخّص المسار لكل مكان على طول مسار رحلة محدّد مسبقًا.

البحث على طول مسار

يمكنك استخدام Routes API لاحتساب مسار الرحلة بين موقعَين جغرافيَّين. يمكن لواجهة برمجة التطبيقات Routes API احتساب مسار لسيارة أو دراجة هوائية أو مركبة ذات عجلتين أو نظام نقل عام أو للمشي.

تتيح لك خدمة البحث النصي (الجديدة) استخدام هذا المسار المحسوب لإجراء بحث على طول المسار. باستخدام هذا الخيار، يمكنك تمرير المسار المحسوب مسبقًا من Routes API إلى طلب "البحث النصي (جديد)". وتتضمّن الاستجابة بعد ذلك الأماكن التي تطابق معايير البحث وتقع أيضًا بالقرب من المسار المحدّد.

يشبه البحث على طول مسار استخدام خيارات طلب locationRestriction أو locationBias لتوجيه نتائج البحث. locationRestriction تعرض نتائج البحث التي تقع ضمن حدود إطار العرض، بينما locationBias قد تعرض نتائج البحث خارج إطار العرض. ومع ذلك، في حين أنّ الخيارَين locationBias وlocationRestriction يتيحان لك تحديد منطقة لتوجيه نتائج البحث، تتيح لك ميزة "البحث على طول المسار" في "البحث النصي" أيضًا توجيه نتائج البحث لتشمل تلك التي تتضمّن الحدّ الأدنى من أوقات الانحراف عن المسار من نقطة انطلاق المسار إلى وجهته. يمكنك تحسين نتائج البحث باستخدام locationBias أو locationRestriction مع الخطوط المتعدّدة.

على سبيل المثال، لنفترض أنّ المسار من نقطة الانطلاق، التي يُشار إليها باسم نقطة على المسار في Routes API، إلى الوجهة كما تحتسبها Routes API:

عند البحث على طول المسار، يكون البحث منحازًا لعرض الأماكن القريبة من المسار مع الحد الأدنى من أوقات الانعطاف من نقطة الانطلاق إلى الوجهة. في هذا المثال، النقاط "أ" و"ب" و"ج" هي الأماكن التي تظهر في نتائج البحث.

احتساب ملخّص المسار

يمكن لكلّ من Text Search (New) وبحث في الجوار (New) احتساب ملخّص المسار، أي المدة والمسافة، لكل مكان في الردّ استنادًا إلى الموقع الجغرافي المحدّد لنقطة انطلاق المسار في الطلب. عند تحديد نقطة انطلاق المسار، لا تتضمّن الاستجابة قائمة بالأماكن التي تتطابق مع البحث فحسب، بل تتضمّن أيضًا مدة الرحلة والمسافة من نقطة انطلاق المسار إلى كل مكان.

في الصورة التالية، النقاط "أ" و"ب" و"ج" هي أماكن يتم عرضها في ردّ البحث:

بالنسبة إلى كل مكان في النتائج، يتضمّن الردّ مدة الرحلة والمسافة من نقطة انطلاق المسار إلى المكان، إذا كانت هذه المعلومات متاحة.

يتم احتساب مدة الرحلة والمسافة تلقائيًا باستخدام الخيار TRAFFIC_UNAWARE في Routes API. يمكنك اختياريًا ضبط إعدادات المسار المفضّلة لتأخذ في الاعتبار أحوال حركة المرور المباشرة TRAFFIC_AWARE_OPTIMAL أو أحوال حركة المرور المباشرة مع تقليل وقت الاستجابة TRAFFIC_AWARE أثناء العمليات الحسابية.

لمحة عن المسارات والمراحل والنقاط على المسار

يتألف المسار من عدة مكوّنات، كما تحتسبها Routes API:

يتكوّن المسار من المكوّنات التالية:

• Waypoint: لاحتساب مسار، عليك تحديد المواقع الجغرافية لنقطة الانطلاق والوجهة كحدّ أدنى. ويمكنك تحديد هذه المواقع الجغرافية على أنّها نقاط على المسار. النقاط على المسار الوسيطة هي المواقع الجغرافية بين نقطة الانطلاق والوجهة التي تريد أن يمرّ المسار من خلالها.

• المسار: الرحلة بأكملها من نقطة الانطلاق على المسار، مرورًا بأي نقاط وسيطة على المسار، إلى نقطة الوصول على المسار. يتكوّن المسار من مرحلة واحدة أو أكثر.

  عند تمرير مسار إلى "البحث النصي"، عليك تمرير الخطوط المتعدّدة المرمّزة للمسار كما تعرضها Routes API. الخطوط المتعدّدة المرمّزة هي قائمة مرمّزة من نقاط خطوط العرض وخطوط الطول تتيح لك تمثيل الخطوط المتعدّدة للمسار كسلسلة.

• الجزء: المسار من نقطة على المسار إلى النقطة التالية على المسار. يتكوّن كل جزء من خطوة واحدة أو أكثر.

  يحتوي المسار على جزء منفصل للمسار من كل نقطة على المسار إلى النقطة التالية. على سبيل المثال، إذا كان المسار يحتوي على نقطة انطلاق واحدة ونقطة وجهة واحدة، فإنّ المسار يحتوي على جزء واحد.

  لكل نقطة إضافية على المسار تضيفها إلى المسار بعد نقطة الانطلاق والوجهة، والتي تُعرف باسم نقطة متوسطة على المسار، تضيف واجهة برمجة التطبيقات جزءًا منفصلاً.

لمزيد من المعلومات حول المسارات وحسابها، يُرجى الاطّلاع على Routes API.

احتساب ملخّص المسار باستخدام ميزة "البحث على طول المسار"

يمكنك دمج عمليات احتساب ملخّص المسار مع البحث على طول مسار. في هذه الحالة، تعرض خدمة البحث النصي (الجديد) مدة الرحلة والمسافة إلى كل مكان في الردّ، ثم من كل مكان إلى الوجهة النهائية للمسار. يمكنك اعتبار هذه العملية الحسابية بمثابة توفير مدة السفر والمسافة إذا انحرفت عن المسار المحدّد للانتقال إلى مكان في نتائج البحث، ثم واصلت الانتقال إلى الوجهة النهائية.

على سبيل المثال، إليك المسار التالي من نقطة الانطلاق إلى الوجهة كما تحسبه واجهة برمجة التطبيقات Routes API. أرسِل هذا المسار إلى Text Search (New) API مع معايير البحث.

في هذا المثال، الموقع الجغرافي "أ" هو مكان يتم عرضه في نتائج البحث من "البحث النصي (الجديد)". بالنسبة إلى كل مكان في الاستجابة، يتضمّن البحث المدة والمسافة اللازمتَين للانعطاف إلى ذلك المكان كـ رحلة من مرحلتَين:

• يحتوي الجزء الأول على مدة السفر والمسافة من نقطة انطلاق المسار إلى المكان. في هذا المثال، من المصدر إلى المكان "أ".
• يحتوي الجزء الثاني على مدة السفر والمسافة من المكان إلى وجهة المسار. في هذا المثال، من A إلى الوجهة.

من المعلومات الواردة في الردّ، يمكنك بعد ذلك احتساب مدة الانعطاف والمسافة، حيث:

• ‫ \(t_{OD}\) هي مدة الرحلة من نقطة الانطلاق إلى الوجهة، و \(s_{OD}\) هي مسافة الرحلة من نقطة الانطلاق إلى الوجهة
• ‫ \(t_{OA}\) هي مدة الرحلة من نقطة الانطلاق إلى النقطة "أ"، و \(s_{OA}\) هي مسافة الرحلة من نقطة الانطلاق إلى النقطة "أ".
• ‫ \(t_{AD}\) هي مدة الرحلة من النقطة "أ" إلى الوجهة ‫ \(s_{AD}\) هي مسافة الرحلة من النقطة "أ" إلى الوجهة

مدة المسار البديل هي فرق المدة بين الرحلة الأصلية (من نقطة الانطلاق إلى الوجهة) والرحلة الجديدة (من نقطة الانطلاق إلى الوجهة عبر النقطة "أ"):

مسافة الانحراف هي فرق المسافة بين الرحلة الأصلية (من نقطة الانطلاق إلى الوجهة) والرحلة الجديدة (من نقطة الانطلاق إلى الوجهة عبر النقطة "أ"):