Introdução
A API Places (legada) é compatível com o Text Search (legado). Se você já conhece o Text Search (legado), o Text Search (novo) faz as seguintes mudanças:
- A Text Search (nova) usa solicitações POST HTTP. Transmita parâmetros no corpo da solicitação ou nos cabeçalhos como parte de uma solicitação POST. Por outro lado, com o Text Search (legado), você transmite parâmetros de URL usando uma solicitação GET.
- O mascaramento de campo é obrigatório. É preciso 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.
- A Text Search (nova) aceita chaves de API e tokens OAuth como mecanismo de autenticação.
- Somente o JSON é aceito como formato de resposta na Text Search (New).
A Text Search (Legacy) 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 Text Search (novo).Use a geocodificação inversa para pesquisar coordenadas e retornar um endereço ou a Nearby Search (nova) para encontrar lugares em uma determinada região.
- 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 Text Search (legada) que foram renomeados ou modificados para a Text Search (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 o Text Search (Legacy). Neste exemplo, você solicita uma resposta JSON com informações sobre "Spicy Vegetarian Food in Sydney, Australia" 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 a 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'