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

כדי להשתמש בחיפוש טקסט (חדש) לחיפוש לאורך מסלול, מעבירים את המסלול שחושב מראש מ-Routes API בבקשה כקו פוליגוני. התשובה מכילה מקומות שתואמים לקריטריונים של החיפוש, וגם נמצאים ליד המסלול שצוין.

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

1. משתמשים ב-Routes API כדי לחשב מסלול שמחזיר קו פוליגוני מקודד של המסלול בתגובה.

   הערה: אתם יכולים גם לקודד קו פוליגוני משלכם, כמו שמתואר במאמר פורמט של אלגוריתם של קו פוליגוני מקודד.

2. משתמשים בפרמטר searchAlongRouteParameters.polyline.encodedPolyline כדי להעביר את הקו הפוליגוני המקודד של המסלול לחיפוש טקסט (חדש) כדי להטות את תוצאות החיפוש למסלול. התשובה מכילה מקומות שתואמים לקריטריונים של החיפוש, וגם ממוקמים בקרבת המסלול שצוין.

בעזרת APIs Explorer אתם יכולים לשלוח בקשות בזמן אמת כדי להכיר את ה-API ואת האפשרויות שלו:

כדאי לנסות!

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

• מקור: 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'

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

רוצה לנסות?

‫APIs Explorer מאפשר לכם לשלוח בקשות לדוגמה כדי להכיר את ה-API ואת האפשרויות שלו.

1. לוחצים על סמל ה-API‏ api בצד שמאל של הדף.

2. אפשר לערוך את פרמטרים הבקשה.

3. לוחצים על הכפתור Execute (הפעלה). בתיבת הדו-שיח, בוחרים את החשבון שבו רוצים להשתמש כדי לשלוח את הבקשה.

4. בחלונית APIs Explorer, לוחצים על סמל המסך המלא מסך מלא כדי להרחיב את החלון של APIs Explorer.