A API Places suporta a 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 POST HTTP. Aprovado no corpo da solicitação ou em cabeçalhos como parte de uma solicitação POST HTTP. 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 nessa lista, os métodos retornarão 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.Usar Geocodificação inversa para pesquisar coordenadas e retornar um endereço, ou Nearby Search (novo) para encontrar lugares perto 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 |
Incompatível. | |
query |
textQuery |
Obrigatório em todas as solicitações. |
radius |
locationBias |
Especifique o raio ao definir um locationBias. |
region |
regionCode |
|
type |
includedType |
Só aceita 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 o Text Search (novo), você faz uma solicitação POST e transmitir todos os parâmetros no corpo da solicitação JSON ou nos cabeçalhos como parte do POST solicitação. 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'