Migrar para o Text Search (novo)

Desenvolvedores do Espaço Econômico Europeu (EEE)

Introdução

A API Places (legada) é compatível com a Pesquisa de texto (legada). Se você conhece a pesquisa de texto (legada), a pesquisa de texto (nova) faz as seguintes mudanças:

  • A Pesquisa de texto (nova) usa solicitações HTTP POST. Transmita parâmetros no corpo da solicitação ou em cabeçalhos como parte de uma solicitação HTTP POST. Já com a pesquisa de texto (legada), você transmite parâmetros de URL usando uma solicitação HTTP GET.
  • O mascaramento de campo é obrigatório. Você precisa especificar quais campos quer que sejam retornados na resposta. Não há uma lista padrão de campos retornados. Se você omitir essa lista, os métodos vão retornar um erro. Para mais informações, consulte FieldMask.
  • A pesquisa de texto (nova) é compatível com chaves de API e tokens OAuth como mecanismo de autenticação.
  • Apenas JSON é aceito como formato de resposta na Pesquisa de texto (nova).

  • A pesquisa de texto (legada) permite especificar coordenadas de latitude e longitude na string de consulta. Por exemplo, query=37.4239,-122.0925. Essa opção não é compatível com a Pesquisa de texto (nova).

    Use a geocodificação inversa para pesquisar coordenadas e retornar um endereço ou a Pesquisa por proximidade (nova) para encontrar lugares ao redor de um determinado local.

  • O formato de resposta JSON para a Pesquisa de texto (nova) mudou em relação ao formato das APIs legadas. Para mais detalhes, consulte Migrar a resposta da API Places.

A tabela a seguir lista os parâmetros da Pesquisa de texto (legada) que foram renomeados ou modificados para a Pesquisa de texto (nova) ou que não são mais compatíveis.

Parâmetro atual Novo parâmetro Observações
evOptions Novo parâmetro.
language languageCode
location locationBias
maxprice/minprice priceLevels
opennow openNow
pagetoken pageToken
query textQuery Obrigatório em todas as solicitações.
radius locationBias Especifique o raio ao definir um locationBias.
region regionCode
type includedType Aceita apenas um valor.
strictTypeFiltering Novo parâmetro.

Exemplo de solicitação

O exemplo de solicitação GET a seguir usa a Pesquisa de texto (legada). Neste exemplo, você solicita uma resposta JSON com informações sobre "Comida vegetariana apimentada em Sydney, Austrália" e transmite todos os parâmetros como parâmetros de URL:

curl -L -X GET \
'https://maps.googleapis.com/maps/api/place/textsearch/json?query=Spicy%20Vegetarian%20Food%20in%20Sydney%20Australia&key=API_KEY

Com a Pesquisa de texto (nova), você faz uma solicitação POST e transmite todos os parâmetros no corpo da solicitação JSON ou nos cabeçalhos como parte da solicitação POST. Este exemplo também usa uma máscara de campo para que a resposta inclua apenas o nome de exibição e o endereço formatado do lugar:

curl -X POST -d '{
  "textQuery" : "Spicy Vegetarian Food in Sydney, Australia"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress' \
'https://places.googleapis.com/v1/places:searchText'