البحث على طول المسار
لاستخدام البحث النصي (جديد) للبحث على طول مسار، مرِّر المسار المحسوب مسبقًا من Routes API في الطلب كخط متعدد الأضلاع. تحتوي الاستجابة على أماكن تتطابق مع معايير البحث وتقع أيضًا بالقرب من المسار المحدّد.
للبحث على طول مسار، اتّبِع الخطوات التالية:
-
استخدِم Routes API لاحتساب مسار يعرض خطًا متعدد الأضلاع مشفّرًا للمسار في الردّ.
-
استخدِم المَعلمة
searchAlongRouteParameters.polyline.encodedPolyline
لتمرير خطوط متعددة الأضلاع مشفّرة خاصة بالمسار إلى Text Search (New) من أجل توجيه نتائج البحث نحو المسار. تحتوي الاستجابة بعد ذلك على أماكن تطابق معايير البحث وتقع أيضًا بالقرب من المسار المحدّد.
يتيح لك "مستكشف واجهات برمجة التطبيقات" إرسال طلبات مباشرة لتتعرّف على واجهة برمجة التطبيقات وخياراتها:
تُجري ميزة "البحث النصي (جديد)" البحث تلقائيًا على طول المسار بالكامل من نقطة البداية إلى الوجهة المحدّدة بواسطة الخط المتعدد الأضلاع. في المثال التالي، يحدّد الخط المتعدد الأضلاع المسار من:
- بلد المنشأ: 1600 Amphitheatre Parkway, Mountain View, CA
- الوجهة: 24 Willie Mays Plaza, San Francisco, CA
يتم تمثيل الخط المتعدد المشفّر الخاص بهذه الرحلة من خلال السلسلة التالية:
wblcFptchVIFOd@G@EVw@Ms@dHKR}ApNA`AF~@Hf@TjAb@bBb@~@n@p@^Rd@~@Vz@HVz@nDLt@?d@Kr@c@~@mD`G?`@aEfGkCnDuChDm`@bb@[`@{GhHeEdEciBnnBkC`DkC~DaClEuKjT_Z|l@Qb@iR~_@}EzJ_AdB_Und@kAfCaOjZkg@vcAqBzD_]rr@iBlEaBxEgArD}AlG}AhHsA`IeAnH{@dIq@dJgL~iBq@rHu@vGgAtHwArHaBhHkBzG_DpJ}Nbc@iBhGkA|EgC|LcIjb@oAhG_AvDgAdDkApC_BzCiBpCsFvGii@vn@scAxlAmLjNgSzUeRjT{TzWqExEmG|FuNlMmMhLaRvPqOlNmbAl}@mFlF{PlOmJfIoElE}LtMiSbU_H`I}}@jcAwl@vp@oAbBqA~BeAhCm@tBg@fCWrBQ~BI|DaB~rBO~D[bEa@`Dm@pDaAdE{@vC_BbEkB~Def@|z@sEzHKJeS~]}K`S{\\~l@cXpe@sBpDm@bAuCxDkBrBiC~BwCtByBnAcBx@}Bt@{Bn@gh@|LaOpDeFhAoDj@aE^kVrA_E^iEr@yD~@uBr@gMjF_EnAcCh@eFr@_DRsAD}@Jsu@xCWDqIV}BCeCOyDm@cBa@_DmA}JeE_CwAsBcBiBoBuAqBmOoX{CuEkB_CoDqDkVoUoD{CeE_DkEkC_FeCqB}@sDuAoDgAeCe@cCW}CK}BDaDTeOlBcuBrYaNlBq@Dyd@rGyFt@yBb@eBf@oCnAoBlAkIpGkAp@wBbAaCt@oFdAwKjBoGxA{FbByIjC_HfB_@KmNdDuC|@uFzBcH|C{@\\[?sBv@}@VaBVoA@y@EmAQcA[w@]aBkAeAkA}BuDUKs@uAqBsCwBcCgAiAiN_MyKsJsG{GkBaBiBuA{BwAwDkBcOaHiC_AiCg@}BQcCAcBHqBVkB`@qEjAu@LgCVgAHwG@sG?mABsH^eNr@mBXy@NqBt@uAt@aBlAkAlA}BtCyApBiAdB_BxB{A`B}@j@oAf@s@PeCVcIf@gAAkAQy@YiAo@_A{@_DgEgJqM_DeEaM}PoBiCzAsBw@kAdAGVk@f@q@z@C
يستخدِم المثال التالي خطًا متعدد الأضلاع مشفّرًا خاصًا بالمسار لتحديد نتائج البحث:
curl -X POST -d '{ "textQuery" : "Spicy Vegetarian Food", "searchAlongRouteParameters": { "polyline": { "encodedPolyline": "ROUTE_POLYLINE" } } }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \ -H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.priceLevel' \ 'https://places.googleapis.com/v1/places:searchText'
تحتوي الاستجابة على الأماكن التي تطابق معايير البحث، مع التركيز على المسار:
{ "places": [ { "formattedAddress": "60 Morris St, San Francisco, CA 94107, USA", "priceLevel": "PRICE_LEVEL_MODERATE", "displayName": { "text": "Umami Express", "languageCode": "en" } }, { "formattedAddress": "1130 4th St, San Francisco, CA 94158, USA", "priceLevel": "PRICE_LEVEL_MODERATE", "displayName": { "text": "House of Tadu Ethiopian Kitchen", "languageCode": "en" } }, { "formattedAddress": "1602 El Camino Real Ste A, Belmont, CA 94002, USA", "priceLevel": "PRICE_LEVEL_MODERATE", "displayName": { "text": "Eats Meets West Bowls", "languageCode": "en" } }, /.../ ] }
ليس عليك تحسين النتائج لتشمل المسار بأكمله. على سبيل المثال، قد تكون قد قطعت نصف المسافة قبل إجراء البحث. في هذه الحالة، يمكنك تحديد مصدر توجيه صريح للبحث لتجاوز المصدر المحدّد في الخط المتعدد الأضلاع المرمّز. في المثال التالي، يمكنك تحديد إحداثيات خطوط الطول والعرض لمدينة سان ماتيو، كاليفورنيا، التي تقع في منتصف خطوط متعددة الأضلاع الخاصة بالمسار تقريبًا:
curl -X POST -d '{ "textQuery" : "Spicy Vegetarian Food", "searchAlongRouteParameters": { "polyline": { "encodedPolyline": "ROUTE_POLYLINE" } }, "routingParameters": { "origin": { "latitude": 37.56617, "longitude": -122.30870 } } }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \ -H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.priceLevel' \ 'https://places.googleapis.com/v1/places:searchText'
جرِّبها الآن
يتيح لك "مستكشف واجهات برمجة التطبيقات" تقديم طلبات نموذجية لتتعرّف على واجهة برمجة التطبيقات وخياراتها.
انقر على رمز واجهة برمجة التطبيقات api في يسار الصفحة.
عدِّل مَعلمات الطلب اختياريًا.
انقر على الزر تنفيذ. في مربّع الحوار، اختَر الحساب الذي تريد استخدامه لتقديم الطلب.
في لوحة "مستكشف واجهات برمجة التطبيقات"، انقر على رمز ملء الشاشة fullscreen لتوسيع نافذة "مستكشف واجهات برمجة التطبيقات".