Los resúmenes de lugares potenciados por IA son descripciones generales breves de 100 caracteres específicas de un ID de lugar determinado. Los resúmenes de lugares agregan muchos tipos de datos diferentes en una descripción general de alto nivel para ayudar a los usuarios a obtener un resumen de un lugar.
Por ejemplo, los resúmenes de lugares pueden destacar alimentos, servicios o bienes populares disponibles para comprar en una ubicación:
- “Restaurante de Forum Shops que sirve grandes porciones de comida italiana tradicional en un espacio informal”.
- “Salón elegante que ofrece cortes de cabello y coloración, además de secado con secador”.
- “Gran tienda con muchos proveedores que ofrecen una variedad de decoración, muebles y ropa vintage”.
Los resúmenes de lugares son compatibles con Place Details (nuevo), Text Search (nuevo) y Nearby Search (nuevo). Los resúmenes de lugares están disponibles para los tipos de lugares que se muestran en Tipos compatibles para las categorías Cultura, Entretenimiento y recreación, Comida y bebida, Compras, Servicios y Deportes.
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 (nueva) y Nearby Search (nueva):
places.generativeSummary
El campo generativeSummary contiene los siguientes campos:
generativeSummary: Es el resumen del lugar.overviewFlagContentUri: Es un vínculo en el que los usuarios pueden marcar un problema con el resumen del lugar.disclosureText: Es una cadena de texto localizada con el texto de divulgación "Resumen con Gemini" que se debe incorporar en las atribuciones.
Solicitud de Place Details (nueva)
La siguiente solicitud a Place Details (nuevo) muestra un resumen overview de un restaurante de sushi en Chicago, Illinois:
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 (nueva)
La siguiente solicitud de Búsqueda de texto (nueva) muestra un resumen overview de los restaurantes vegetarianos picantes en Mountain View, California:
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 (nueva)
La siguiente solicitud de Búsqueda cercana (nueva) muestra un resumen overview de los restaurantes y cafeterías de Portland, Oregón:
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 incluir la atribución adecuada de acuerdo con las políticas y los estándares de Google. Para obtener más información, consulta las Políticas de la API de Places.