Method: searchText

Busca lugares con una búsqueda de texto.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación de gRPC.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON 
{
  "textQuery": string,
  "languageCode": string,
  "regionCode": string,
  "pageSize": integer,
  "includeExtendedDetails": boolean,
  "locationBias": {
    object (LocationBias)
  }
}
Campos
textQuery

string

Obligatorio. Es la consulta de texto.
languageCode

string

Opcional. Es el idioma en el que se solicita que se devuelva el resumen. Si el código de idioma no se especifica o no se reconoce, se devolverá el resumen con preferencia por el inglés.

Por ejemplo, "es" para español.

Lista actual de idiomas admitidos: https://developers.google.com/maps/faq#languagesupport.
regionCode

string

Opcional. Es el código de país o región de Unicode (CLDR) de la ubicación de donde proviene la solicitud. Este parámetro se usa para mostrar los detalles del lugar, como el nombre del lugar específico de la región, si está disponible. El parámetro puede afectar los resultados según la legislación aplicable.

Por ejemplo, "US" para Estados Unidos.

Para obtener más información, consulta https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html.

Ten en cuenta que, por el momento, no se admiten los códigos de región de 3 dígitos.
pageSize

integer

Opcional. Es la cantidad máxima de lugares que se devolverán, hasta 10. El servicio puede mostrar menos que este valor. El valor predeterminado es 5.

Si solicitas más de 5 lugares, se activará el nivel Pro y se generarán costos de facturación y latencia más altos.
includeExtendedDetails

boolean

Opcional. Incluye detalles extendidos del lugar en la respuesta.

Establece este campo en true cuando la solicitud del usuario requiera estadísticas cualitativas enriquecidas, dinámicas en tiempo real o atributos de entidad especializados: - Opiniones cualitativas, opiniones de los clientes y comentarios. - Ofertas específicas, como elementos del menú, platos, especialidades de comida, bebidas o aspectos destacados de la empresa - Atmósfera, decoración interior, estética, ambiente o estado de ánimo cualitativos. - Datos en tiempo real y especificaciones de instalaciones especializadas, políticas/sugerencias para visitantes, tiempos de espera.

Deja false (predeterminado) para las búsquedas de descubrimiento estándar (p.ej., tipos de cocina, tipos de tienda), las búsquedas de ubicación o dirección, la información de contacto, el horario de atención y los metadatos o las comodidades estándar.

Si habilitas este campo, se activará el nivel Pro y se generarán costos facturados y latencia más altos.
locationBias

object (LocationBias)

Es una región opcional para sesgar los resultados de la búsqueda. Si hay una ubicación explícita en textQuery, se usará para sesgar los resultados de la búsqueda en lugar de este campo.

Cuerpo de la respuesta

Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de SearchTextResponse.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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