Los resúmenes de lugares potenciados por IA son descripciones generales breves de 100 caracteres específicas para un ID de lugar determinado. Los resúmenes de lugares agregan muchos tipos diferentes de datos en una descripción general de alto nivel para ayudar a los usuarios a obtener una instantánea de un lugar.
Por ejemplo, los resúmenes de lugares pueden destacar comidas, servicios o productos populares disponibles para la compra en una ubicación:
- "Restaurante de Forum Shops que sirve grandes porciones de comida tradicional italiana en un espacio informal."
- "Salón elegante que ofrece cortes y tintes de cabello, además de peinados"
- "Tienda grande con muchos proveedores que ofrecen una variedad de decoración vintage, muebles y ropa."
Los resúmenes de lugares son compatibles con Place Details (nuevo), Text Search (nuevo), y Nearby Search (nuevo). Están disponibles para los tipos de lugares que se muestran en Tipos admitidos para las categorías Culture, Entertainment and Recreation, Food and Drink, Shopping, Services, y Sports.
Los resúmenes de lugares son compatibles con los puntos de interés en los siguientes idiomas y regiones:
| Idioma | Región |
|---|---|
| Inglés |
India Estados Unidos |
Solicita un resumen generativo de un lugar
Para mostrar un resumen de un lugar en la respuesta, incluye el siguiente campo en la máscara de campo de la solicitud:
- Place Details (nuevo):
generativeSummary - Text Search (nuevo) y Nearby Search (nuevo):
places.generativeSummary
El generativeSummary contiene los siguientes campos:
generativeSummary: El resumen del lugar.overviewFlagContentUri: Un vínculo en el que los usuarios pueden marcar un problema con el resumen del lugar.disclosureText: Una cadena de texto localizada con el texto de divulgación "Resumido con Gemini" que se debe incorporar en las atribuciones.
Solicitud de Place Details (nuevo)
La siguiente solicitud de Place Details (nuevo) muestra un resumen de overview para un restaurante de sushi en Chicago, IL:
curl -X GET https://places.googleapis.com/v1/places/ChIJ1eOF7HLTD4gRry3xPjk8DkU \ -H 'Content-Type: application/json' \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: displayName,generativeSummary"
La respuesta tiene el siguiente formato:
{ "displayName": { "text": "Sushi Nova - Lincoln Park", "languageCode": "en" }, "generativeSummary": { "overview": { "text": "Casual eatery with all-you-can-eat sushi and other Japanese fare, plus beer and sake.", "languageCode": "en-US" }, "overviewFlagContentUri": "https://www.google.com/local/review/rap/report?postId=CiUweDg4MGZkMzcyZWM4NWUzZDU6MHg0NTBlM2MzOTNlZjEyZGFmMAI&d=17924085&t=12", "disclaimerText": { "text": "Summarized with Gemini", "languageCode": "en-US" } } }
Solicitud de Text Search (nuevo)
La siguiente solicitud de Text Search (nuevo) muestra un resumen de overview para restaurantes vegetarianos picantes en Mountain View, CA:
curl -X POST -d '{
"textQuery": "Spicy Vegetarian Food",
"location_bias": {
"rectangle": {
"low": {
"latitude": 37.415,
"longitude": -122.091
},
"high": {
"latitude": 37.429,
"longitude": -122.065
}
}
},
"maxResultCount": 5
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.id,places.displayName,places.generativeSummary" \
'https://places.googleapis.com/v1/places:searchText'
La respuesta tiene el siguiente formato:
{ "places": [ { "id": "ChIJ8wN5kzm3j4AR_dRdUHoqrPI", "displayName": { "text": "Plant-Based Vegan Vietnamese", "languageCode": "en" } }, { "id": "ChIJw4RuczO3j4ARC7RByZ5K9nI", "displayName": { "text": "sweetgreen", "languageCode": "en" }, "generativeSummary": { "overview": { "text": "Casual eatery offering healthy, made-to-order salads, plates, and grain bowls with vegan options.", "languageCode": "en-US" }, "overviewFlagContentUri": "https://www.google.com/local/review/rap/report?postId=CiUweDgwOGZiNzMzNzM2ZTg0YzM6MHg3MmY2NGE5ZWM5NDFiNDBiMAI&d=17924085&t=12", "disclosureText": { "text": "Summarized with Gemini", "languageCode": "en-US" } } }, /.../ ] }
Solicitud de Nearby Search (nuevo)
La siguiente solicitud de Nearby Search (nuevo) muestra un resumen de overview para restaurantes y cafeterías en Portland, OR:
curl -X POST -d '{
"maxResultCount": 5,
"locationRestriction": {
"circle": {
"center": {
"latitude": 45.553360,
"longitude": -122.674934
},
"radius": 1000
}
},
"includedTypes": ["restaurant", "cafe"],
"excludedTypes": [],
"rankPreference":"POPULARITY"
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.id,places.generativeSummary" \
'https://places.googleapis.com/v1/places:searchNearby'
La respuesta tiene el siguiente formato:
{ "places": [ { "id": "ChIJOa08KlqnlVQR_ZZx1jEcTYY", "generativeSummary": { "overview": { "text": "BBQ and Thai street fare, plus imaginative tropical cocktails, served in a vibrant space.", "languageCode": "en-US" }, "disclosureText": { "text": "Summarized with Gemini", "languageCode": "en-US" } } }, { "id": "ChIJU4OzoWynlVQRxlQMpGenSvA", "generativeSummary": { "overview": { "text": "Beer hall with a big selection of German brews, plus a central courtyard with food trucks.", "languageCode": "en-US" }, "disclosureText": { "text": "Summarized with Gemini", "languageCode": "en-US" } } }, /.../ ] }
Atribuciones
Todos los resúmenes potenciados por IA que se muestran en tu app deben estar acompañados de la atribución adecuada de acuerdo con las políticas y los estándares de Google. Para obtener más información, consulta Políticas de la API de Places.