Text Search (nueva)

Selecciona la plataforma: Android iOS JavaScript Servicio web

Una Text Search (nueva) devuelve información sobre un conjunto de lugares en función de una cadena; por ejemplo, "pizza en Nueva York" o "zapaterías 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 ubicación que se ha establecido.

El servicio es especialmente útil para hacer consultas sobre direcciones ambiguas en un sistema automatizado y los componentes de la cadena sin dirección pueden coincidir empresas y también direcciones. Estos son algunos ejemplos de consultas sobre direcciones ambiguas: direcciones con formato incorrecto o solicitudes que incluyen componentes sin dirección, como como nombres de empresas. Solicitudes como los dos primeros ejemplos de la siguiente tabla Es posible que no muestre resultados, a menos que se proporcione una ubicación (como región, ubicación) restricción o sesgo de ubicación.

“10 High Street, UK” o “123 Main Street, US” varias "High Street" en el Reino Unido varias "Calles Principales" en los EE. UU. La consulta no devuelve resultados deseados, a menos que se aplique una restricción de ubicación automático.
"ChainRestaurant de Nueva York" Varios "ChainRestaurant" ubicaciones en Nueva York; sin dirección o incluso el nombre de la calle.
"10 High Street, Escher, Reino Unido" o "123 Main Street, Pleasanton US" Solo una calle principal en la ciudad de Escher, en el Reino Unido; solo una “Calle Principal” en la ciudad estadounidense de Pleasanton, California.
"NombreDeRestaurante exclusivo Nueva York" Solo un establecimiento con este nombre en Nueva York sin dirección necesario 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.
"+1 514-670-8700"

Esta consulta contiene un número de teléfono. Devuelve varios resultados para lugares asociados con ese número de teléfono.

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

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 del 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) devuelve un un objeto JSON como respuesta. En la respuesta, figura lo siguiente:

  • El array places contiene todos los lugares que coinciden.
  • Cada lugar del conjunto está representado por un Place . El objeto Place contiene información detallada sobre un solo en un lugar específico.
  • La FieldMask pasada en la solicitud especifica la Lista de campos mostrados 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 deben mostrar en la respuesta creando un máscara de campo de respuesta. Pasa la máscara de campo de respuesta al método con el parámetro de URL $fields o fields, o mediante 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 asegurarse de no solicitar datos innecesarios, lo que ayuda a evitar tiempos de procesamiento y cargos de facturación.

    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

    Usa * para recuperar todos los campos.

    X-Goog-FieldMask: *

    Especifica uno o más de los siguientes campos:

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

      places.attributions, places.id, places.name*: nextPageToken

      * El campo places.name contiene el nombre del recurso del lugar. en el formato 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):

      places.allowsDogs, places.curbsidePickup, places.delivery, places.dineIn, places.editorialSummary, places.evChargeOptions, places.fuelOptions, places.goodForChildren, places.goodForGroups, places.goodForWatchingSports, places.liveMusic, places.menuForChildren, places.parkingOptions, places.paymentOptions, places.outdoorSeating, places.reservable, places.restroom, places.reviews, places.servesBeer, places.servesBreakfast, places.servesBrunch, places.servesCocktails, places.servesCoffee, places.servesDessert, places.servesDinner, places.servesLunch, places.servesVegetarianFood, places.servesWine, places.takeout

  • textQuery

    Cadena de texto en la que se realizará la búsqueda, por ejemplo: "restaurante", “Calle principal 123” o “el mejor lugar para visitar en San Francisco”. La API devuelve coincidencias de candidatos basadas en en esta cadena y ordena los resultados según la relevancia percibida.

Parámetros opcionales

  • includedType

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

    • "includedType":"bar"
    • "includedType":"pharmacy"

  • languageCode

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

    • Consulta la lista de idiomas compatibles. Google actualiza con frecuencia los idiomas admitidos, por lo que es posible que esta lista no esté exhaustivas.
    • 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 devuelve un error INVALID_ARGUMENT.
    • La API hace todo lo posible para proporcionar una dirección que sea legible para tanto el usuario como los locales. Para lograr ese objetivo, devuelve en el idioma local, transliteradas a un script legible por al usuario, si es necesario, y respetando el idioma preferido. Todos los demás las direcciones se devuelven en el idioma preferido. Los componentes de la dirección son todas se devuelven en el mismo idioma, que se elige de la primera este componente.
    • Si un nombre no está disponible en el idioma preferido, la API usa el coincidencia más cercana.
    • El idioma preferido influye poco en el conjunto de resultados que que la API elige devolver y el orden en el que se muestran. El el geocodificador interpreta las abreviaturas de manera diferente según el lenguaje, como las abreviaturas para los tipos de calle, o los sinónimos que pueden válido en un idioma, pero no en otro.

  • locationBias

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

    Puedes especificar locationRestriction o locationBias, pero no ambas. Piensa en locationRestriction como la especificación región en la que deben estar los resultados y locationBias, ya que que especifica la región a la que los resultados deben estar cerca, pero pueden estar fuera en el área.

    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 por dos en diagonal frente a puntos bajos y altos en diagonal. El punto más bajo marca el suroeste del rectángulo, y el punto alto representa el noreste esquina del rectángulo.

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

      • Si low = high, el viewport consta de lo siguiente: ese punto.
      • Si low.longitude > high.longitude, el el intervalo de longitud se invierte (el viewport cruza los 180 grados línea de longitud).
      • Si low.longitude = -180 grados y high.longitude = 180 grados, el viewport incluye todo longitudes.
      • Si low.longitude = 180 grados y high.longitude = -180 grados, el intervalo de longitud es vacío.
      • Si low.latitude > high.latitude, el está vacío.

      Tanto el valor bajo como el alto deben completarse, y la casilla representada no se puede 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. Los resultados fuera del área especificada no se muestran que se devuelven. Especifica la región como una ventana de visualización rectangular. Ver la descripción de locationBias para obtener información sobre cómo definir el viewport.

    Puedes especificar locationRestriction o locationBias, pero no ambas. Piensa en locationRestriction como la especificación región en la que deben estar los resultados y locationBias, ya que que especifica la región a la que los resultados deben estar cerca, pero pueden estar fuera en el área.

  • maxResultCount (obsoleto)

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

  • evOptions

    Especifica los parámetros para identificar el vehículo eléctrico disponible (VE). conectores y velocidades de carga.

    • connectorTypes

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

    • minimumChargingRateKw

      Filtra lugares por velocidad de carga mínima de VE en kilovatios (kW). Cualquiera los lugares con una velocidad de carga inferior a la mínima son filtrado. Por ejemplo, para encontrar cargadores de VE con velocidades de carga que son de, al menos, 10 kW, puedes establecer este parámetro en “10”.

  • minRating

    Restringe los resultados únicamente a aquellos cuya calificación promedio de los usuarios es superior a o igual a 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 son y se redondea al punto decimal más cercano. Por ejemplo, un valor de 0.6 elimina todo resultados con una calificación inferior a 1.0.

  • openNow

    Si es true, devuelve solo los lugares que estén abiertos. en el momento en que se envía la consulta. Si es false, mostrar todas las empresas independientemente del estado abierto. Los lugares que no especifican los horarios de atención en la base de datos de Google Places son que se muestra 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 en 5, se devolverá hasta 5. resultados en la primera página. Si hay más resultados que se pueden devolver de la consulta, la respuesta incluye un nextPageToken que y pasar a una solicitud posterior de acceso a la página siguiente.

  • pageToken

    Especifica el nextPageToken del cuerpo de la respuesta del 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

    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 (clasifica los resultados según la relevancia de la búsqueda) es el valor predeterminado. Puedes establecer rankPreference en RELEVANCE o DISTANCE (clasifica los resultados por distancia).
    • Para una consulta no categórica, como “Mountain View, CA”, recomendamos que deje rankPreference sin configurar.

  • regionCode

    El código de región que se usa para dar formato a la respuesta, especificado como una 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 el si la respuesta coincide con la regionCode, se omite el código de país desde formattedAddress. Este parámetro no tiene efecto en adrFormatAddress, que siempre incluye el país cuando estén disponibles, 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 el código ISO 3166-1 es "gb" (técnicamente para el 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 lugares que coincidan con los tipos especificados por Se devuelven includeType. Cuando es falso, el valor predeterminado, la respuesta puede contener lugares que no coinciden los tipos especificados.

Ejemplos de Text Search

Busca un lugar con una cadena de consulta

El siguiente ejemplo 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 el 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 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 por restaurantes que se define como de bajo costo o moderadamente costoso:

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 elemento places.priceLevel al campo de datos respuesta que tiene la siguiente forma:

{
  "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 y openNow y otros parámetros descritos en Parámetros opcionales.

Cómo buscar lugares en un área

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

El siguiente ejemplo muestra una solicitud de Text Search para "Comida vegetariana picante" se inclina a estar dentro de 500 metros de un punto en el centro de San Francisco. Esta solicitud solo devuelve los primeros 10 resultados para lugares que están 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 carga de VE de tipo 1 y Tesla y J1772 con una velocidad de carga mínima de 10 kW en Mountain View, California. Solo cuatro una lista de los resultados esperados.

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 una cantidad de resultados que devolver por página. El parámetro nextPageToken en el cuerpo de la respuesta proporciona un token que puede usarse en llamadas posteriores para acceder a la siguiente página de resultados.

En el siguiente ejemplo, se muestra una solicitud de "pizza en Nueva York" limitado a 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 página siguiente de resultados, usa pageToken para pasar el 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"
}

Pruébalo

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

  1. Selecciona el ícono de la API, Expande el Explorador de APIs., 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 fields parámetro al campo máscara.

  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 que quieres usar para hacer la solicitud.

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