البحث عن أماكن على طريقك
لاستخدام البحث النصي (الجديد) من أجل البحث على طول مسار معيّن، عليك تمرير المسار المحسوب مسبقًا من 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 على يسار الصفحة.
يمكنك تعديل مَعلمات الطلب إذا أردت.
انقر على الزر تنفيذ. في مربّع الحوار، اختَر الحساب الذي تريد استخدامه لتقديم الطلب.
في لوحة "مستكشف واجهات برمجة التطبيقات"، انقر على رمز ملء الشاشة ملء الشاشة لتوسيع نافذة "مستكشف واجهات برمجة التطبيقات".