Podsumowania opinii oparte na AI to podsumowania miejsc generowane przez AI na podstawie wyłącznie opinii użytkowników. Podsumowując najważniejsze elementy opinii użytkowników, takie jak atrybuty miejsca i nastroje recenzentów, podsumowania opinii dostarczają ogólnych informacji i pomagają użytkownikom podejmować świadome decyzje.
Na przykład podsumowanie opinii o terminalu promowym w San Francisco zawiera informacje dotyczące m.in. jedzenia, zakupów, widoków i atmosfery:
„Zwiedzający twierdzą, że ten zabytkowy punkt orientacyjny oferuje zróżnicowany wybór sklepów, restauracji i rynku rolniczego. Wielu chwali widoki na zatokę i miasto. Podkreślają też żywą atmosferę, dogodny dostęp do promów do innych miejsc oraz możliwość korzystania z lokalnych firm”.
Podsumowania opinii są obsługiwane w funkcjach Szczegóły miejsca (nowa), Wyszukiwanie tekstowe (nowa) i Wyszukiwanie w pobliżu (nowa).
Wysyłanie prośby o podsumowanie sprawdzenia
Aby poprosić o podsumowanie sprawdzenia, w polu maski żądania podaj wartość reviewSummary:
- Szczegóły miejsca (nowa wersja):
reviewSummary - Wyszukiwanie tekstowe (nowa funkcja) i Wyszukiwanie w pobliżu (nowa funkcja):
places.reviewSummary
Informacje o źródle podsumowania opinii muszą zawierać link do opinii o miejscu w Mapach Google. Aby pobrać ten link, dodaj wartość googleMapsLinks.reviewsUri do maski pola w żądaniu.
Treść odpowiedzi zawiera 3 pola:
text: podsumowanie opinii wygenerowane przez AI.flagContentUri: służą do oznaczania nieodpowiednich treści do usunięcia przez Google.disclosureText: zlokalizowany ciąg tekstowy z tekstem informującym o tym, że treść została streszczona za pomocą Gemini, który musi zostać uwzględniony w przypisach.
żądanie dotyczące informacji o miejscu (nowe);
W tym przykładzie prosimy o podsumowanie opinii o restauracji z pierogami w Nowym Jorku:
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"
Odpowiedź ma postać:
{ "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" } } }
Prośba o wyszukiwanie tekstowe (nowa)
W tym przykładzie żądamy podsumowania opinii o kawiarni w Nowym Jorku:
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'
Treść odpowiedzi ma postać:
{ "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" } } }, /.../ ] }
Prośba o włączenie funkcji Wyszukiwanie w pobliżu (nowa)
W tym przykładzie żądamy informacji o hotelach w pobliżu centrum 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'
Odpowiedź ma postać:
{ "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" } } }, /.../ ] }
Atrybucje
Wszystkie podsumowania generowane przez AI wyświetlane w aplikacji muszą być opatrzone odpowiednim powiadomieniem zgodnie z zasadami i standardami Google. Więcej informacji znajdziesz w zasadach dotyczących interfejsu Places API.