A API Places é compatível com a Pesquisa de texto atual. Se você estiver familiarizado com o Text Search, a nova versão fará as seguintes mudanças:
- 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 POST HTTP. Por outro lado, com o Text Search existente, 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 retornar na resposta. Não há uma 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.
- Somente JSON é aceito como formato de resposta no novo Text Search.
A Pesquisa de texto 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 a nova Pesquisa de texto.Use a Geocodificação inversa para pesquisar coordenadas e retornar um endereço, ou Pesquisa de locais por perto (novo) para encontrar lugares perto de um determinado local.
- O formato de resposta JSON para a API Text Search (novo) foi alterado do formato das APIs existentes. Se quiser 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 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 o Text Search. 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 passa todos os parâmetros no corpo da solicitação JSON ou nos cabeçalhos como parte dela. 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'