סיכומי אזורים מבוססי-AI נוצרים לאזור שמסביב למקום. סיכומי אזורים מספקים הקשר נוסף למיקום, כולל נקודות עניין בקרבת מקום, כדי שהמשתמשים יוכלו לקבל החלטה מושכלת יותר לגבי המקום שאליו הם רוצים להגיע והפעילויות שהם רוצים לעשות שם.
לדוגמה, כשמבקרים בעיר חדשה, אפשר לראות סיכום של השכונה שבה נמצא המלון כדי לקבל מידע נוסף על האזור:
"אזור תוסס בסן פרנסיסקו, שמשלב בין נורת' ביץ' וצ'יינטאון, נמצא מצפון-מערב לרובע הפיננסי וכולל ציוני דרך ספרותיים, אטרקציות תרבותיות ייחודיות ומגוון אפשרויות לסעודה. בין המקומות המעניינים: חנות הספרים המפורסמת City Lights, מוזיאון הרכבל המרתק והרחובות ההומים של צ'יינטאון.
האזור מציע שילוב ייחודי של היסטוריה ותרבות, וסביבה ידידותית להולכי רגל שמעודדת גילוי, למרות כמה גבעות והמוני אנשים. אפשר להתעמק בהיסטוריה הספרותית בחנות הספרים City Lights, לחוות את התרבות התוססת של צ'יינהטאון ע�� ��מק��ש��ם ��מ��על�� ה��וגיות הסיניות, או לחזור אחורה בזמן במוזיאון הרכבל. מגוון אפשרויות קולינריות מחכות לכם, החל ממטבח סיני אותנטי ועד לפיצה טעימה".
אם אתם שוקלים לטעון רכב חשמלי, אתם יכולים לראות סיכום שנוצר על תחנת טעינה לרכב חשמלי כדי למצוא בתי קפה או מסעדות בסביבה שאפשר לבקר בהם בזמן ההמתנה:
- "באזור הזה יש מגוון אפשרויות לסעודה במרחק של 9 דקות הליכה, כולל סטארבקס, סושי ג'ין וסייפווי".
בנוסף לתיאור האזור, התשובה מכילה גם רשימה של מזהי מקומות של המקומות שמוזכרים בתיאור.
Places API (חדש) מספק שני סוגים של סיכומי אזורים מבוססי-AI:
- סיכומים של שכונות, שמספקים סקירה כללית של אטרקציות בקרבת מקום למקומות עם הסוגים
premise
,street_address
וכל הסוגים בקטגוריות Housing ו-Lodging. - סיכומים של שירותים בתחנות טעינה לרכבים חשמליים (EVCS), שכוללים סקירה כללית של אטרקציות בקרבת מקום למקומות מסוג
electric_vehicle_charging_station
.
סיכומים של אזורים מבוססי-AI נתמכים בפרטי מקום (חדש), בחיפוש טקסט (חדש) ובחיפוש בסביבה (חדש).
בקשה לסיכום של השכונה
אפשר ליצור סיכומים של שכונות למקומות שמשויכים לקטגוריות דיור ולינה. כדי לקבל סיכום של השכונה בתשובה, צריך לכלול את השורה הבאה במסכת השדות של הבקשה:
- Place Details (New):
neighborhoodSummary
- Text Search (חדש) ו-Nearby Search (חדש):
places.neighborhoodSummary
השדה neighborhoodSummary
של מקום בתגובה מכיל את הפרטים הבאים:
- שני שדות משנה:
overview
ו-description
. שדה המשנהoverview
כולל נקודות עניין ספציפיות למקום, ושדה המשנהdescription
מספק מידע כללי יותר על האזור שמסביב. כל שדה משנה כולל רשימה של שמות משאבי מקום שאליהם יש הפניה, בפורמטplace/PLACE_ID
. - קישור
flagContentUri
שבו משתמשים יכולים לסמן בעיה בסיכום שנוצר. - מחרוזת טקסט מותאמת לשוק המקומי עם גילוי הנאות 'הסיכום נוצר באמצעות Gemini' שחובה לשלב בשיוכים.
בדוגמה הבאה מוצגת בקשה לקבלת סיכום של השכונה שבה נמצא מלון בניו יורק:
curl -X GET -H 'Content-Type: application/json' \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: id,displayName,neighborhoodSummary" \ 'https://places.googleapis.com/v1/places/ChIJT0DdRo1ZwokRkufwSD-TdGM'
התשובה היא בפורמט:
{ "id": "ChIJT0DdRo1ZwokRkufwSD-TdGM", "displayName": { "text": "Courtyard New York Manhattan/SoHo", "languageCode": "en" } "neighborhoodSummary": { "overview": { "content": { "text": "This area resides within SoHo, a trendy Lower Manhattan neighborhood celebrated for its upscaleboutiques, designer shops, and thriving art scene. The area is home to the Color , "languageCode": "en-US" }, "referencedPlaces": [ "places/ChIJZd0F3oxZwokRiaEouMZKQ-0", /.../ ] }, "description": { "content": { "text": "SoHo's walkability and convenient public transportation options make exploration easy. A diverse arrayFactory and Dominique Ansel Bakery, known for its popular Cronuts." of restaurants and cafes cater to varied tastes. SoHo's central location, , "languageCode": "en-US" }, "referencedPlaces": [ "places/ChIJZd0F3oxZwokRiaEouMZKQ-0", /.../ ] }, "flagContentUri": "https://www.google.com/local/review/rap/report?postId=&d=17924085&t=12", "disclosureText": { "text": "Summarized with Gemini", "languageCode": "en-US" } } }surrounded by vibrant neighborhoods, contributes to its fast-paced and energetic atmosphere, with a focus on fashion and design."
בקשה לסיכום של שירותים בתחנת טעינה לרכב חשמלי
אפשר ליצור סיכומים של מתקנים בתחנות טעינה לרכבים חשמליים (EVCS) במקומות מסוג electric_vehicle_charging_station
. כדי לכלול את סיכום השירותים של EVCS בתגובה, צריך לכלול את הפרטים הבאים במסכת השדות של הבקשה:
- Place Details (New):
evChargeAmenitySummary
- Text Search (חדש) ו-Nearby Search (חדש):
places.evChargeAmenitySummary
השדה evChargeAmenitySummary של מקום בתגובה מכיל את הפרטים הבאים:
- ארבעה שדות משנה:
overview
,coffee
,restaurant
וstore
. כל שדה משנה כולל תיאור קצר של מוקדי עניין קרובים ורשימה של שמות משאבים של מקומות שאליהם יש הפניה, בפורמטplace/PLACE_ID
. flagContentUri
קישור שדרכו משתמשים יכולים לסמן בעיה בסיכום שנוצר.- מחרוזת טקסט שעברה לוקליזציה עם גילוי הנאות 'הסיכום נוצר באמצעות Gemini' שחובה לכלול בשיוכים.
בדוגמה הבאה מוצגת בקשה לסיכום של שירותים בתחנת טעינה לרכב חשמלי (EV) בתל אביב:
curl -X GET -H 'Content-Type: application/json' \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: id,displayName,evChargeAmenitySummary" \ 'https://places.googleapis.com/v1/places/ChIJtwHgNNa2j4ARlC8vbI9lLZA'
התשובה היא בפורמט:
{ "id": "ChIJf8j-4z23j4AR_MQ2-bgMmrY", "displayName": { "text": "EVgo Charging Station", "languageCode": "en" }, "evChargeAmenitySummary": { "overview": { "content": { "text": "Within a short walk, there are several coffee and restaurant options, including Clocktower CoffeeRoasting Company, Khao Kang Thai Kitchen, and Roger's Deli & Donuts." , "languageCode": "en-US" }, "referencedPlaces": [ "places/ChIJZZR2-j23j4ARi5CXEIAc57Q", /.../ ] }, "coffee": { "content": { "text": "Clocktower Coffee Roasting Company has Wi-Fi and a variety of coffee and pastries in a laid-backatmosphere." , "languageCode": "en-US" }, "referencedPlaces": [ "places/ChIJZZR2-j23j4ARi5CXEIAc57Q" ] }, "restaurant": { "content": { "text": "Roger's Deli & Donuts is a bustling deli with sandwiches and breakfast items.\nJoy Sushi servesclassic Japanese dishes, including vegetarian and healthy options.\nSubway is a chain sandwich shop , "languageCode": "en-US" }, "referencedPlaces": [ "places/ChIJQ4F3PBa3j4ARf7_QjN1Cklo", /.../ ] }, "store": { "content": { "text": "Rotten Robbie is a chain gas station with a convenience store and a restroom.", "languageCode": "en-US" }, "referencedPlaces": [ "places/ChIJA6deFBa3j4AREY0EyTEGhN8", /.../ ] }, "flagContentUri": "https://www.google.com/local/review/rap/report?postId=ABCDEFG=1234567&t=12", "disclosureText": { "text": "Summarized with Gemini", "languageCode": "en-US" } } }offering its usual subs, wraps, and salads."
שיוכים
כל הסיכומים שמבוססים על AI ומוצגים באפליקציה שלכם צריכים לכלול את הקרדיט המתאים בהתאם למדיניות ולסטנדרטים של Google. מידע נוסף זמין במאמר מדיניות בנושא Places API.