沿路線搜尋

如要使用Text Search (新版) 沿途搜尋，請在要求中傳遞來自 Routes API 的預先計算路徑做為折線。回覆包含符合搜尋條件，且位於指定路線附近的地點。

如要沿路線搜尋，請按照下列步驟操作：

1. 使用 Routes API 計算路線，在回應中傳回路線的編碼折線。

   注意：您也可以按照編碼折線演算法格式所述，自行編碼折線。

2. 使用 searchAlongRouteParameters.polyline.encodedPolyline 參數將路線的編碼折線傳遞至 Text Search (New)，以便根據路線調整搜尋結果。回覆會包含符合搜尋條件，且位於指定路線附近的地點。

您可以使用 APIs Explorer 提出即時要求，熟悉 API 和 API 選項：

試試看！

根據預設，Text Search (新版) 會沿著折線定義的整條路線 (從起點到目的地) 執行搜尋。在下列範例中，折線定義的路線是從：

• 來源：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 和 API 選項。

1. 選取頁面右側的 API 圖示 api。

2. 視需要編輯要求參數。

3. 選取「Execute」按鈕。在對話方塊中，選擇要用來提出要求的帳戶。

4. 在 APIs Explorer 面板中，選取全螢幕圖示 fullscreen 即可展開 APIs Explorer 視窗。