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

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

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

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

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

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

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

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

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

احتساب ملخّص التوجيه

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

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

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

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

لمحة عن المسارات والأجزاء ونقاط المرور

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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