Method: searchText

Pesquise lugares com uma consulta de texto.

Solicitação HTTP

POST https://mapstools.googleapis.com/v1alpha:searchText

O URL usa a sintaxe de transcodificação gRPC.

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON 
{
  "textQuery": string,
  "languageCode": string,
  "regionCode": string,
  "pageSize": integer,
  "includeExtendedDetails": boolean,
  "locationBias": {
    object (LocationBias)
  }
}
Campos
textQuery

string

Obrigatório. A consulta de texto.
languageCode

string

Opcional. O idioma em que o resumo será retornado. Se o código do idioma não for especificado ou reconhecido, o resumo será retornado em inglês.

Por exemplo, "en" para inglês.

Lista atual de idiomas disponíveis: https://developers.google.com/maps/faq#languagesupport.
regionCode

string

Opcional. O código Unicode de país/região (CLDR) do local de origem da solicitação. Esse parâmetro é usado para mostrar os Place Details, como o nome específico da região, se disponível. O parâmetro pode afetar os resultados com base na legislação aplicável.

Por exemplo, "US" para Estados Unidos.

Para mais informações, consulte https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html.

No momento, não há suporte para códigos de região de três dígitos.
pageSize

integer

Opcional. O número máximo de lugares a serem retornados, até 10. O serviço pode retornar um valor inferior a este. O valor padrão é cinco.

Solicitar mais de 5 lugares vai acionar o nível Pro e gerar um custo faturado e uma latência maiores.
includeExtendedDetails

boolean

Opcional. Inclui detalhes estendidos do lugar na resposta.

Defina esse campo como true quando a solicitação do usuário exigir insights qualitativos detalhados, dinâmicas em tempo real ou atributos de entidade especializados: - Avaliações qualitativas, sentimento do cliente e feedback. - Ofertas específicas, como itens do cardápio, pratos, especialidades, bebidas ou destaques da empresa. - Atmosfera, decoração de interiores, estética, ambiente ou clima qualitativos. - Dados em tempo real e especificações de instalações especializadas, políticas/dicas para visitantes, tempos de espera.

Deixe false (padrão) para pesquisas de descoberta padrão (por exemplo, culinárias, tipos de loja), pesquisas de local/endereço, dados de contato, horário de funcionamento e metadados/comodidades padrão.

Ativar esse campo vai acionar o nível Pro e gerar um custo faturado mais alto e maior latência.
locationBias

object (LocationBias)

Uma região opcional para priorizar os resultados da pesquisa. Se um local explícito estiver em textQuery, ele será usado para influenciar os resultados da pesquisa em vez desse campo.

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de SearchTextResponse.

Escopos de autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/maps-platform.mapstools