סיכומי אזורים מבוססי-AI נוצרים לאזור שמסביב למקום. סיכומי אזורים מספקים הקשר נוסף לגבי מיקום מסוים, כולל נקודות עניין בקרבת מקום, כדי שהמשתמשים יוכלו לקבל החלטה מושכלת יותר לגבי המקום שאליו הם רוצים להגיע והפעילויות שהם רוצים לעשות שם.
לדוגמה, כשמבקרים בעיר חדשה, אפשר לראות סיכום של השכונה שבה נמצא המלון כדי לקבל מידע נוסף על האזור:
"האזור התוסס הזה בסן פרנסיסקו, שמשלב בין נורת' ביץ' וצ'יינטאון, נמצא מצפון-מערב לרובע הפיננסי ויש בו ציוני דרך ספרותיים, אטרקציות תרבותיות ייחודיות ומגוון אפשרויות לסעודה. בין המקומות המפורסמים: חנות הספרים האייקונית City Lights, מוזיאון הרכבל המרתק והרחובות ההומים של צ'יינטאון.
האזור מציע שילוב ייחודי של היסטוריה ותרבות, וסביבה ידידותית להולכי רגל שמעודדת גילוי, למרות כמה גבעות והמוני אנשים. אפשר להתעמק בהיסטוריה הספרותית בחנות הספרים City Lights, לחוות את התרבות התוססת של צ'יינהטאון עם המקדשים ומפעלי העוגיות הסיניות או לחזור אחורה בזמן במוזיאון הכבלים. מגוון אפשרויות לסעודה מחכות לכם, החל ממטבח סיני אותנטי ועד לפיצה טעימה".
אם אתם שוקלים לטעון רכב חשמלי, אתם יכולים לראות סיכום שנוצר לגבי תחנת טעינה לרכב חשמלי כדי למצוא בתי קפה או מסעדות בסביבה שאפשר לבקר בהם בזמן ההמתנה:
- "באזור הזה יש מגוון אפשרויות לסעודה במרחק של 9 דקות הליכה, כולל סטארבקס, סושי ג'ין וסייפווי".
בנוסף לתיאור האזור, התשובה מכילה גם רשימה של מזהי מקומות של המקומות שמוזכרים בתיאור.
Places API (חדש) מספק שני סוגים של סיכומי אזורים מבוססי-AI:
- סיכומים של שכונות, שמספקים סקירה כללית של אטרקציות בקרבת מקום למקומות מסוג
premise,street_addressולכל הסוגים בקטגוריות דיור ולינה. - סיכומי שירותים של תחנות טעינה לרכבים חשמליים (EVCS), שכוללים סקירה כללית של אטרקציות בקרבת מקום למקומות מסוג
electric_vehicle_charging_station.
סיכומים של אזורים מבוססי-AI נתמכים בפרטי מקום (חדש), בחיפוש טקסט (חדש) ובחיפוש בסביבה (חדש).
סיכומי אזורים נתמכים בנקודות עניין בשפות ובאזורים הבאים:
| שפה | אזור |
|---|---|
| אנגלית | ארצות הברית |
בקשה לסיכום של השכונה
אפשר ליצור סיכומים של שכונות למקומות עם הסוגים premise,
street_address וכל הסוגים בקטגוריות דיור ולינה. כדי לקבל סיכום של השכונה בתשובה, צריך לכלול את השורה הבאה במסכת השדות של הבקשה:
- Place Details (New):
neighborhoodSummary - Text Search (New) ו-Nearby Search (New):
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 (New) ו-Nearby Search (New):
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.