היכולות של Gemini ב-Places API (חדש) מספקות תמיכה ב-LLMs ב-Places API, כדי שאפשר יהיה להחזיר את הנתונים המשויכים למקום (שעות פתיחה, ביקורות, תמונות) ונתונים שמתקבלים ממודלים מסוג LLM. הנתונים הגנרטיביים האלה מכילים נתונים נצברים ומסכמים ממודלים מסוג LLM כדי לשפר את הנתונים שכבר משויכים למקום מסוים.
לדוגמה, חיפוש רגיל של Text Search (New) (חיפוש טקסט חשמלי) ל-EV (תחנות טעינה לרכב חשמלי) מחזיר רשימה של מקומות שמציעים בהם טעינה לרכב חשמלי. אפשר לקבל תשובה מהסוג הזה אם אתם רק מחפשים את המטען החשמלי הקרוב ביותר או את המטען הקרוב ביותר שתואם לרכב שלכם.
אבל כדאי גם להבין טוב יותר את האזור שמסביב לתחנת הטעינה, במיוחד אם אתם עומדים להיות שם שעה או יותר בזמן שהרכב נטען. כשמשתמשים ביכולות של מודל Gemini לאותו חיפוש, התשובה יכולה לכלול תיאורים דינמיים וגנרטיביים של כל מקום בתגובה, כולל מידע על האזור שמסביב לתחנת הטעינה:
"במרחק של 2-4 דקות הליכה, יש כמה מסעדות וקניות, כולל השף צ'ו'ס, שף צ'ו, בית הברביקיו הקוריאני הגנרטיבי, אמבר הודו, אטליז, ומספר חנויות מכולת כמו Walmart, Whole Foods Market ו-Trader Joe's."
"במרחק של הליכה של דקה עד 5 דקות, יש מספר אפשרויות לאוכל ולקניות, כולל המטבח התאילנדי Khao Kang, Roger's Deli & Donuts ו-La Costeña. אם אתם אוהבים סושי, האפשרות הטובה ביותר היא ג'וי סושי. למוצרי מכולת, USD Tree מציע מגוון מוצרים במחירים מוזלים."
התוכן הגנרטיבי הזה מ-LLM משפר את התשובות ומספק מידע נוסף שעוזר למשתמשים לקבל החלטה מושכלת.
נוספו תכונות מבוססות-AI ל-Places API (חדש)
היכולות האלו מוסיפות את הנתונים הבאים לתגובה של Places API (חדש):
סיכומים גנרטיביים של מקומות שקשורים למקום ספציפי. אפשר להיעזר בסיכומים של מקומות פרטי מקום (חדש), חיפוש טקסט (חדש) וחיפוש בקרבת מקום (חדש).
סיכומים של שטחים גנרטיביים שקשורים לאזור ספציפי. סיכומי תחומים נתמכים על ידי פרטי מקום (חדש), חיפוש טקסט (חדש) וחיפוש בקרבת מקום (חדש).
תוצאות החיפוש לפי הקשר נתמכות על ידי חיפוש טקסט (חדש) ומכילות נתונים על סמך מחרוזת החיפוש שהועברה בבקשה, ולא על סמך נתונים שמשויכים ישירות למקום. בעזרת הנתונים האלה אפשר להבין איך התכונה 'חיפוש טקסט' (חדש) קובעת את התגובה.
סיכומים גנרטיביים של מקומות
סיכומים גנרטיביים של מקומות הם ספציפיים למזהה מקום. סיכומים נצברים סוגים רבים של נתונים בסיכום אחד לגבי המקום.
Places API (חדש) מספק שני סוגים של סיכומי מקומות גנרטיביים:
סיכומי סקירה כללית: סקירה כללית קצרה של מקום, בממוצע כ-100 תווים. היא יכולה לעזור למשתמשים לקבל תמונת מצב של המקום.
תקצירי תיאורים: סיכומים ארוכים יותר של המקום, באורך של כ-400 תווים בממוצע, שמספקים סקירה מפורטת ומפרטת את ההיבטים המובילים של המקום.
בשלב זה, אפשר לראות סיכום של מקומות עם סוגי המקומות נתמכים בקטגוריות תרבות, בידור ופנאי, אוכל ומשקאות, שופינג וספורט.
סיכום אזורים גנרטיביים
סיכומים של שטחים גנרטיביים נוצרים על ידי ה-LLM לגבי האזור בסביבה הקרובה. סיכום האזור של המקום עשוי לכלול את כל המידע שנדרש כדי לקבל החלטה, בלי שהמשתמש יצטרך לשלוח בקשות נוספות כדי להציג פירוט של פרטי האזור.
יחד עם תיאור האזור, התשובה מכילה גם רשימה של מזהי מקומות של המקומות שמוזכרים בתיאור, ורשימה של מקומות שממוינים לפי סוגי תוכן שונים. לדוגמה, סוג תוכן אחד מכיל רשימה של מקומות שמשויכים לפעילויות באזור, וסוג תוכן אחר מכיל רשימת מסעדות באזור.
בשלב זה, אפשר לקבל סיכום של התחומים לגבי סוגי המקומות שמופיעים בסוגים נתמכים של הקטגוריה לינה, וגם לפי סוגי המקומות הספציפיים electric_vehicle_charging_station, geocode ו-premise.
יצירת סיכומים לגבי מקומות ואזורים
הסיכומים הגנרטיביים של המקומות והסיכומים הגנרטיביים של המקומות נוצרים אופליין לעיתים קרובות על ידי Google. יצירת הסיכומים אופליין תאפשר לך ליהנות מהתוכן שמופעל על ידי Gemini, ועדיין תשיג את אותם הביצועים מ-Places API (החדש) שהיית מצפה להם.
Google יוצרת מחדש את התקצירים האלה לעיתים קרובות כדי לוודא שהם עדכניים על סמך המידע העדכני ביותר שזמין. זה אומר שבקריאה ל-API יוצגו הנתונים העדכניים ביותר בשירות.
תוצאות חיפוש לפי הקשר
חיפוש טקסט (חדש) מחזיר מידע על קבוצה של מקומות על סמך מחרוזת - לדוגמה, "פיצה בתל אביב" או "חנויות נעליים ליד חיפה". התשובה של 'חיפוש טקסט' (חדש) מכילה רשימה של מקומות שתואמים למחרוזת הטקסט ולכל הטיות המיקום שהוגדרו בבקשה.
כשמוסיפים לתשובה תוצאות חיפוש לפי הקשר, התשובה כוללת עכשיו ביקורות, תמונות והצדקות שעוזרות למשתמשים לענות על השאלות:
- למה אני רואה את המקום הזה בתוצאות?
- למה כדאי לבחור במקום הזה?
לדוגמה, אתם שולחים היום בקשה לפרטי מקום (חדש), חיפוש טקסט (חדש) או חיפוש בקרבת מקום (חדש) שכוללת מקום ספציפי בתשובה. נתוני התגובה לגבי המקום זהים בכל שלוש הבקשות, כי הנתונים שהוחזרו משויכים לאותו מקום.
עם זאת, עבור חיפוש טקסט (חדש) שמשתמש ביכולות החדשות, התגובה יכולה לכלול נתונים שנגזרים מהמחרוזת של שאילתת הקלט עצמה. המשמעות היא שתוצאות החיפוש לפי הקשר הן ייחודיות למחרוזת השאילתה. לדוגמה, בקשת חיפוש טקסט (חדש) עם מחרוזת השאילתה הבאה:
"מסעדה צמחונית חריפה במאונטיין ויו, קליפורניה"
לאחר מכן משאירים את כל הפרמטרים של הקלט ללא שינוי ומשנים את מחרוזת השאילתה רק כך:
"מסעדה טבעונית חריפה במאונטיין ויו, קליפורניה"
לגבי מסעדה שמופיעה בשתי התשובות, נתוני התגובה לגבי המקום זהים כי הם משויכים למקום עצמו. אבל תוצאות החיפוש לפי הקשר הן ייחודיות לשאילתה כי הן נגזרות ממחרוזת השאילתה. לאחר מכן תוכלו להציג למשתמשים את הביקורות, התמונות וההצדקה מתוצאות החיפוש לפי הקשר, כדי לעזור להם להחליט איזה מקום בתגובה הכי רלוונטי לבקשת החיפוש שלהם.
הפעלת יכולות של מודלים של Gemini עבור Places API (חדש)
עליכם להפעיל את Places API (חדש) כדי להשתמש ביכולות של מודלים של Gemini עבור Places API (חדש). מידע נוסף זמין במאמר הגדרת פרויקט Google Cloud.
ההגבלות של גרסת הניסוי
הגרסה הזו תומכת רק בסיכומים של מקומות ואזורים בארה"ב, באנגלית בלבד.
מה זה Gemini?
מידע נוסף על מודל Gemini זמין בשאלות הנפוצות על Gemini.
בקשה לקבלת סיכום יצירתי של המקום
סיכומי מקומות הם סיכומים גנרטיביים שה-LLM יוצר לגבי מקום ספציפי. Places API (חדש) מוסיף שני סוגים של סיכומים לתשובה:
Overview תקצירים גנרטיביים שדומים לסיכום העריכה הסטטי שמשויך למקום מסוים. לתקצירים קצרים גנרטיביים יש מספר יתרונות, בממוצע של 100 תווים:
במקומות רבים אין תקצירי עורכים, כך שהם ממלאים את הפער במידע שזמין על המקום.
הם נוצרים מה-LLM, כך שבעלי המקום לא צריכים לתחזק אותם.
סיכומים גנרטיביים של תיאור מגיעים ממקורות רבים, כולל ביקורות ממפות Google. התיאור כולל בממוצע כ-400 תווים, והוא כולל רשימה של ביקורות ששימשו ליצירת התיאור הארוך.
כדי ליצור סיכומי תיאורים בכתב יד, אחד מהם צריך לאסוף נתונים ממיקומים רבים, ואז ליצור ולתחזק את התוכן באופן ידני. היכולות של המודלים של Gemini ל-Places API (חדש) יוצרות את הסיכומים האלה מ-LLM, כדי לשמור על ההיקף והעדכניות של התוכן שנוצר.
אפשר להיעזר בסיכומים של מקומות פרטי מקום (חדש), חיפוש טקסט (חדש) וחיפוש בקרבת מקום (חדש). כדי לכלול בתשובה את סיכום המקום, כוללים את השדה הבא במסכת השדות של הבקשה:
פרטי המקום:
generativeSummaryחיפוש טקסט וחיפוש בקרבת מקום:
places.generativeSummary
השדה generativeSummary מכיל את השדות הבאים:
generativeSummary.overview: סיכום של הסקירה הגנרטיבית.generativeSummary.description: סיכום התיאור הגנרטיבי.generativeSummary.references: מערך של עד חמש ביקורות המשמשות לספק תוכן לסיכום התיאור. אם אין סיכום תיאור, המערך הזה יהיה ריק.
דוגמה לבקשת סיכום של סקירה כללית
הדוגמה הזו של חיפוש טקסט מחזירה רק את הסיכום 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.overview" \
https://places.googleapis.com/v1/places:searchText
התשובה מכילה את השדה generativeSummary.overview, שכולל את overview.text ואת overview.languageCode:
{
"places": [
{
"id": "ChIJQ8nPjFW3j4ARcAaUg5pF-Ts",
"displayName": {
"text": "Zareen's",
"languageCode": "en"
},
"generativeSummary": {
"overview": {
"text": "Casual restaurant serving halal Pakistani and Indian cuisine, plus a selection of vegetarian items.",
"languageCode": "en-US"
}
}
},
{
"id": "ChIJETHw0F-7j4AR85V_I6OobCI",
"displayName": {
"text": "Hyderabad Dum Biryani",
"languageCode": "en"
},
"generativeSummary": {
"overview": {
"text": "Casual eatery offering vegetarian & non-vegetarian Indian fare, plus breads & desserts.",
"languageCode": "en-US"
}
}
},
. . .
}
בקשה לדוגמה לסקירה כללית ולסיכום תיאור
בדוגמה הזו מופיעה אותה שאילתה כמו בדוגמה הקודמת, אבל נעשה שימוש במסכת שדות של places.generativeSummary כדי להחזיר את האובייקט generativeSummary כולו, כולל השדות generativeSummary.overview, generativeSummary.description ו-generativeSummary.references:
{
"places": [
{
"id": "ChIJQ8nPjFW3j4ARcAaUg5pF-Ts",
"displayName": {
"text": "Zareen's",
"languageCode": "en"
},
"generativeSummary": {
"overview": {
"text": "Casual restaurant serving halal Pakistani and Indian cuisine, plus a selection of vegetarian items.",
"languageCode": "en-US"
},
"description": {
"text": "Pakistani restaurant dishing up comfort food including vegetarian, vegan, and halal options.
Offerings include chicken tikka masala, naan, and paratha. There's also a salad bar, and dessert is
available.\nOpen for breakfast, lunch, and dinner, the venue has a casual atmosphere and outdoor rooftop
seating. People mention the ambiance and say the service is prompt.\nCustomers typically spend $10–20.",
"languageCode": "en-US"
},
"references": {
"reviews": [
{
"name": "places/ChIJQ8nPjFW3j4ARcAaUg5pF-Ts/reviews/ChZDSUhNMG9nS0VJQ0FnSUN4aUtDbVJREAE",
"relativePublishTimeDescription": "12 months ago",
"rating": 5,
"text": {
"text": "Insanely good Pakistani food with the perfect ambiance! This food never disappoints AND THEY ARE OPEN TILL MIDNIGHT!!",
"languageCode": "en"
},
"originalText": {
"text": "Insanely good Pakistani food with the perfect ambiance! This food never disappoints AND THEY ARE OPEN TILL MIDNIGHT!!",
"languageCode": "en"
},
"authorAttribution": {
"displayName": "Anam Qureshi",
"uri": "https://www.google.com/maps/contrib/116859422317024657778/reviews",
"photoUri": "https://lh3.googleusercontent.com/a-/ALV-UjWbImVTop_1dl9FTSmec0x00000000-cc-rp-mo"
},
"publishTime": "2023-05-09T07:24:36Z"
},
. . .
]
}
}
},
{
"id": "ChIJETHw0F-7j4AR85V_I6OobCI",
"displayName": {
"text": "Hyderabad Dum Biryani",
"languageCode": "en"
},
"generativeSummary": {
"overview": {
"text": "Indian restaurant offering comfort food including vegetarian and vegan options.",
"languageCode": "en-US"
},
. . .
}
מבקשים סיכום של האזור הגנרטיבי
סיכומי תחומים הם סיכומים גנרטיביים שנוצרו על ידי ה-LLM בשביל האזור בסביבה הקרובה. סיכומי תחומים יכולים להיות חשובים למשתמשים שמקבלים החלטה לגבי מקום.
לדוגמה, אם אתם רוצים להזמין מלון בעיר חדשה, ובשלב הזה תוכלו למצוא מלון שעומד בדרישות שלכם, ותוכלו גם לקבל מידע נוסף על האזור שמסביב למלון. במקום להסתכל במפה של האזור מסביב ולאחר מכן לחקור כל מקום במפה, אפשר ליצור סיכום אזור עבור המלון.
סיכומי תחומים נתמכים על ידי פרטי מקום (חדש), חיפוש טקסט (חדש) וחיפוש בקרבת מקום (חדש).
על מנת לכלול את סיכום האזור בתגובה, צריך לכלול את מסכת השדות של הבקשה:
areaSummary(פרטי המקום)places.areaSummary(חיפוש טקסט וחיפוש בקרבת מקום).
השדה areaSummary של מקום בתשובה מכיל מערך של עד ארבעה contentBlocks.
הנושא של כל חסימה מבוסס על סוג המקום:
בתחנת טעינה לרכב חשמלי (EV), שמוגדרת כמקום מסוג
electric_vehicle_charging_station, בלוקים של הנושאים כוללים את:"overview","coffee","restaurant"ו-"store".למקומות עם סוג שמוגדר לפי הקטגוריה לינה וסוגי המקומות הספציפיים
geocodeו-premise, חסימות הנושאים כוללות את:"overview","activity","restaurant"ו-"store".
בקשה לדוגמה לסיכום אזור בתחנת טעינה לרכב חשמלי (EV)
הבקשה לדוגמה של Place Details מחזירה את סיכום האזור לתחנת טעינה ספציפית של רכב חשמלי ב-Mountain View, שמזוהה לפי מזהה המקום ChIJC5b6QKiwj4ARgn2EwlnJnWU:
curl -X GET -H 'Content-Type: application/json' \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: id,displayName,areaSummary" \ https://places.googleapis.com/v1/places/ChIJC5b6QKiwj4ARgn2EwlnJnWU
התשובה מכילה את השדה areaSummary, כולל המערך contentBlocks:
השדה
topicמציין את הסוג של קטע התוכן. מכיוון שהמקום בדוגמה הזו הוא תחנת טעינה לרכב חשמלי (EV), ארבעת גושי התוכן הם"overview","coffee","restaurant"ו-"store".השדה
contentכולל את הסיכום של אותו נושא, כולל קוד השפה.המערך
referencesמציין את השמות של משאבי המקומות, בפורמטplaces/PLACE_ID, שמשמשים כדי לספק תוכן לקטע התוכן.
{
"id": "ChIJC5b6QKiwj4ARgn2EwlnJnWU",
"displayName": {
"text": "EVgo Charging Station",
"languageCode": "en"
},
"areaSummary": {
"contentBlocks": [
{
"topic": "overview",
"content": {
"text": "Within a 4-minute walk, there are several dining and shopping options from this charging station, including Starbucks and Los Altos Taqueria.",
"languageCode": "en-US"
},
"references": {
"places": [
"places/ChIJ-f-lEaiwj4ARB1IwfdLFfRY",
"places/ChIJhzHBsAe6j4ARvq9oi8u-bqQ"
]
}
},
{
"topic": "coffee",
"content": {
"text": "Starbucks offers Wi-Fi, light bites, and its signature roasts in a cozy space.",
"languageCode": "en-US"
},
"references": {
"places": [
"places/ChIJ-f-lEaiwj4ARB1IwfdLFfRY"
]
}
},
{
"topic": "restaurant",
"content": {
"text": "Los Altos Taqueria serves classic Mexican dishes in a kid-friendly venue.\nHyderabad Dum Biryani specializes in vegetarian and vegan Indian fare, including lunch and dinner options.\nSushi Jin is a popular spot for sushi and other Japanese dishes, featuring a relaxed atmosphere.\nSuper tacos el conrro is a kid-friendly spot for Mexican fare.",
"languageCode": "en-US"
},
"references": {
"places": [
"places/ChIJhzHBsAe6j4ARvq9oi8u-bqQ",
"places/ChIJETHw0F-7j4AR85V_I6OobCI",
"places/ChIJ-9pg_Qmxj4AR4deSLfZINW0",
"places/ChIJvcqEhTyxj4AR4ZdQevNxGZk"
]
}
},
{
"topic": "store",
"content": {
"text": "Safeway provides a range of groceries, along with a deli and a bakery.",
"languageCode": "en-US"
},
"references": {
"places": [
"places/ChIJF7_iDaiwj4ARzdC4NlGzJFI"
]
}
}
]
}
}
בקשה לדוגמה לסיכום אזור במלון
דוגמה זו לבקשה של חיפוש טקסט היא בקשה למלונות במאונטיין ויו, קליפורניה:
curl -X POST -d '{
"textQuery": "Hotels",
"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.areaSummary" \
https://places.googleapis.com/v1/places:searchText
התשובה מכילה את השדה areaSummary, כולל המערך contentBlocks. התשובה לגבי מקומות מסוג 'מלון' מכילה בלוקים של תוכן לנושאים "overview", "activity", "restaurant" ו-"store":
{
"places": [
{
"id": "ChIJ81X7bC63j4ARNJTuqMFBq-4",
"displayName": {
"text": "Shashi Hotel Mountain View, an Urban Resort",
"languageCode": "en"
},
"areaSummary": {
"contentBlocks": [
{
"topic": "overview",
"content": {
"text": "This area offers several attractions, including Cinemark Century Mountain View 16 and Computer History Museum. Charleston Park provides picnic spots and the Pear Theatre hosts performances.",
"languageCode": "en-US"
},
"references": {
"places": [
"places/ChIJOYvCo1W3j4AR1LAifgk13rs",
"places/ChIJm7NJkla3j4AR8vR-HWRxgOo",
"places/ChIJo4za6vi5j4ARMua093RgGGA",
"places/ChIJ4V-yslC3j4ARE6I2cpvyOeU"
]
}
},
{
"topic": "activity",
"content": {
"text": "Cinemark Century Mountain View 16 offers XD and RealD 3D screens, plus comfortable seating and a snack bar.\nComputer History Museum showcases the evolution of technology with interactive exhibits.\nRyptic Room Escape Mountain View presents themed rooms where teams solve puzzles to escape.",
"languageCode": "en-US"
},
"references": {
"places": [
"places/ChIJOYvCo1W3j4AR1LAifgk13rs",
"places/ChIJm7NJkla3j4AR8vR-HWRxgOo",
"places/ChIJ1_ZkCKqwj4ARPaLA4yiEtdI"
]
}
},
{
"topic": "restaurant",
"content": {
"text": "Cucina Venti Restaurant prepares Italian cuisine in a rustic setting with outdoor seating.\nRoger Bar and Restaurant provides cocktails on tap, along with an indoor-outdoor bar and dining area.\nBroma Restaurant serves Spanish-inspired tapas and shareable plates in a trendy atmosphere.",
"languageCode": "en-US"
},
"references": {
"places": [
"places/ChIJC_3cdla3j4ARMgf4Pw8Irek",
"places/ChIJh1Y1MA23j4AREJz6Kxl75Uo",
"places/ChIJLRvDZtu3j4ARgoNrKZnNw8g"
]
}
},
{
"topic": "store",
"content": {
"text": "NASA Gear Store and Food Mart offer a variety of gifts and convenience store items.",
"languageCode": "en-US"
},
"references": {
"places": [
"places/ChIJh64-r0O3j4ARy1P41IH2j3k",
"places/ChIJ5ZJtB8u3j4ARR0gohzD8-ns"
]
}
}
]
}
},
...
]
}
בקשת תוצאות חיפוש לפי הקשר
התשובה לבקשת חיפוש טקסט (חדש) מכילה מערך של מקומות שתואמים לקריטריונים של מחרוזת החיפוש של הקלט. עכשיו תוכלו לבקש נתוני חיפוש לפי הקשר בתגובה על סמך שאילתת הקלט ל-API.
כדי לתמוך בסיכומים לפי הקשר, התשובה מחיפוש טקסט (חדש) מכילה מערך חדש בשם contextualContents באותה רמה כמו המערך places בתגובה:
{
"places": [],
"contextualContents":[]
}
כל רכיב במערך contextualContents, מסוג ContextualContent, נמצא במיקום המערך המתאים כמיקום במערך places. כלומר, הרכיב ב-contextualContents[0] תואם למקום שב-places[0].
כל רכיב מערך מכיל את שדות המערך הבאים:
contextualContents.reviews: מערך של עד שלוש ביקורות.contextualContents.photos: מערך של עד חמש תמונות.contextualContents.justifications: מגוון הצדקות למיקום, כולל:reviewJustification: הדגשת קטע בביקורת של משתמש שעשוי לעניין משתמש קצה.businessAvailabilityAttributesJustification: כולל מאפיינים של עסק שיכול לעניין משתמש קצה.
כדי לכלול בתשובה את תוצאות החיפוש לפי הקשר, צריך לכלול contextualContents במסכת השדות של הבקשה לחיפוש טקסט (חדש):
curl -X POST -d '{
"textQuery": "Spicy vegetarian restaurant in Mountain View, CA",
"openNow": true,
"maxResultCount": 3
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.id,places.displayName,contextualContents" \
https://places.googleapis.com/v1/places:searchText
התשובה מכילה את המערך contextualContents לכל מקום בתגובה:
{
"places": [
{
"id": "ChIJETHw0F-7j4AR85V_I6OobCI",
"displayName": {
"text": "Hyderabad Dum Biryani",
"languageCode": "en"
}
},
. . .
],
"contextualContents": [
{
"reviews": [
{
"name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/reviews/ChdDSUhNMG9nS0VJQ0FnSURSeEtMdHZ3RRAB",
"relativePublishTimeDescription": "a year ago",
"rating": 5,
"text": {
"text": "Very tasty! Rich spices and textures. We really appreciated
all of the vegan options. We shared samosas (great sauce!) , tofu 65
(spicy!!), gobi manchurian (less flavorful but a nice sweet offset to
the tofu 65) and veg pakoras (very crunchy and awesome flavor). We
enjoyed all of it, with the pakoras being the table's favorite.",
"languageCode": "en"
},
"originalText": {
"text": "Very tasty! Rich spices and textures. We really appreciated
all of the vegan options. We shared samosas (great sauce!) , tofu 65
(spicy!!), gobi manchurian (less flavorful but a nice sweet offset
to the tofu 65) and veg pakoras (very crunchy and awesome flavor).
We enjoyed all of it, with the pakoras being the table's favorite.",
"languageCode": "en"
},
"authorAttribution": {
"displayName": "Guillaume Riesen",
"uri": "https://www.google.com/maps/contrib/1131462893/reviews",
"photoUri": "https://lh3.googleusercontent.com/a-/ALVVXe4iwG_WXt1SjB1rJg=s128-c-c0x00000000-cc-rp-mo-br100"
},
"publishTime": "2023-04-18T02:48:02Z"
},
{
"name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/reviews/ChdDSUhNMG9nS0VJQ0FnSUNKZzlhTG53RRAB",
"relativePublishTimeDescription": "10 months ago",
"rating": 5,
"text": {
"text": "This is a nice little spot to eat at. I'm a big fan of
curries, and they are spot on when it comes to flavor and spice. I highly recommend this place.",
"languageCode": "en"
},
"originalText": {
"text": "This is a nice little spot to eat at. I'm a big fan of curries,
and they are spot on when it comes to flavor and spice. I highly recommend this place.",
"languageCode": "en"
},
"authorAttribution": {
"displayName": "Paul Sacks",
"uri": "https://www.google.com/maps/contrib/1106671734435/reviews",
"photoUri": "https://lh3.googleusercontent.com/a/ACg8ocIAGguhz-EccsS9sVQ=s128-c-c0x00000000-cc-rp-mo-ba4-br100"
},
"publishTime": "2023-07-03T16:51:49Z"
},
. . .
],
"photos": [
{
"name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/photos/Vt2DAKajwJfgC_I-baPKjSeSw-JAXY-tCZOBAe7pBxxIS0Vo1w23sCO9o5RzoxJ",
"widthPx": 1920,
"heightPx": 1080,
"authorAttributions": [
{
"displayName": "A Google User",
"uri": "//maps.google.com/maps/contrib/113209927655010465422",
"photoUri": "//lh3.googleusercontent.com/a-/ALV-UjV_8hbrtgycOLDgOqPRYhzJ0EJlBFyKo9OrmacOo3C5YvrtR4Q=s100-p-k-no-mo"
}
]
},
{
"name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/photos/AUGGfZkJ4MMlLikE2EyP-b13GeFZ9YNzyjkjDMD15gyobIQtIYg1GFPy3BdQHAaA3iNwhk24vK212hZo",
"widthPx": 960,
"heightPx": 720,
"authorAttributions": [
{
"displayName": "Toast"
}
]
},
. . .
],
"justifications": [
{
"reviewJustification": {
"highlightedText": {
"text": "\"Not too spicy or oily.\"",
"highlightedTextRanges": [
{
"startIndex": 9,
"endIndex": 14
}
]
},
"review": {
"name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/reviews/ChZDSUhNMG9nS0VJQ0FnSUR4djR2Z1B3EAE",
"relativePublishTimeDescription": "10 months ago",
"rating": 5,
"text": {
"text": "Not too spicy or oily. We have the mutton dum biryanis
and tandoori fish. Very flavorful. The food was served promptly.
Clean environment. A little small more like a hole in the wall.
We'd come back for sure.",
"languageCode": "en"
},
"originalText": {
"text": "Not too spicy or oily. We have the mutton dum biryanis
and tandoori fish. Very flavorful. The food was served promptly.
Clean environment. A little small more like a hole in the wall.
We'd come back for sure.",
"languageCode": "en"
},
"authorAttribution": {
"displayName": "Harpal Kochar",
"uri": "https://www.google.com/maps/contrib/1166232959/reviews",
"photoUri": "https://lh3.googleusercoEnzB1zdrNbR00000-cc-rp-mo"
},
"publishTime": "2023-06-18T06:12:41Z"
}
}
},
{
"businessAvailabilityAttributesJustification": {
"dineIn": true
}
}
]
},
. . .
]
}
הנחיות להטמעת תרחישים לדוגמה בתחום כלי הרכב
כדי לשמור על בטיחות הנהגים, Google ממליצה לעבד סיכומים של בינה מלאכותית גנרטיבית במצב חניה לעובדים. כשמציגים את הסיכומים במצב נהיגה, המידע במסך צריך להיות פשוט, ברור ותמציתי כדי להבטיח שתשומת הלב של הנהג/ת חוזרת במהירות לכביש.
- עד 3 שורות
- באורך של 120 תווים או 24 מילים לכל היותר
- גודל קדמי מינימלי של 24dp
במיוחד בהקשרים של כלי רכב, באחריותו של המפתח לעבד את הסיכומים של ה-AI הגנרטיבי בצורה בטוחה ותואמת לכל החוקים והתקנות המקומיים.
שיוכים
כשאתם מציגים באפליקציה תקצירים של ביקורות, תמונות וסיכומים מ-AI גנרטיבי, כולל סיכומי מקומות וסיכומים של אזורים, עליכם לוודא גם את השיוך הנדרש.
הצגת סרטונים קשורים לסיכומים גנרטיביים
כשמציגים באפליקציה סיכומים מ-AI גנרטיבי, כולל סיכומי מקומות ואזורים, צריך להציג גם את השיוך (Attribution) הנדרש. בקטע הזה נסביר איך להציג את השיוך על סמך האופן שבו מציגים את סיכומי ה-AI הגנרטיבי באפליקציה.
בכל המקרים, יש להשתמש באות גדולה בתחילת המשפט (באנגלית). השיוך והלוגו של Google צריכים לעמוד בכל הסטנדרטים של הצבע, הסגנון והגופן. למידע נוסף על הסטנדרטים האלה, ראו מדיניות עבור Places API (חדש).
סיכום של ה-AI הגנרטיבי שמוצג בהקשר של נתונים אחרים בחשבון Google
במקרה כזה, אפשר להציג את השיוך של ה-AI הגנרטיבי בנפרד מעל או מתחת לסיכום, תוך הסתמכות על השיוך של התוכן ל-Google במקום אחר.
לשיוך, משתמשים בטקסט 'סוכם על ידי AI' כפי שמוצג בתמונה הזו:
סיכום של ה-AI הגנרטיבי מוצג בנפרד
כשסיכום שמבוסס על AI גנרטיבי מופיע בנפרד מתוכן אחר ממפות Google, הוא צריך לכלול שיוך (Attribution) של AI גנרטיבי וגם שיוך ל-Google ולהפריד בין התוכן לבין גורם ביניים. לשיוך, משתמשים בטקסט 'סוכם על ידי AI' ובלוגו של Google כפי שמוצג בתמונה הזו:
סיכום של ה-AI הגנרטיבי שחוזר על עצמו ברשימה
כשחוזרים על הסקירה הכללית של סיכום המקומות על ידי AI גנרטיבי ברשימה של מקומות, שבהם כולם:
- תוכן הרשימה מיוחס ל-Google
- הסיכומים המוצגים נוצרו על ידי AI
- התוכן זמין מ-Google
הייחוס צריך להיות מוצג מעל הרשימה או מתחתיה בשורה אחת. השיוך (Attribution) של ה-AI מיושר לשמאל, והשיוך של Google מיושר לימין:
אם נעשה שימוש ברשימה ארוכה יותר של סיכומי תיאורים של AI גנרטיבי, לכל סיכום צריך להיות שיוך AI ("סוכם על ידי AI" עם סמל/לחצן המידע).
הצגת מידע על סיכום של AI גנרטיבי בתיבת דו-שיח
בנוסף לסיכום שמבוסס על AI גנרטיבי, צריך להציג למשתמשי הקצה תיבת דו-שיח עם מידע על הסיכום וקישור לדיווח על בעיות. כשמשתמשים בסיכום תיאור של בינה מלאכותית גנרטיבית, צריך לכלול מידע על מקורות הסיכום, שנקרא references.
כדי לאפשר גישה לתיבת הדו-שיח הזו, צריך לכלול סמל מידע (כמחירון אינטראקטיביות) בשילוב עם שיוך (Attribution) AI (כמו שמתואר בדוגמאות שלמעלה) ולהגדיר את האזור והסמל של ה-AI להגיב ללחיצה או לקליק.
כדי לקבל סיכומים גנרטיביים של מקומות, אפשר להציג את:
| מידע כללי | סיכומי מקומות שנוצרו על ידי AI נוצרים על סמך ביקורות ב-Google ונתונים אחרים. |
| דיווח על בעיה | כדי לדווח ל-Google על בעיה בתוכן של סיכום, יש ללחוץ על הקישור הזה. |
| קובצי עזר | ביקורות על המקור |
למשל:
לסיכומים של אזורים גנרטיביים, צריך להציג את:
| מידע כללי | סיכומי אזורי AI נוצרים על סמך ביקורות ב-Google ונתונים מקומיים. |
| דיווח על בעיה | כדי לדווח ל-Google על בעיה בתוכן של סיכום, יש ללחוץ על הקישור הזה. |
