Introdução
A API Places (legada) é compatível com a Text Search (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 nos cabeçalhos como parte de uma solicitação POST. Já com o Text Search (legado), você transmite parâmetros de URL usando uma solicitação 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.
- O Text Search (novo) é 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 Text Search (New).Use a geocodificação inversa para pesquisar coordenadas e retornar um endereço ou a Nearby Search (New) para encontrar lugares ao redor de um determinado local.
- O formato de resposta JSON da Text Search (New) mudou em relação ao 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 o Text Search (legado). 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 o Text Search (novo), 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'