A API Places oferece suporte à Pesquisa de texto. Se você já conhece o Text Search, a nova versão da Pesquisa de texto faz as seguintes alterações:
- A nova pesquisa de texto 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. Em contraste, com a Pesquisa de texto existente, você passa parâmetros de URL usando uma solicitação HTTP GET.
- O mascaramento de campo é obrigatório. Você precisa especificar quais campos quer retornar 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 nova Pesquisa de texto é compatível com as duas chaves de API e os tokens OAuth como mecanismo de autenticação.
- Somente JSON é aceito como formato de resposta no novo Pesquisa de texto.
A Pesquisa de texto atual permite especificar a latitude e longitude na string de consulta. Por exemplo,
query=37.4239,-122.0925. Essa opção não é compatível com a nova Pesquisa de texto.Use a geocodificação inversa para pesquisar em coordenadas e retornar um endereço ou o Nearby Search (novo) para encontrar lugares em torno de um determinado local.
- O formato de resposta JSON para o Text Search (novo) O formato das APIs atuais foi alterado. Para mais detalhes, consulte Migre a resposta da API Places.
A tabela a seguir lista os parâmetros no sistema Text Search que foram renomeados ou modificados para um novo Text Search ou parâmetros que não são mais suporte.
| 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 Pesquisa de texto. Neste exemplo, você solicita um arquivo JSON resposta contendo informações sobre "Comida vegetariana picante em Sydney, Austrália" e transmita 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 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'