A API Places é compatível com a Pesquisa de texto atual. Se você já conhece o Text Search, a nova versão dele faz as seguintes alterações:
- A nova Pesquisa de texto usa solicitações POST HTTP. 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 atual, você transmite parâmetros de URL usando uma solicitação HTTP GET.
- O mascaramento de campo é obrigatório. Especifique quais campos você quer retornar na resposta. Não há lista padrão de campos retornados. Se você omitir essa lista, os métodos retornarão um erro. Para mais informações, consulte FieldMask.
- A nova Pesquisa de texto é compatível com chaves de API e tokens OAuth como mecanismo de autenticação.
- Apenas JSON é compatível como formato de resposta no novo Text Search.
O Text Search atual 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 o novo Text Search.Use a Geocodificação inversa para pesquisar coordenadas e retornar um endereço ou Pesquisa de locais próximos (novo) para encontrar lugares ao redor de um determinado local.
- O formato de resposta JSON para a nova API Text Search foi alterado do formato das APIs existentes. Para mais detalhes, consulte Migrar a resposta da API Places.
A tabela a seguir lista os parâmetros no Text Search que foram renomeados ou modificados para o novo Text Search ou os parâmetros 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 |
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 a Text Search existente. Neste exemplo, você solicita uma resposta JSON com 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 local:
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'