경로를 따라 검색

텍스트 검색 (신규)을 사용하여 경로를 따라 검색하려면 요청에 Routes API에서 사전 계산된 경로를 다중선으로 전달합니다. 응답에는 검색 기준과 일치하고 지정된 경로 근처에 있는 장소가 포함됩니다.

경로를 따라 검색하려면 다음 단계를 따르세요.

  1. Routes API를 사용하여 응답에서 경로의 인코딩된 폴리라인을 반환하는 경로를 계산합니다.

  2. searchAlongRouteParameters.polyline.encodedPolyline 매개변수를 사용하여 경로의 인코딩된 다중선 객체를 텍스트 검색 (신규)에 전달하여 검색 결과를 경로에 편향되도록 합니다. 그러면 응답에는 검색 기준과 일치하고 지정된 경로 근처에 있는 장소가 포함됩니다.

API 탐색기를 사용하면 API 및 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

다음 예에서는 경로의 인코딩된 다중선 좌표를 사용하여 검색 결과에 편향을 적용합니다.

  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'
이전
개요
다음
경로 계산 요약