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