Pesquisar no trajeto

Para usar a Text Search (nova) para pesquisar ao longo de um trajeto, transmita o trajeto pré-calculado da Routes API na solicitação como uma polilinha. A resposta contém lugares que correspondem aos critérios de pesquisa e também estão localizados perto do trajeto especificado.

Para pesquisar ao longo de um trajeto:

1. Use a Routes API para calcular um trajeto que retorne a polilinha codificada de um trajeto na resposta.

   Observação: também é possível codificar sua própria polilinha, conforme descrito em Formato do algoritmo de polilinhas codificadas.

2. Use o parâmetro searchAlongRouteParameters.polyline.encodedPolyline para transmitir a polilinha codificada do trajeto para a Text Search (nova) para influenciar os resultados da pesquisa no trajeto. A resposta contém lugares que correspondem aos critérios de pesquisa e também estão localizados perto do trajeto especificado.

O APIs Explorer permite fazer solicitações em tempo real para que você possa se familiarizar com a API e as opções dela:

Faça um teste

Por padrão, a Text Search (nova) realiza a pesquisa ao longo de todo o trajeto da origem ao destino, conforme definido pela polilinha. No exemplo a seguir, a polilinha define o trajeto de:

• Origem: 1600 Amphitheatre Parkway, Mountain View, CA
• Destino: 24 Willie Mays Plaza, São Francisco, CA

A polilinha codificada da viagem para esse trajeto é representada pela string:

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

Observação: a pesquisa ao longo do trajeto só oferece suporte a uma polilinha codificada, que pode ser transmitida como uma string e inclui compactação com perda mínima. Essa é a saída padrão da Routes API. Para mais informações, consulte Solicitar polilinhas de trajeto.

O exemplo a seguir usa a polilinha codificada do trajeto para influenciar os resultados da pesquisa:

  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'

A resposta contém os lugares que correspondem aos critérios de pesquisa, influenciados pelo trajeto:

  {
    "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"
        }
      },
      /.../
    ]
  }

Não é necessário influenciar os resultados para todo o trajeto. Por exemplo, você já pode estar na metade do trajeto antes de realizar a pesquisa. Nesse caso, é possível especificar uma origem de roteamento explícita para a pesquisa a fim de substituir a origem definida na polilinha codificada. No exemplo a seguir, você especifica as coordenadas de latitude e longitude de San Mateo, CA, que fica aproximadamente na metade da polilinha do trajeto:

  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'

Observação: como a pesquisa ao longo do trajeto retorna lugares com tempos de desvio mínimos da origem ao destino, nos casos em que a origem e o destino do trajeto são iguais ou próximos um do outro, a pesquisa ao longo do trajeto pode não retornar nenhum resultado.

Faça um teste

O APIs Explorer permite fazer solicitações de amostra para que você possa se familiarizar com a API e as opções dela.

1. Selecione o ícone da API api no lado direito da página.

2. Opcionalmente, edite os parâmetros da solicitação.

3. Selecione o botão Executar. Na caixa de diálogo, escolha a conta que você quer usar para fazer a solicitação.

4. No painel do APIs Explorer, selecione o ícone de tela cheia fullscreen para expandir a janela do APIs Explorer.