Text Search (nueva)

Selecciona la plataforma: Android iOS JavaScript Servicio web

Una Text Search (nueva) muestra información sobre un conjunto de lugares en función de una cadena; por ejemplo, "pizza en Buenos Aires", "tiendas de zapatos cerca de Santiago" o "Calle principal 123". El servicio responde con una lista de lugares que coinciden con la cadena de texto y con cualquier sesgo de ubicación que se haya establecido.

El servicio es especialmente útil para realizar consultas de direcciones ambiguas en un sistema automatizado, y los componentes de la string sin dirección pueden coincidir tanto con empresas como con direcciones. Algunos ejemplos de consultas de direcciones ambiguas son las direcciones o solicitudes con formato incorrecto que incluyen componentes sin dirección, como nombres de empresas. Las solicitudes como los dos primeros ejemplos de la siguiente tabla pueden mostrar cero resultados, a menos que se establezca una ubicación, como la región, la restricción o el sesgo de ubicación.

"10 High Street, UK" o "123 Main Street, EE.UU."	varias "High Street" en el Reino Unido; varias "Main Street" en EE.UU. La consulta no muestra resultados deseables, a menos que se establezca una restricción de ubicación.
"ChainRestaurant de Nueva York"	Varias ubicaciones de "ChainRestaurant" en Nueva York, sin dirección ni nombre
"10 High Street, Escher UK" o "123 Main Street, Pleasanton US"	Solo una "High Street" en la ciudad de Escher, en el Reino Unido, y una sola "Calle Principal" en la ciudad estadounidense de Pleasanton, California.
"NombreDeRestaurante exclusivo Nueva York"	Solo hay un establecimiento con este nombre en Nueva York; no es necesario contar con una dirección para diferenciarlos.
"pizzas en Nueva York"	Esta consulta contiene su restricción de ubicación, y "pizzería" es un tipo de lugar bien definido. Muestra varios resultados.
"[phone]"	Esta consulta contiene un número de teléfono. Devuelve varios resultados para los lugares asociados con ese número de teléfono. Nota: Para obtener mejores resultados cuando buscas un número de teléfono, incluye el código de país seguido de un espacio y configura el parámetro regionCode para que coincida con el código de país.

El Explorador de APIs te permite realizar solicitudes en tiempo real para que puedas familiarizarte con la API y sus opciones:

Pruébalo

Solicitudes de Text Search

Una solicitud de Text Search es una solicitud HTTP POST como la siguiente:

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

Pasa todos los parámetros en el cuerpo de la solicitud JSON o en los encabezados como parte de la solicitud POST. Por ejemplo:

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,places.priceLevel' \
'https://places.googleapis.com/v1/places:searchText'

Respuestas de Text Search (nuevo)

Text Search (nueva) muestra un objeto JSON como respuesta. En la respuesta, figura lo siguiente:

• El array places contiene todos los lugares que coinciden.
• Cada lugar del array está representado por un objeto Place. El objeto Place contiene información detallada sobre un solo lugar.
• La FieldMask pasada en la solicitud especifica la lista de campos que se muestran en el objeto Place.

El objeto JSON completo tiene el siguiente formato:

{
  "places": [
    {
      object (Place)
    }
  ]
}

Parámetros obligatorios

• FieldMask

  Especifica la lista de campos que se debe mostrar en la respuesta; para ello, crea una máscara de campo de respuesta. Pasa la máscara de campo de respuesta al método mediante el parámetro de URL $fields o fields, o bien con el encabezado HTTP X-Goog-FieldMask. No hay una lista predeterminada de los campos mostrados en la respuesta. Si omites la máscara de campo, el método mostrará un error.

  El enmascaramiento de campo es una práctica de diseño recomendada para garantizar que no solicites datos innecesarios, lo que ayuda a evitar tiempos de procesamiento y cargos de facturación innecesarios.

  Especifica una lista separada por comas de los tipos de datos de lugar que deseas que se muestren. Por ejemplo, para recuperar el nombre visible y la dirección del lugar.

  X-Goog-FieldMask: places.displayName,places.formattedAddress

  Nota: No se permiten espacios en ninguna parte de la lista de campos.

  Usa * para recuperar todos los campos.

  X-Goog-FieldMask: *

  El comodín “*” selecciona todos los campos. Sin embargo, si bien es adecuado usar ese comodín en el desarrollo, Google desaconseja el uso de la máscara de campo de respuesta comodín (*) en producción debido a la gran cantidad de datos que se pueden mostrar.
  Puedes encontrar más orientación sobre el uso de places.iconMaskBaseUri y places.iconBackgroundColor en la sección Íconos de lugar.

  Especifica uno o más de los siguientes campos:

  • Los siguientes campos activan el SKU de Text Search (solo ID):

    places.id, places.name<sup>*
    
    *</sup> El campo places.name contiene el nombre de recurso del lugar expresado de la siguiente forma: places/PLACE_ID. Utiliza places.displayName para acceder al nombre del lugar en forma de texto.

  • Los siguientes campos activan el SKU de Text Search (Basic):

    places.accessibilityOptions, places.addressComponents, places.adrFormatAddress, places.businessStatus, places.displayName, places.formattedAddress, places.googleMapsUri, places.iconBackgroundColor, places.iconMaskBaseUri, places.location, places.photos, places.plusCode, places.primaryType, places.primaryTypeDisplayName, places.shortFormattedAddress, places.subDestinations, places.types, places.utcOffsetMinutes, places.viewport

  • Los siguientes campos activan el SKU de Text Search (Advanced):

    places.currentOpeningHours, places.currentSecondaryOpeningHours, places.internationalPhoneNumber, places.nationalPhoneNumber, places.priceLevel, places.rating, places.regularOpeningHours, places.regularSecondaryOpeningHours, places.userRatingCount, places.websiteUri

  • Los siguientes campos activan el SKU de Text Search (Preferred):

    <br class="2-2-14">.<ph-2-2-13">1-4-14">.<ph-2-2-41></ph>-14">1-4-14">.<ph-2-2-4/10">.<ph-2-2-4/10">.<ph> <ph-2-4/2-1>">.<ph-2-4-02">.places.allowsDogsplaces.curbsidePickupplaces.deliveryplaces.dineInplaces.editorialSummaryplaces.evChargeOptionsplaces.fuelOptionsplaces.goodForChildrenplaces.goodForGroupsplaces.goodForWatchingSportsplaces.liveMusicplaces.menuForChildrenplaces.parkingOptionsplaces.paymentOptionsplaces.outdoorSeatingplaces.reservableplaces.restroomplaces.reviewsplaces.servesBeerplaces.servesBreakfastplaces.servesBrunchplaces.servesCocktailsplaces.servesCoffeeplaces.servesDessertsplaces.servesDinnerplaces.servesLunchplaces.servesVegetarianFoodplaces.servesWineplaces.takeout
    

• textQuery

  Es la cadena de texto en la que se busca, por ejemplo: "restaurante", "calle principal 123" o "mejor lugar para visitar en San Francisco". La API muestra posibles coincidencias en función de esta cadena y ordena los resultados según la relevancia percibida.

Parámetros opcionales

• includedType

  Restringe los resultados a los lugares que coinciden con el tipo especificado definido en la Tabla A. Solo se puede especificar un tipo. Por ejemplo:

  • "includedType":"bar"
  • "includedType":"pharmacy"
  Nota: Los valores de la Tabla B solo se muestran en la respuesta. No puedes usar los valores de la Tabla B como filtro.

• languageCode

  El idioma en el que se mostrarán los resultados.

  • Consulta la lista de idiomas compatibles. A menudo, Google actualiza los idiomas admitidos, por lo que es posible que esta lista no sea exhaustiva.
  • Si no se proporciona languageCode, la API se establece de forma predeterminada en en. Si especificas un código de idioma no válido, la API mostrará un error INVALID_ARGUMENT.
  • La API hace todo lo posible para proporcionar una dirección que sea legible tanto para el usuario como para los usuarios locales. Para lograr ese objetivo, muestra las direcciones en el idioma local, transliteradas a una secuencia de comandos legible para el usuario si es necesario, que observa el idioma preferido. Todas las demás direcciones se muestran en el idioma preferido. Los componentes de la dirección se muestran en el mismo idioma, que se elige a partir del primer componente.
  • Si un nombre no está disponible en el idioma preferido, la API usa la coincidencia más cercana.
  • El idioma preferido tiene una pequeña influencia en el conjunto de resultados que la API elige mostrar y en el orden en el que se muestran. El geocodificador interpreta las abreviaturas de manera diferente según el idioma; por ejemplo, las abreviaturas para los tipos de calle o los sinónimos que pueden ser válidos en un idioma, pero no en otro.

• locationBias

  Especifica un área de búsqueda. Esta ubicación sirve como una personalización, lo que significa que se pueden mostrar resultados alrededor de la ubicación especificada, incluso resultados fuera del área especificada.

  Puedes especificar locationRestriction o locationBias, pero no ambos. Considera que locationRestriction especifica la región en la que deben estar los resultados y locationBias la región a la que los resultados deben estar cerca, pero que pueden estar fuera del área.

  Nota: Si omites locationBias y locationRestriction, la API usa la personalización de IP de forma predeterminada. Con la personalización de IP, la API usa la dirección IP del dispositivo para personalizar los resultados.
  Nota: El parámetro locationBias se puede anular si textQuery contiene una ubicación explícita, como Market in Barcelona. En este caso, se ignora locationBias.

  Especifique la región como una ventana gráfica rectangular o como un círculo.

  • Un círculo se define por el punto central y el radio en metros. El radio debe estar entre 0.0 y 50,000.0, inclusive. El radio predeterminado es 0.0. Por ejemplo:

    "locationBias": {
      "circle": {
        "center": {
          "latitude": 37.7937,
          "longitude": -122.3965
        },
        "radius": 500.0
      }
    }

  • Un rectángulo es un viewport de latitud y longitud, representado como dos puntos bajos y altos en diagonal. El punto inferior marca la esquina suroeste del rectángulo y el punto alto representa la esquina nordeste del rectángulo.

    Un viewport se considera una región cerrada, lo que significa que incluye su límite. Los límites de latitud deben variar entre -90 y 90 grados inclusive, y los límites de longitud deben variar entre -180 y 180 grados inclusive:

    • Si low = high, el viewport consta de ese solo punto.
    • Si low.longitude > high.longitude, se invierte el rango de longitud (el viewport cruza la línea de longitud de 180 grados).
    • Si low.longitude = -180 grados y high.longitude = 180 grados, el viewport incluye todas las longitudes.
    • Si low.longitude = 180 grados y high.longitude = -180 grados, el rango de longitud está vacío.
    • Si low.latitude > high.latitude, el rango de latitud está vacío.

    Se deben completar los valores bajo y alto, y el cuadro representado no puede estar vacío. Un viewport vacío genera un error.

    Por ejemplo, este viewport abarca por completo la ciudad de Nueva York:

    "locationBias": {
      "rectangle": {
        "low": {
          "latitude": 40.477398,
          "longitude": -74.259087
        },
        "high": {
          "latitude": 40.91618,
          "longitude": -73.70018
        }
      }
    }

• locationRestriction

  Especifica un área de búsqueda. No se muestran resultados fuera del área especificada. Especifica la región como una ventana gráfica rectangular. Consulta la descripción de locationBias para obtener información sobre cómo definir el viewport.

  Puedes especificar locationRestriction o locationBias, pero no ambos. Considera que locationRestriction especifica la región en la que deben estar los resultados y locationBias la región a la que los resultados deben estar cerca, pero que pueden estar fuera del área.

  Nota: Si omites locationBias y locationRestriction, la API usa la personalización de IP de forma predeterminada. Con la personalización de IP, la API usa la dirección IP del dispositivo para personalizar los resultados.

• maxResultCount (obsoleto)

  Obsoleto: Este campo dejó de estar disponible y se reemplazó por pageSize. Si se especifican maxResultCount y pageSize, se usará pageSize y se ignorará maxResultCount.

  Especifica la cantidad de resultados (entre 1 y 20) que se mostrarán por página. Por ejemplo, si estableces un valor de maxResultCount de 5, se mostrarán hasta 5 resultados en la primera página. Si la consulta puede mostrar más resultados, la respuesta incluye un nextPageToken que puedes pasar a una solicitud posterior para acceder a la página siguiente.

  Nota: Si maxResultCount es 0 o no se especifica, la API mostrará 20 resultados por página de forma predeterminada. Si maxResultCount es mayor que 20, la API no mostrará más de 20 resultados por página.

• evOptions

  Especifica parámetros para identificar los conectores de carga y las velocidades de carga de vehículos eléctricos (VE) disponibles.

  • connectorTypes

    Filtra por el tipo de conector de carga de VE disponible en un lugar. Se filtrarán los lugares que no admitan ninguno de los tipos de conectores. Los tipos de conectores de carga de VE admitidos incluyen cargadores combinados (CA y CC), cargadores Tesla, cargadores compatibles con GB/T (para la carga rápida de VE en China) y cargadores para tomacorrientes. Para obtener más información, consulta la documentación de referencia.

  • minimumChargingRateKw

    Filtra lugares por velocidad de carga mínima de VE en kilovatios (kW). Se filtrarán los lugares en los que se cobre una velocidad inferior a la mínima. Por ejemplo, para encontrar cargadores de VE con velocidades de carga de al menos 10 kW, puedes establecer este parámetro en "10".

• minRating

  Restringe los resultados solo a aquellos cuya calificación promedio de los usuarios es mayor o igual que este límite. Los valores deben estar entre 0.0 y 5.0 (inclusive) en incrementos de 0.5. Por ejemplo: 0, 0.5, 1.0, ... , 5.0 inclusive. Los valores se redondean al punto 0.5 más cercano. Por ejemplo, un valor de 0.6 elimina todos los resultados con una calificación inferior a 1.0.

• openNow

  Si es true, muestra solo los lugares que están abiertos en el momento en que se envía la consulta. Si es false, muestra todas las empresas, independientemente de su estado abierto. Los lugares que no especifican los horarios de atención en la base de datos de Google Places se muestran si estableces este parámetro en false.

• pageSize

  Especifica la cantidad de resultados (entre 1 y 20) que se mostrarán por página. Por ejemplo, si estableces un valor de pageSize de 5, se mostrarán hasta 5 resultados en la primera página. Si la consulta puede mostrar más resultados, la respuesta incluye un nextPageToken que puedes pasar a una solicitud posterior para acceder a la página siguiente.

  Nota: Si pageSize es 0 o no se especifica, la API mostrará 20 resultados por página de forma predeterminada. Si pageSize es mayor que 20, la API no mostrará más de 20 resultados por página.

• pageToken

  Especifica el nextPageToken del cuerpo de la respuesta de la página anterior.

• priceLevels

  Restringe la búsqueda a los lugares marcados en determinados niveles de precios. La opción predeterminada es seleccionar todos los niveles de precios.

  Especifica un array de uno o más valores definidos por PriceLevel.

  Nota: PRICE_LEVEL_FREE no se permite en una solicitud. Solo se usa para propagar la respuesta.

  Por ejemplo:

  "priceLevels":["PRICE_LEVEL_INEXPENSIVE", "PRICE_LEVEL_MODERATE"]

• rankPreference

  Especifica cómo se clasifican los resultados en la respuesta según el tipo de consulta:

  • Para una consulta categórica como "Restaurantes en la ciudad de Nueva York", RELEVANCE (resultados de clasificación por relevancia de búsqueda) es el valor predeterminado. Puedes establecer rankPreference en RELEVANCE o DISTANCE (clasificar los resultados por distancia).
  • Para una consulta no categórica, como "Mountain View, CA", te recomendamos que no configures rankPreference.

• regionCode

  Es el código de región que se usa para dar formato a la respuesta, especificado como un valor de código CLDR de dos caracteres. Este parámetro también puede tener un efecto de sesgo en los resultados de la búsqueda. No hay un valor predeterminado.

  Si el nombre del país del campo formattedAddress en la respuesta coincide con regionCode, el código de país se omite de formattedAddress. Este parámetro no tiene efecto en adrFormatAddress, que siempre incluye el nombre del país cuando está disponible, o en shortFormattedAddress, que nunca lo incluye.

  La mayoría de los códigos CLDR son idénticos a los códigos ISO 3166-1, con algunas excepciones notables. Por ejemplo, el ccTLD del Reino Unido es "uk" (.co.uk), mientras que su código ISO 3166-1 es "gb" (técnicamente para la entidad del "Reino Unido de Gran Bretaña e Irlanda del Norte"). El parámetro puede afectar los resultados según la ley aplicable.

• strictTypeFiltering

  Se usa con el parámetro includedType. Cuando se establece en true, solo se muestran los lugares que coinciden con los tipos especificados por includeType. Cuando es falso, el valor predeterminado, la respuesta puede contener lugares que no coinciden con los tipos especificados.

Ejemplos de Text Search

Busca un lugar con una cadena de consulta

En el siguiente ejemplo, se muestra una solicitud de Text Search para "Comida vegetariana picante en Sídney, Australia":

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'

Ten en cuenta que el encabezado X-Goog-FieldMask especifica que la respuesta contiene los siguientes campos de datos: places.displayName,places.formattedAddress. Entonces, la respuesta tendrá el siguiente formato:

{
  "places": [
    {
      "formattedAddress": "367 Pitt St, Sydney NSW 2000, Australia",
      "displayName": {
        "text": "Mother Chu's Vegetarian Kitchen",
        "languageCode": "en"
      }
    },
    {
      "formattedAddress": "175 First Ave, Five Dock NSW 2046, Australia",
      "displayName": {
        "text": "Veggo Sizzle - Vegan & Vegetarian Restaurant, Five Dock, Sydney",
        "languageCode": "en"
      }
    },
    {
      "formattedAddress": "29 King St, Sydney NSW 2000, Australia",
      "displayName": {
        "text": "Peace Harmony",
        "languageCode": "en"
      }
    },
    ...
  ]
}

Agrega más tipos de datos a la máscara de campo para mostrar información adicional. Por ejemplo, agrega places.types,places.websiteUri para incluir el tipo de restaurante y la dirección web en la respuesta:

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,places.types,places.websiteUri' \
'https://places.googleapis.com/v1/places:searchText'

La respuesta ahora tiene el siguiente formato:

{
  "places": [
    {
      "types": [
        "vegetarian_restaurant",
        "vegan_restaurant",
        "chinese_restaurant",
        "restaurant",
        "food",
        "point_of_interest",
        "establishment"
      ],
      "formattedAddress": "367 Pitt St, Sydney NSW 2000, Australia",
      "websiteUri": "http://www.motherchusvegetarian.com.au/",
      "displayName": {
        "text": "Mother Chu's Vegetarian Kitchen",
        "languageCode": "en"
      }
    },
    {
      "types": [
        "vegan_restaurant",
        "thai_restaurant",
        "vegetarian_restaurant",
        "indian_restaurant",
        "italian_restaurant",
        "american_restaurant",
        "restaurant",
        "food",
        "point_of_interest",
        "establishment"
      ],
      "formattedAddress": "175 First Ave, Five Dock NSW 2046, Australia",
      "websiteUri": "http://www.veggosizzle.com.au/",
      "displayName": {
        "text": "Veggo Sizzle - Vegan & Vegetarian Restaurant, Five Dock, Sydney",
        "languageCode": "en"
      }
    },
    ...
  ]
}

Filtrar lugares por nivel de precio

Usa la opción priceLevel para filtrar los resultados a restaurantes definidos como económicos o de precio moderado:

curl -X POST -d '{
  "textQuery" : "Spicy Vegetarian Food in Sydney, Australia",
  "priceLevels":["PRICE_LEVEL_INEXPENSIVE", "PRICE_LEVEL_MODERATE"]
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.priceLevel' \
'https://places.googleapis.com/v1/places:searchText'

En este ejemplo, también se usa el encabezado X-Goog-FieldMask para agregar el campo de datos places.priceLevel a la respuesta de modo que tenga el siguiente formato:

{
  "places": [
    {
      "formattedAddress": "367 Pitt St, Sydney NSW 2000, Australia",
      "priceLevel": "PRICE_LEVEL_MODERATE",
      "displayName": {
        "text": "Mother Chu's Vegetarian Kitchen",
        "languageCode": "en"
      }
    },
    {
      "formattedAddress": "115 King St, Newtown NSW 2042, Australia",
      "priceLevel": "PRICE_LEVEL_MODERATE",
      "displayName": {
        "text": "Green Mushroom",
        "languageCode": "en"
      }
    },
    ...
  ]
}

Agrega opciones adicionales para definir mejor la búsqueda, como includedType, minRating, rankPreference, openNow y otros parámetros descritos en Parámetros opcionales.

Nota: Estos parámetros de perfeccionamiento solo se aplican a consultas como “Restaurantes en la ciudad de Nueva York”, en las que los parámetros ayudan a reducir la cantidad de resultados de la búsqueda según la opción especificada. Aplicar estos parámetros a otros tipos de consultas, por ejemplo, a consultas geográficas como “Mountain View, CA” o “Ciudad de Nueva York”, puede dar como resultado que se filtren los resultados significativos o que se reduzca la cantidad de resultados significativos.

Cómo buscar lugares en un área

Usa locationRestriction o locationBias, pero no ambos, para restringir una búsqueda a un área. Piensa en locationRestriction como la especificación de la región en la que deben estar los resultados y en locationBias como la región a la que los resultados deben estar cerca, pero pueden estar fuera del área.

Nota: Cuando usas locationBias, puedes especificar la región como una ventana gráfica rectangular o como un círculo. Para locationRestriction, puedes especificar la región como una ventana gráfica rectangular.

En el siguiente ejemplo, se muestra una solicitud de Text Search para "Comida vegetariana picante" limitada a 500 metros de distancia del centro de San Francisco. Esta solicitud solo muestra los primeros 10 resultados de lugares abiertos.

curl -X POST -d '{
  "textQuery" : "Spicy Vegetarian Food",
  "openNow": true,
  "pageSize": 10,
  "locationBias": {
    "circle": {
      "center": {"latitude": 37.7937, "longitude": -122.3965},
      "radius": 500.0
    }
  },
}' \
-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'

Buscar cargadores de VE con una velocidad de carga mínima

Usa minimumChargingRateKw y connectorTypes para buscar lugares con cargadores disponibles que sean compatibles con tu VE.

En el siguiente ejemplo, se muestra una solicitud de conectores de carga de VE tipo 1 y Tesla y J1772 con una velocidad de carga mínima de 10 kW en Mountain View, California. Solo se muestran cuatro resultados.

curl -X POST -d '{
    "textQuery": "EV Charging Station Mountain View",
    "pageSize": 4,
    "evOptions": {
      "minimumChargingRateKw": 10,
      "connectorTypes": ["EV_CONNECTOR_TYPE_J1772","EV_CONNECTOR_TYPE_TESLA"]
    }
  }' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H "X-Goog-FieldMask: places.displayName,places.evChargeOptions" \
'https://places.googleapis.com/v1/places:searchText'

La solicitud muestra la siguiente respuesta:

{
  "places": [
    {
      "displayName": {
        "text": "EVgo Charging Station",
        "languageCode": "en"
      },
      "evChargeOptions": {
        "connectorCount": 16,
        "connectorAggregation": [
          {
            "type": "EV_CONNECTOR_TYPE_CHADEMO",
            "maxChargeRateKw": 100,
            "count": 8,
            "availableCount": 5,
            "outOfServiceCount": 0,
            "availabilityLastUpdateTime": "2024-01-10T19:10:00Z"
          },
          {
            "type": "EV_CONNECTOR_TYPE_CCS_COMBO_1",
            "maxChargeRateKw": 100,
            "count": 2,
            "availableCount": 2,
            "outOfServiceCount": 0,
            "availabilityLastUpdateTime": "2024-01-10T19:10:00Z"
          },
          {
            "type": "EV_CONNECTOR_TYPE_CCS_COMBO_1",
            "maxChargeRateKw": 350,
            "count": 6,
            "availableCount": 3,
            "outOfServiceCount": 0,
            "availabilityLastUpdateTime": "2024-01-10T19:10:00Z"
          }
        ]
      }
    },
    {
      "displayName": {
        "text": "EVgo Charging Station",
        "languageCode": "en"
      },
      "evChargeOptions": {
        "connectorCount": 6,
        "connectorAggregation": [
          {
            "type": "EV_CONNECTOR_TYPE_CCS_COMBO_1",
            "maxChargeRateKw": 100,
            "count": 4,
            "availableCount": 3,
            "outOfServiceCount": 0,
            "availabilityLastUpdateTime": "2024-01-10T19:10:00Z"
          },
          {
            "type": "EV_CONNECTOR_TYPE_CCS_COMBO_1",
            "maxChargeRateKw": 350,
            "count": 2,
            "availableCount": 0,
            "outOfServiceCount": 2,
            "availabilityLastUpdateTime": "2024-01-10T19:10:00Z"
          }
        ]
      }
    },
    {
      "displayName": {
        "text": "EVgo Charging Station",
        "languageCode": "en"
      },
      "evChargeOptions": {
        "connectorCount": 5,
        "connectorAggregation": [
          {
            "type": "EV_CONNECTOR_TYPE_J1772",
            "maxChargeRateKw": 3.5999999046325684,
            "count": 1,
            "availableCount": 0,
            "outOfServiceCount": 1,
            "availabilityLastUpdateTime": "2024-01-10T19:10:00Z"
          },
          {
            "type": "EV_CONNECTOR_TYPE_CHADEMO",
            "maxChargeRateKw": 50,
            "count": 2,
            "availableCount": 0,
            "outOfServiceCount": 0,
            "availabilityLastUpdateTime": "2024-01-10T19:10:00Z"
          },
          {
            "type": "EV_CONNECTOR_TYPE_CCS_COMBO_1",
            "maxChargeRateKw": 50,
            "count": 2,
            "availableCount": 0,
            "outOfServiceCount": 0,
            "availabilityLastUpdateTime": "2024-01-10T19:10:00Z"
          }
        ]
      }
    },
    {
      "displayName": {
        "text": "Electric Vehicle Charging Station",
        "languageCode": "en"
      },
      "evChargeOptions": {
        "connectorCount": 10,
        "connectorAggregation": [
          {
            "type": "EV_CONNECTOR_TYPE_OTHER",
            "maxChargeRateKw": 210,
            "count": 10
          }
        ]
      }
    }
  ]
}

Especifica la cantidad de resultados que se mostrarán por página

Usa el parámetro pageSize para especificar la cantidad de resultados que se mostrarán por página. El parámetro nextPageToken en el cuerpo de la respuesta proporciona un token que se puede usar en llamadas posteriores para acceder a la siguiente página de resultados.

En el siguiente ejemplo, se muestra una solicitud de "pizza en New York" con un límite de 5 resultados por página:

 curl -X POST -d '{
  "textQuery": "pizza in New York",
  "pageSize": 5
  }' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H "X-Goog-FieldMask: places.id,nextPageToken" \
'https://places.googleapis.com/v1/places:searchText'

{
  "places": [
    {
      "id": "ChIJifIePKtZwokRVZ-UdRGkZzs"
    },
    {
      "id": "ChIJPxPd_P1YwokRfzLhSiACEoU"
    },
    {
      "id": "ChIJrXXKn5NZwokR78g0ipCnY60"
    },
    {
      "id": "ChIJ6ySICVZYwokR9rIK8HjXhzE"
    },
    {
      "id": "ChIJ6xvs94VZwokRnT1D2lX2OTw"
    }
  ],
  "nextPageToken": "AeCrKXsZWzNVbPzO-MRWPu52jWO_Xx8aKwOQ69_Je3DxRpfdjClq8Ekwh3UcF2h2Jn75kL6PtWLGV4ecQri-GEUKN_OFpJkdVc-JL4Q"
}

Si quieres acceder a la siguiente página de resultados, usa pageToken para pasar nextPageToken en el cuerpo de la solicitud:

 curl -X POST -d '{
  "textQuery": "pizza in New York",
  "pageSize": 5,
  "pageToken": "AeCrKXsZWzNVbPzO-MRWPu52jWO_Xx8aKwOQ69_Je3DxRpfdjClq8Ekwh3UcF2h2Jn75kL6PtWLGV4ecQri-GEUKN_OFpJkdVc-JL4Q"
  }' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H "X-Goog-FieldMask: places.id,nextPageToken" \
'https://places.googleapis.com/v1/places:searchText'

{
  "places": [
    {
      "id": "ChIJL-LN1N1ZwokR8K2jACu6Ydw"
    },
    {
      "id": "ChIJjaD94kFZwokR-20CXqlpy_4"
    },
    {
      "id": "ChIJ6ffdpJNZwokRmcafdROM5q0"
    },
    {
      "id": "ChIJ8Q2WSpJZwokRQz-bYYgEskM"
    },
    {
      "id": "ChIJ8164qwFZwokRhplkmhvq1uE"
    }
  ],
  "nextPageToken": "AeCrKXvPd6uUy-oj96W2OaqEe2pUD8QTxOM8-sKfUcFsC9t2Wey5qivrKGoGSxcZnyc7RPmaFfAktslrKbUh31ZDTkL0upRmaxA7c_c"
}

Nota: Todos los parámetros que no sean maxResultCount, pageSize y pageToken deben ser los mismos que los de la solicitud anterior. De lo contrario, la API muestra un error INVALID_ARGUMENT.

Pruébalo

El Explorador de APIs te permite realizar solicitudes de muestra para que puedas familiarizarte con la API y sus opciones.

1. Selecciona el ícono de la API, , en el lado derecho de la página.

2. De manera opcional, puedes expandir Mostrar parámetros estándar (Show standard parameters) y establecer el parámetro fields en la máscara de campo.

3. De manera opcional, edita el Cuerpo de la solicitud.

4. Selecciona el botón Ejecutar. En el cuadro de diálogo emergente, elige la cuenta que deseas usar para realizar la solicitud.

5. En el panel Explorador de APIs, selecciona el ícono de expansión, , para expandir la ventana del Explorador de APIs.