خلاصه مکانهای مجهز به هوش مصنوعی، خلاصههای مختصر و ۱۰۰ کاراکتری مختص به یک شناسه مکان مشخص هستند. خلاصه مکانها انواع مختلفی از دادهها را در یک نمای کلی سطح بالا جمع میکنند تا به کاربران کمک کنند تصویری کلی از یک مکان داشته باشند.
برای مثال، خلاصه مکانها ممکن است غذاها، خدمات یا کالاهای محبوب موجود برای خرید در یک مکان را برجسته کند:
- «رستوران فروم شاپز، غذاهای سنتی ایتالیایی را در فضایی خودمانی سرو میکند.»
- «سالن زیبایی که خدمات کوتاهی و رنگ مو و همچنین اکستنشن مو ارائه میدهد.»
- «فروشگاهی بزرگ با فروشندگان فراوان که انواع دکور، مبلمان و لباسهای قدیمی را ارائه میدهند.»
خلاصه مکانها توسط جزئیات مکان (جدید) ، جستجوی متن (جدید) و جستجوی نزدیک (جدید) پشتیبانی میشوند. خلاصه مکانها برای انواع مکانهای نشان داده شده در انواع پشتیبانی شده برای دستههای فرهنگ ، سرگرمی و تفریح ، غذا و نوشیدنی ، خرید ، خدمات و ورزش در دسترس هستند.
خلاصه مکانها برای نکات مورد علاقه در زبانها و مناطق زیر پشتیبانی میشود:
| زبان | منطقه |
|---|---|
| انگلیسی | هند ایالات متحده |
درخواست خلاصه مکان مولد
برای برگرداندن خلاصه مکان در پاسخ، فیلد زیر را در ماسک فیلد درخواست قرار دهید:
- جزئیات مکان (جدید):
generativeSummary - جستجوی متن (جدید) و جستجوی نزدیک (جدید):
places.generativeSummary
فیلد generativeSummary شامل فیلدهای زیر است:
-
generativeSummary: خلاصه مکان. -
overviewFlagContentUri: لینکی که کاربران میتوانند در آن مشکل مربوط به خلاصه مکان را علامتگذاری کنند. -
disclosureText: یک رشته متنی بومیسازیشده با متن افشای «خلاصهشده با Gemini» که باید در انتسابها گنجانده شود.
درخواست جزئیات مکان (جدید)
درخواست جزئیات مکان (جدید) زیر، خلاصهای از overview یک رستوران سوشی در شیکاگو، ایلینوی را برمیگرداند:
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"
پاسخ به این شکل است:
{ "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" } } }
درخواست جستجوی متن (جدید)
درخواست جستجوی متن زیر (جدید) overview از رستورانهای مخصوص گیاهخواران تند در مانتین ویو، کالیفرنیا را برمیگرداند:
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'
پاسخ به این شکل است:
{ "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" } } }, /.../ ] }
درخواست جستجوی نزدیک (جدید)
درخواست جستجوی نزدیک (جدید) زیر، overview از رستورانها و کافههای پورتلند، اورگان را برمیگرداند:
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'
پاسخ به این شکل است:
{ "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" } } }, /.../ ] }
انتسابها
تمام خلاصههای نمایش داده شده با هوش مصنوعی در برنامه شما باید با انتساب مناسب مطابق با سیاستها و استانداردهای گوگل همراه باشند. برای اطلاعات بیشتر، به سیاستهای Places API مراجعه کنید.