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

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

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

  1. استخدِم Routes API لاحتساب مسار يعرض مسارًا مشفَّرًا من الخطوط المتعددة في الاستجابة.

  2. استخدِم المَعلمة searchAlongRouteParameters.polyline.encodedPolyline ل تمرير المضلع المشفَّر للمسار إلى "البحث النصي" (جديد) لتوجيه نتائج البحث نحو المسار. يحتوي الردّ بعد ذلك على أماكن تتطابق مع معايير البحث وتقع أيضًا بالقرب من المسار المحدّد.

يتيح لك "مستكشف واجهة برمجة التطبيقات" إرسال طلبات مباشرة حتى تتمكّن من التعرّف على واجهة برمجة التطبيقات وخياراتها:

جرِّبه الآن

بشكلٍ تلقائي، تُجري ميزة "البحث عن نصّ (جديد)" عملية البحث على طول المسار بالكامل من المصدر إلى الوجهة على النحو المحدّد بالخطّ المتعدّد. في المثال التالي، يحدِّد الخطّ المتعدّد المسار من:

  • المصدر: 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'