نظرة عامة على ميزة "البحث على طول المسار"
تتوفّر ميزات "البحث على طول المسار" في واجهات برمجة التطبيقات التالية من 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):