경로를 따라 검색
텍스트 검색 (신규)을 사용하여 경로를 따라 검색하려면 요청에서 Routes API의 미리 계산된 경로를 폴리라인으로 전달합니다. 응답에는 검색 기준과 일치하고 지정된 경로 근처에 있는 장소가 포함됩니다.
경로를 따라 검색하려면 다음 단계를 따르세요.
-
Routes API를 사용하여 응답에서 경로의 인코딩된 폴리라인을 반환하는 경로를 계산합니다.
-
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'사용해 보기
API 탐색기를 사용하면 샘플 요청을 할 수 있으므로 API 및 API 옵션에 익숙해질 수 있습니다.
페이지 오른쪽에 있는 API 아이콘 api 을 선택합니다.
필요에 따라 요청 매개변수를 수정합니다.
실행 버튼을 선택합니다. 대화상자에서 요청을 실행하는 데 사용할 계정 을 선택합니다.
API 탐색기 패널에서 전체 화면 아이콘 fullscreen을 선택하여 API 탐색기 창을 펼칩니다.