Introdução
A API Places (legada) oferece suporte a Pesquisa de texto (legada). Se você já conhece a Pesquisa de texto (legada), a Pesquisa de texto (nova) apresenta 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 HTTP POST. Por outro lado, com o Text Search (legado), você transmite parâmetros de URL usando uma solicitação HTTP GET.
- O mascaramento de campo é obrigatório. É necessário especificar quais campos você 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) oferece suporte a chaves de API e tokens OAuth como mecanismo de autenticação.
- Apenas o 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 é aceita na Pesquisa de texto (nova).Use Geocodificação inversa para pesquisar coordenadas e retornar um endereço ou Nearby Search (New) para encontrar lugares próximos a um determinado local.
- O formato de resposta JSON da Text Search (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 aceitos.
| 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 que contém informações sobre "Comida vegetariana picante 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'