חיפוש לאורך המסלול

כדי להשתמש בחיפוש טקסט (חדש) כדי לחפש לאורך מסלול, מעבירים את המסלול שחושב מראש מ-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'

הערה: מאחר שהחיפוש לאורך המסלול מחזיר מקומות עם זמני עקיפה מינימליים מהמקור ליעד, במקרים שבהם מקור המסלול והיעד זהים או קרובים זה לזה, יכול להיות שלא יוצגו תוצאות בחיפוש לאורך המסלול.