Los resúmenes de opiniones generados por IA son resúmenes de lugares generados por IA que se basan únicamente en las opiniones de los usuarios. Los resúmenes de opiniones sintetizan elementos clave de las opiniones de los usuarios, como los atributos del lugar y el sentimiento de los revisores, y proporcionan estadísticas de alto nivel que ayudan a los usuarios a tomar decisiones fundamentadas.
Por ejemplo, un resumen de opiniones sobre el Ferry Building en San Francisco incluye información que abarca desde comida y compras hasta vistas y ambiente:
“Los visitantes dicen que este lugar histórico ofrece una amplia selección de tiendas, restaurantes y un mercado de agricultores. Muchos elogian las vistas de la bahía y la ciudad. También destacan el ambiente vibrante, el acceso conveniente en ferry a otros destinos y la oportunidad de disfrutar de las empresas locales".
Los resúmenes de opiniones son compatibles con Place Details (nuevo), Text Search (nuevo) y Nearby Search (nuevo).
Solicita un resumen de la revisión
Para solicitar un resumen de la revisión, incluye reviewSummary en la máscara de campo de la solicitud:
- Place Details (nuevo):
reviewSummary - Text Search (nueva) y Nearby Search (nueva):
places.reviewSummary
Las atribuciones de un resumen de opiniones deben incluir un vínculo a las opiniones del lugar en Google Maps. Para recuperar ese vínculo, incluye googleMapsLinks.reviewsUri en la máscara de campo de la solicitud.
El cuerpo de la respuesta incluye tres campos:
text: Es el resumen de la opinión generado por IA.flagContentUri: Se usa para marcar contenido inapropiado para que Google lo quite.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)
En el siguiente ejemplo, se solicita un resumen de opiniones de un restaurante de dumplings en Nueva York:
curl -X GET https://places.googleapis.com/v1/places/ChIJD2l2k7ZL0YkRC80d-3MV1lM \ -H 'Content-Type: application/json' \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: displayName,reviewSummary,googleMapsLinks.reviewsUri"
La respuesta tiene el siguiente formato:
{ "displayName": { "text": "Dumpling House", "languageCode": "en" }, "googleMapsLinks": { "reviewsUri": "https://www.google.com/maps/place//data=!4m4!3m3!1s0x89d14bb69376690f:0x53d61573fb1dcd0b!9m1!1b1", }, "reviewSummary": { "text": { "text": "Diners say this lunch restaurant serves up delicious dumplings, including pork and chive, soup dumplings, and fried dumplings, alongside other Chinese dishes like fried rice, pork belly buns, and general tso's chicken. They also highlight the generous portions, reasonable prices, and efficient service.", "languageCode": "en-US" }, "flagContentUri": "https://www.google.com/local/review/rap/report?postId=5%401:CAIQACodChtyc19oOkE4blltMzB1eXpWblVKUjFBQXFGbWc%7CCAIQACorChtyc19oOkE4blltMzB1eXpWblVKUjFBQXFGbWcSDAis0fW-BhCIp7blAg&d=17924085&t=8", "disclosureText": { "text": "Summarized with Gemini", "languageCode": "en-US" } } }
Solicitud de Text Search (nueva)
En el siguiente ejemplo, se solicita un resumen de opiniones de una cafetería en la ciudad de Nueva York:
curl -X POST -d '{
"textQuery": "coffee shop",
"locationBias": {
"circle": {
"center": {
"latitude": 40.722630,
"longitude": -74.001397
}
}
},
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.id,places.reviewSummary,places.googleMapsLinks.reviewsUri" \
'https://places.googleapis.com/v1/places:searchText'
El cuerpo de la respuesta tiene el siguiente formato:
{ "places": [ { "id": "ChIJyfJXNphZwokRbo-oe0DjVT4", "googleMapsLinks": { "reviewsUri": "https://www.google.com/maps/place//data=!4m4!3m3!1s0x89c259983657f2c9:0x3e55e3407ba88f6e!9m1!1b1", }, "reviewSummary": { "text": { "text": "People say this coffee shop serves delicious oat milk lattes, iced lattes, and cappuccinos, and they praise the friendly staff and cozy atmosphere. They also highlight the great outdoor seating area and the unique latte flavors.", "languageCode": "en-US" }, "flagContentUri": "https://www.google.com/local/review/rap/report?postId=5%401:CAIQACodChtyc19oOkFONEpuYU1UMzZWbTduX1lBQVRBRkE%7CCAIQACorChtyc19oOkFONEpuYU1UMzZWbTduX1lBQVRBRkESDAj9iuK_BhD4ouCwAw&d=17924085&t=8", "disclaimerText": { "text": "Summarized with Gemini", "languageCode": "en-US" } } }, { "id": "ChIJl5qG27RZwokRzoy63vyI4Gk", "googleMapsLinks": { "reviewsUri": "https://www.google.com/maps/place//data=!4m4!3m3!1s0x89c259b4db869a97:0x69e088fcdeba8cce!9m1!1b1", }, "reviewSummary": { "text": { "text": "People say this coffee shop serves delicious matcha, including the Blueberry Matcha Latte and Cherry Cold Brew Latte, and offers a variety of pastries. They also highlight the friendly and efficient staff, and the cute and aesthetic space.", "languageCode": "en-US" }, "flagContentUri": "https://www.google.com/local/review/rap/report?postId=5%401:CAIQACodChtyc19oOkE4bmRodTgya2MxbkJNMXhBQU1MNXc%7CCAIQACorChtyc19oOkE4bmRodTgya2MxbkJNMXhBQU1MNXcSDAj9iuK_BhD4ouCwAw&d=17924085&t=8", "disclaimerText": { "text": "Summarized with Gemini", "languageCode": "en-US" } } }, /.../ ] }
Solicitud de Nearby Search (nueva)
En el siguiente ejemplo, se solicitan hoteles cerca del centro de Seattle:
curl -X POST -d '{
"maxResultCount": 5,
"locationRestriction": {
"circle": {
"center": {
"latitude": 47.609937,
"longitude": -122.340714
},
"radius": 1000
}
},
"includedTypes": ["hotel"],
"excludedTypes": [],
"rankPreference":"POPULARITY"
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.id,places.reviewSummary,places.googleMapsLinks.reviewsUri" \
'https://places.googleapis.com/v1/places:searchNearby'
La respuesta tiene el siguiente formato:
{ "places": [ { "id": "ChIJRwVmS-BrkFQRpAB3pO5JOuQ", "googleMapsLinks": { "reviewsUri": "https://www.google.com/maps/place//data=!4m4!3m3!1s0x54906be04b660547:0xe43a49eea47700a4!9m1!1b1", }, "reviewSummary": { "text": { "text": "Guests say this hotel has comfortable beds, spacious rooms, and a central location within walking distance of Pike Place Market, the waterfront, and the convention center. They also highlight the friendly and helpful staff, the modern and clean facilities, and the efficient elevators.", "languageCode": "en-US" }, "flagContentUri": "https://www.google.com/local/review/rap/report?postId=5%401:CAIQACodChtyc19oOkJtODg0RUFFSndKbnhkTXZBQVpuV2c%7CCAIQACorChtyc19oOkJtODg0RUFFSndKbnhkTXZBQVpuV2cSDAj9iuK_BhD4ouCwAw&d=17924085&t=8", "disclaimerText": { "text": "Summarized with Gemini", "languageCode": "en-US" } } }, { "id": "ChIJQVJVX7RqkFQRcpsm3VVub9U", "googleMapsLinks": { "reviewsUri": "https://www.google.com/maps/place//data=!4m4!3m3!1s0x54906ab45f555241:0xd56f6e55dd269b72!9m1!1b1", }, "reviewSummary": { "text": { "text": "Guests say this hotel offers comfortable beds, spacious rooms with great views, and a well-equipped gym and pool. They also highlight the friendly and helpful staff, convenient location for walking to attractions and restaurants, and the well-stocked club lounge.\n\nSome reviews mention the elevators can be slow.", "languageCode": "en-US" }, "flagContentUri": "https://www.google.com/local/review/rap/report?postId=5%401:CAIQACodChtyc19oOkE4blJFWWtBUFo5bjNYWndBQVYxZWc%7CCAIQACorChtyc19oOkE4blJFWWtBUFo5bjNYWndBQVYxZWcSDAj9iuK_BhD4ouCwAw&d=17924085&t=8", "disclaimerText": { "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.