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

لاستخدام البحث النصي (جديد) للبحث على طول مسار، عليك تمرير المسار المحسوب مسبقًا من 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

ملاحظة: لا يتيح البحث على طول المسار سوى استخدام خط متعدّد الأضلاع مشفَّر، والذي يمكن تمريره كسلسلة ويتضمن ضغطًا بأقل قدر من الخسارة. هذا هو الإخراج التلقائي لواجهة برمجة التطبيقات Routes API. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة طلب مسار خطوط متعددة.

يستخدِم المثال التالي الخطوط المتعددة المشفّرة للمسار من أجل توجيه نتائج البحث:

  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'

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