Method: places.searchText

Búsqueda de lugares basada en búsquedas de texto.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación 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,
  "rankPreference": enum (RankPreference),
  "includedType": string,
  "openNow": boolean,
  "minRating": number,
  "maxResultCount": integer,
  "priceLevels": [
    enum (PriceLevel)
  ],
  "strictTypeFiltering": boolean,
  "locationBias": {
    object (LocationBias)
  },
  "locationRestriction": {
    object (LocationRestriction)
  },
  "evOptions": {
    object (EVOptions)
  }
}
Campos
textQuery

string

Obligatorio. Es la consulta de texto para la búsqueda textual.

languageCode

string

Los detalles del lugar se mostrarán en el idioma preferido si están disponibles. Si no se especifica el código de idioma o no se reconoce, se pueden mostrar detalles del lugar de cualquier idioma, con preferencia por el inglés (si existen esos detalles).

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

regionCode

string

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

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

Ten en cuenta que actualmente no se admiten los códigos regionales de 3 dígitos.

rankPreference

enum (RankPreference)

Cómo se clasificarán los resultados en la respuesta.

includedType

string

Es el tipo de lugar solicitado. Lista completa de los tipos admitidos: https://developers.google.com/maps/documentation/places/web-service/place-types Solo se admite un tipo incluido.

openNow

boolean

Se usa para restringir la búsqueda a los lugares que están abiertos en ese momento. El valor predeterminado es falso.

minRating

number

Filtra los resultados cuya calificación promedio de los usuarios sea estrictamente inferior a este límite. Un valor válido debe ser un número de punto flotante entre 0 y 5 (inclusive) con una cadencia de 0.5, es decir, [0, 0.5, 1.0, ... , 5.0] inclusive. La calificación de entrada se redondeará al valor máximo de 0.5(límite) más cercano. Por ejemplo, una calificación de 0.6 eliminará todos los resultados con una calificación inferior a 1.0.

maxResultCount

integer

Cantidad máxima de resultados que se mostrarán Debe ser un valor entre 1 y 20, inclusive. El valor predeterminado es 20. Si no estableces el número, volverá al límite superior. Si el número se establece como negativo o excede el límite superior, se muestra un error INVALID_ATTRIBUTE.

priceLevels[]

enum (PriceLevel)

Se usa para restringir la búsqueda a lugares marcados con determinados niveles de precios. Los usuarios pueden elegir cualquier combinación de niveles de precios. De forma predeterminada, se seleccionan todos los niveles de precios.

strictTypeFiltering

boolean

Se usa para establecer el filtrado de tipos estricto para includeType. Si se configura como true, solo se mostrarán resultados del mismo tipo. El valor predeterminado es falso.

locationBias

object (LocationBias)

La región en la que se buscará. Esta ubicación sirve como sesgo, lo que significa que podrían devolverse resultados en torno a una ubicación determinada. No se puede establecer junto con locationRestriction.

locationRestriction

object (LocationRestriction)

La región en la que se buscará. Esta ubicación sirve como una restricción, lo que significa que no se mostrarán resultados fuera de la ubicación determinada. No se puede establecer junto con locationBias.

evOptions

object (EVOptions)

Opcional. Configura las opciones de búsqueda de VE para una solicitud de búsqueda de lugar.

Cuerpo de la respuesta

Protocolo de respuesta para places.searchText.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON
{
  "places": [
    {
      object (Place)
    }
  ]
}
Campos
places[]

object (Place)

Una lista de lugares que cumplen con los criterios de búsqueda de texto del usuario.

RankPreference

Cómo se clasificarán los resultados en la respuesta.

Enumeradores
RANK_PREFERENCE_UNSPECIFIED No se estableció el valor de RankPreference. Se establecerá de forma predeterminada en DISTANCE.
DISTANCE Clasifica los resultados por distancia.
RELEVANCE Clasifica los resultados por relevancia. Orden de clasificación determinado por la pila de clasificación normal.

LocationBias

La región en la que se buscará. Esta ubicación sirve como sesgo, lo que significa que podrían devolverse resultados en torno a una ubicación determinada.

Representación JSON
{

  // Union field type can be only one of the following:
  "rectangle": {
    object (Viewport)
  },
  "circle": {
    object (Circle)
  }
  // End of list of possible types for union field type.
}
Campos

Campo de unión type.

type puede ser una de las siguientes opciones:

rectangle

object (Viewport)

Un cuadro rectangular definido por las esquinas noreste y suroeste. rectangle.high() debe ser el punto noreste del viewport del rectángulo. rectangle.low() debe ser el punto suroeste del viewport del rectángulo. rectangle.low().latitude() no puede ser mayor que rectangle.high().latitude(). El resultado será un rango de latitud vacío. Un viewport rectangular no puede tener un ancho superior a 180 grados.

circle

object (Circle)

Es un círculo definido por el punto central y el radio.

LocationRestriction

La región en la que se buscará. Esta ubicación sirve como una restricción, lo que significa que no se mostrarán resultados fuera de la ubicación determinada.

Representación JSON
{

  // Union field type can be only one of the following:
  "rectangle": {
    object (Viewport)
  }
  // End of list of possible types for union field type.
}
Campos

Campo de unión type.

type puede ser una de las siguientes opciones:

rectangle

object (Viewport)

Un cuadro rectangular definido por las esquinas noreste y suroeste. rectangle.high() debe ser el punto noreste del viewport del rectángulo. rectangle.low() debe ser el punto suroeste del viewport del rectángulo. rectangle.low().latitude() no puede ser mayor que rectangle.high().latitude(). El resultado será un rango de latitud vacío. Un viewport rectangular no puede tener un ancho superior a 180 grados.

EVOptions

Opciones de VE que se pueden buscar de una solicitud de búsqueda de lugar.

Representación JSON
{
  "minimumChargingRateKw": number,
  "connectorTypes": [
    enum (EVConnectorType)
  ]
}
Campos
minimumChargingRateKw

number

Opcional. Filtrar lugares por tasa de carga mínima. Se filtran todos los lugares en los que se cobra una tarifa inferior a la mínima.

connectorTypes[]

enum (EVConnectorType)

Opcional. La lista de tipos de conectores de VE preferidos. Se excluyen los lugares que no admiten ninguno de los tipos de conectores mencionados.