Yapay zeka destekli yorum özetleri, yalnızca kullanıcı yorumlarına dayalı olarak yapay zeka tarafından oluşturulan yer özetleridir. Yorum özetleri, kullanıcı yorumlarının temel unsurlarını (ör. yer özellikleri ve yorumcu duygusu) sentezleyerek üst düzey analizler sunar ve kullanıcıların bilinçli kararlar vermesine yardımcı olur.
Örneğin, San Francisco'daki Ferry Building'in yorum özetinde yemek ve alışverişten manzaralara ve atmosfere kadar çeşitli bilgiler yer alıyor:
"Ziyaretçiler, bu tarihi simge yapıda çok çeşitli mağazalar, restoranlar ve çiftçi pazarı bulunduğunu, körfez ve şehir manzarasının çok güzel olduğunu söylüyor. Ayrıca canlı atmosferi, diğer yerlere feribotla kolay ulaşımı ve yerel işletmelerin keyfini çıkarma fırsatını da vurguluyorlar."
Yorum özetleri, Yer Ayrıntıları (Yeni), Metin Arama (Yeni) ve Yakında Arama (Yeni)'da desteklenir.
Aşağıdaki dillerde ve bölgelerde ilgi çekici yerlerle ilgili inceleme özetleri desteklenir:
| Dil | Bölge |
|---|---|
| İngilizce | Amerika Birleşik Devletleri, Arjantin, Birleşik Krallık, Bolivya, Brezilya, Dominik Cumhuriyeti, Ekvador, Guatemala, Hindistan, Japonya, Kolombiya, Kosta Rika, Meksika, Paraguay, Peru, Şili, Uruguay, Venezuela |
| Japonca | Japonya |
| Portekizce | Brezilya |
| İspanyolca | ABD, Arjantin, Bolivya, Dominik Cumhuriyeti, Ekvador, Guatemala, Kolombiya, Kosta Rika, Meksika, Paraguay, Peru, Şili, Uruguay, Venezuela |
Yorum özeti isteğinde bulunma
Yorum özeti istemek için isteğin alan maskesine reviewSummary değerini ekleyin:
- Place Details (New):
reviewSummary - Metin Arama (Yeni) ve Yakında Arama (Yeni):
places.reviewSummary
Yorum özetinin ilişkilendirmeleri, Google Haritalar'daki yer yorumlarına bağlantı içermelidir. Bu bağlantıyı almak için isteğin alan maskesine
reviewSummary.reviewsUri
ekleyin.
Yanıt gövdesi üç alan içerir:
text: Yapay zekayla üretilen yorum özeti.flagContentUri: Uygunsuz içeriklerin Google tarafından kaldırılması için işaretlenmesinde kullanılır.disclosureText: Atıflara eklenmesi gereken "Gemini ile özetlendi" açıklama metnini içeren yerelleştirilmiş bir metin dizesi.
Yer Ayrıntıları (Yeni) isteği
Aşağıdaki örnekte, New York'taki bir mantı restoranı için yorum özeti isteniyor:
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"
Yanıt şu biçimdedir:
{ "displayName": { "text": "Dumpling House", "languageCode": "en" }, "reviewSummary": { "text": { "text": "People say this restaurant serves delicious dumplings, noodles, and pork belly buns. They highlight the generous portions, reasonable prices, and quick service. They also like the friendly and accommodating staff.", "languageCode": "en-US" }, "flagContentUri": "https://www.google.com/local/review/rap/report?postId=5%401:CAIQACodChtyc19oOnNwOUFtUVhIX1BoTEZjTFg0MmNXNEE%7CCAIQACorChtyc19oOnNwOUFtUVhIX1BoTEZjTFg0MmNXNEESDAikt7HDBhDopLLxAg&d=17924085&t=8", "disclosureText": { "text": "Summarized with Gemini", "languageCode": "en-US" }, "reviewsUri": "https://www.google.com/maps/place//data=!4m4!3m3!1s0x89d14bb69376690f:0x53d61573fb1dcd0b!9m1!1b1" } }
Metin Arama (Yeni) isteği
Aşağıdaki örnekte, New York City'deki bir kahve dükkanı için yorum özeti isteniyor:
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" \
'https://places.googleapis.com/v1/places:searchText'
Yanıt gövdesi şu biçimdedir:
{ "places": [ { "id": "ChIJyfJXNphZwokRbo-oe0DjVT4", "reviewSummary": { "text": { "text": "People say this coffee shop serves up delicious oat milk lattes, cold brew, and pastries, such as almond croissants and cheese danish. They also highlight the friendly staff, cozy atmosphere, and outdoor seating.", "languageCode": "en-US" }, "flagContentUri": "https://www.google.com/local/review/rap/report?postId=5%401:CAIQACodChtyc19oOkk1Z1UwZkp4cEJ3bnA3aGt5VGJLMFE%7CCAIQACorChtyc19oOkk1Z1UwZkp4cEJ3bnA3aGt5VGJLMFESDAj7p9_BBhCYsoeAAw&d=17924085&t=8", "disclosureText": { "text": "Summarized with Gemini", "languageCode": "en-US" }, "reviewsUri": "https://www.google.com/maps/place//data=!4m4!3m3!1s0x89c259983657f2c9:0x3e55e3407ba88f6e!9m1!1b1" } }, { "id": "ChIJHcFFXH9ZwokR_QKedPacLiQ", "reviewSummary": { "text": { "text": "People say this cafe offers delicious matcha, lattes, and freshly baked pastries, including the popular rose honey latte and blueberry lemon muffin. They highlight the spacious, chill, and cinema-inspired vibe, perfect for working or socializing, and the fast, friendly service. They also like the free WiFi, outlets, and clean restrooms.", "languageCode": "en-US" }, "flagContentUri": "https://www.google.com/local/review/rap/report?postId=5%401:CAIQACodChtyc19oOl8yWTlXS0NDVTk1UEhiTFdBQzhlelE%7CCAIQACorChtyc19oOl8yWTlXS0NDVTk1UEhiTFdBQzhlelESDAikt7HDBhDopLLxAg&d=17924085&t=8", "disclosureText": { "text": "Summarized with Gemini", "languageCode": "en-US" }, "reviewsUri": "https://www.google.com/maps/place//data=!4m4!3m3!1s0x89c2597f5c45c11d:0x242e9cf6749e02fd!9m1!1b1" } }, ... ] }
Yakında Arama (Yeni) isteği
Aşağıdaki örnek istekte, Seattle şehir merkezinin yakınındaki oteller isteniyor:
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" \
'https://places.googleapis.com/v1/places:searchNearby'
Yanıt şu biçimde olmalıdır:
{ "places": [ { "id": "ChIJRwVmS-BrkFQRpAB3pO5JOuQ", "reviewSummary": { "text": { "text": "People say this hotel offers clean, modern, and spacious rooms with comfortable beds and phenomenal city views. They highlight the convenient downtown location, with easy walking access to popular attractions, and the efficient self-parking option. They also like the friendly and helpful staff, and the smooth check-in and check-out process.", "languageCode": "en-US" }, "flagContentUri": "https://www.google.com/local/review/rap/report?postId=5%401:CAIQACodChtyc19oOlJWVG5YOXZrSnZhTXBqUy1rc1JZc3c%7CCAIQACorChtyc19oOlJWVG5YOXZrSnZhTXBqUy1rc1JZc3cSDAikt7HDBhDopLLxAg&d=17924085&t=8", "disclosureText": { "text": "Summarized with Gemini", "languageCode": "en-US" }, "reviewsUri": "https://www.google.com/maps/place//data=!4m4!3m3!1s0x54906be04b660547:0xe43a49eea47700a4!9m1!1b1" } }, { "id": "ChIJQVJVX7RqkFQRcpsm3VVub9U", "reviewSummary": { "text": { "text": "People say this hotel offers spacious rooms, a convenient location near the convention center and Pike Place Market, and a tasty restaurant. They also highlight the friendly and attentive staff, the comfortable beds and pillows, and the convenient amenities such as a Starbucks in the lobby and a club lounge.\n\nSome reviews mention the rooms can be noisy.", "languageCode": "en-US" }, "flagContentUri": "https://www.google.com/local/review/rap/report?postId=5%401:CAIQACodChtyc19oOldJVUlodGhTUTJOdUdTSmFxQWw2Nnc%7CCAIQACorChtyc19oOldJVUlodGhTUTJOdUdTSmFxQWw2NncSDAikt7HDBhDopLLxAg&d=17924085&t=8", "disclosureText": { "text": "Summarized with Gemini", "languageCode": "en-US" }, "reviewsUri": "https://www.google.com/maps/place//data=!4m4!3m3!1s0x54906ab45f555241:0xd56f6e55dd269b72!9m1!1b1" } }, ... ] }
İlişkilendirmeler
Uygulamanızda gösterilen tüm yapay zeka destekli özetlere, Google'ın politikaları ve standartlarına uygun şekilde gerekli atıf yapılmalıdır. Daha fazla bilgi için Places API Politikaları'na bakın.