Combinar resumos de rotas com a pesquisa no trajeto

É possível combinar cálculos de resumo do trajeto com pesquisa ao longo de um trajeto. Nesse caso, a Pesquisa de texto (nova) retorna a duração e a distância da viagem até cada lugar na resposta e, em seguida, de cada lugar até o destino final da rota.

Para usar a Pesquisa de texto (nova) e calcular o resumo do trajeto com a pesquisa ao longo de um trajeto:

1. Use a Routes API para calcular um trajeto que retorna uma polilinha de trajeto na resposta.

2. Use o parâmetro searchAlongRouteParameters.polyline.encodedPolyline para transmitir a polilinha da rota à Pesquisa de texto (nova) e direcionar os resultados da pesquisa para a rota. A resposta contém lugares que correspondem aos critérios de pesquisa e também estão localizados perto da rota especificada.

3. Inclua routingSummaries na máscara de campo para que a resposta inclua a matriz routingSummaries. Essa matriz contém a duração e a distância da origem de roteamento até cada lugar na resposta.

Com o APIs Explorer, você pode fazer solicitações em tempo real para se familiarizar com a API e as opções dela:

Por padrão, a pesquisa de texto (nova) faz a pesquisa em todo o trajeto:

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,routingSummaries' \
'https://places.googleapis.com/v1/places:searchText'

A resposta contém duas matrizes: a matriz places com os lugares correspondentes e a matriz routingSummaries com a duração e a distância para viajar até cada lugar:

{
  "places": [
    {
      "formattedAddress": "1199 El Camino Real, San Bruno, CA 94066, USA",
      "priceLevel": "PRICE_LEVEL_INEXPENSIVE",
      "displayName": {
        "text": "Vegan Mob - Vegan BBQ and Soul Food",
        "languageCode": "en"
      }
    },
    {
      "formattedAddress": "839 Kearny St, San Francisco, CA 94108, USA",
      "priceLevel": "PRICE_LEVEL_MODERATE",
      "displayName": {
        "text": "Enjoy Vegetarian",
        "languageCode": "en"
      }
    },
   …
],
  "routingSummaries": [
    {
      "legs": [
        {
          "duration": "285s",
          "distanceMeters": 1616
        },
        {
          "duration": "2466s",
          "distanceMeters": 58147
        }
      ],
      "directionsUri": "https://www.google.com/maps/dir/37.42268,-122.08473/''/37.77877,-122.38781/data=!4m7!4m6!1m0!1m2!1m1!1s0x808f87f9ede375f5:0xa37171fea1a16b28!1m0!3e0"
    },
    {
      "legs": [
        {
          "duration": "696s",
          "distanceMeters": 4704
        },
        {
          "duration": "2787s",
          "distanceMeters": 58901
        }
      ],
      "directionsUri": "https://www.google.com/maps/dir/37.42268,-122.08473/''/37.77877,-122.38781/data=!4m7!4m6!1m0!1m2!1m1!1s0x808580f4cebdb06f:0xd3af09e5742234f2!1m0!3e0"
    },
   …
  ]
}

Para cada entrada na matriz legs, a Pesquisa de texto (nova) retorna um tempo de viagem de duas pernas:

• O primeiro trecho contém a duração e a distância da viagem da origem até o local. Neste exemplo, a duração e a distância da origem até o primeiro lugar nos resultados são de 285 segundos e 1.616 metros.

• O segundo trecho contém a duração e a distância da viagem do local até o destino da rota. Neste exemplo, a duração e a distância são 2.466 segundos e 58.147 metros.

Especificar a origem do roteamento, o meio de transporte e os modificadores de rota

Você pode modificar o cálculo do resumo de pesquisa e roteamento especificando a origem do roteamento, o modo de viagem, os modificadores de rota e as preferências de roteamento. O modo de viagem e os modificadores de rota funcionam da mesma forma que para calcular resumos de roteamento sem especificar um trajeto, conforme mostrado no tópico Especificar opções de viagem.

Por padrão, o primeiro trecho de cada resultado contém a distância da origem definida pela polilinha até cada lugar. No entanto, é possível substituir esse padrão especificando explicitamente uma origem de roteamento na solicitação. Se especificado, o primeiro trecho de todas as respostas vai indicar as distâncias e a duração da origem de roteamento especificada, substituindo a origem da polilinha.

No exemplo a seguir, você especifica uma origem de roteamento como as coordenadas de San Mateo, CA, especifica para evitar pedágios e define o número de resultados como 5:

  curl -X POST -d '{
    "textQuery" : "Spicy Vegetarian Food",
    "maxResultCount": 5,
    "searchAlongRouteParameters": {
      "polyline": {
        "encodedPolyline": "ROUTE_POLYLINE"
      }
    },
    "routingParameters": {
      "origin": {
        "latitude": 37.56617,
        "longitude": -122.30870
      },
      "travelMode":"DRIVE",
      "routeModifiers": {
        "avoidTolls": true
      }
    }
  }' \
  -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
  -H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.priceLevel,routingSummaries' \
  'https://places.googleapis.com/v1/places:searchText'

A imagem a seguir mostra um mapa com a polilinha do trajeto, a nova origem (alfinete azul-claro) e os lugares nos resultados da pesquisa (alfinetes verdes). Observe como todos os resultados estão ao longo da rota, mas depois de San Mateo:

Confira!

Com o APIs Explorer, você pode fazer solicitações de amostra para se familiarizar com a API e as opções dela.

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

2. Se quiser, 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.