דף זה תורגם על ידי Cloud Translation API.

יכולות של מודלים של Gemini ל-Places API

היכולות של המודל של Gemini ל-Places API (חדש) תומכות במודלים גדולים של שפה (LLM) ל-Places API, כדי שתוכלו להחזיר את הנתונים שמשויכים למקום (שעות פתיחה, ביקורות, תמונות) יחד עם נתונים של מודלים גדולים של שפה. הנתונים הגנרטיביים האלה מכילים נתונים נצברים ומוסכמים מהמודלים מסוג LLM כדי לשפר את הנתונים שכבר משויכים למקום.

לדוגמה, חיפוש טקסט (חדש) רגיל של 'תחנות טעינה לרכב חשמלי' מחזיר רשימה של מקומות שמציעים טעינה לרכבים חשמליים. סוג התגובה הזה מתאים אם אתם מחפשים רק את המטען לרכב חשמלי הקרוב ביותר או את המטען הקרוב ביותר שתואם לרכב שלכם.

אבל כדאי גם להבין טוב יותר את האזור שמסביב לתחנת הטעינה, במיוחד אם אתם עומדים להיות שם שעה או יותר בזמן שהרכב נטען. כשמשתמשים ביכולות של המודל של Gemini באותו חיפוש, התשובה יכולה להכיל תיאורים דינמיים גנרטיביים של כל מקום בתשובה, כולל מידע על האזור שמסביב לתחנת הטעינה:

"במרחק 2-4 דקות הליכה, יש כמה אפשרויות של מסעדות וקניות, כולל השף צ'ו, חנוית הברביקיו הקוריאנית, אמבר הודו, פסיפיק קטץ', ומספר חנויות מכולת כמו Walmart , Whole Foods Market ו-Trader Joe's."
"במרחק של דקה עד 5 דקות הליכה, יש כמה אפשרויות של מסעדות וקניות, כולל מטבח קאו קאנג תאי, מעדנת רוג'רס ודונאטס, ו-La Costeña. כשמדובר בסושי, ג'וי סושי היא אפשרות טובה. עבור מוצרי מכולת, דולר טרי מציע מגוון מוצרים במחירים מוזלים."

התוכן הגנרטיבי הזה מה-LLM משפר את התשובה ומספק מידע נוסף שעוזר למשתמשים לקבל החלטה מושכלת.

נוספו תכונות חדשות מבוססות-AI ל-Places API (חדש)

היכולות האלה מוסיפות את הנתונים הבאים לתשובה של Places API (חדש):

תקצירי מקומות שקשורים למקום ספציפי. אפשר להשתמש בסיכומי מקומות באמצעות האפשרויות פרטי מקום (חדש), חיפוש טקסט (חדש) וחיפוש בקרבת מקום (חדש).
תקצירים של אזורים גנרטיביים שקשורים לאזור ספציפי מסביב למקום. אפשר להשתמש בסיכומי אזורים באמצעות התכונות פרטי מקום (חדש), חיפוש טקסט (חדש) וחיפוש בקרבת מקום (חדש).
תוצאות חיפוש לפי הקשר נתמכות על ידי Text Search (New), ומכילות נתונים על סמך מחרוזת החיפוש שהועברה בבקשה, במקום נתונים שמשויכים ישירות למקום. הנתונים האלה עוזרים להבין איך התכונה 'חיפוש טקסט (חדש)' קובעת את התגובה.

תקצירי מקומות ב-AI גנרטיבי

תקצירים גנרטיביים של מקומות הם ספציפיים למזהה מקום. מקבצים סיכומים כדי לצבור סוגים שונים של נתונים בסיכום אחד על המקום.

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.

בקשת סיכום של מקומות שנוצרו על ידי AI

סיכומי מקומות הם סיכומים גנרטיביים שנוצרו על ידי ה-LLM לגבי מקום ספציפי. Places API (חדש) מוסיף שני סוגי סיכומים לתשובה:

תקצירים גנרטיביים של Overview שדומים לתקציר העריכה הסטטי שמשויך למקום. לסיכומים קצרים גנרטיביים של כ-100 תווים בממוצע יש כמה יתרונות:
- למקומות רבים אין תקצירים, כך שהם ממלאים את החסר במידע שזמין לאותו מקום.
- הם נוצרים מה-LLM ולכן בעל המקום לא צריך לתחזק אותם.
Description סיכומים גנרטיביים נגזרים ממקורות רבים, כולל ביקורות ממפות Google. התיאור, באורך ממוצע של כ-400 תווים, כולל רשימה של ביקורות ששימשו ליצירת התיאור הארוך.

כדי ליצור סיכומי תיאורים ידנית, אדם אחד צריך לצבור נתונים ממיקומים רבים ואז ליצור ולתחזק את התוכן באופן ידני. היכולות של המודל של Gemini ל-Places API (חדש) מבוססות על ה-LLM כדי לשמור על ההיקף והעדכניות של התוכן שנוצר.

אפשר להשתמש בסיכומי מקומות באמצעות האפשרויות פרטי מקום (חדש), חיפוש טקסט (חדש) וחיפוש בקרבת מקום (חדש). כדי לכלול את סיכום המקום בתשובה, צריך לכלול את השדה הבא ב-field mask של הבקשה:

פרטי מקום: generativeSummary
חיפוש טקסט וחיפוש בקרבת מקום: places.generativeSummary

השדה generativeSummary מכיל את השדות הבאים:

generativeSummary.overview: סיכום הסקירה הכללית הגנרטיבית.
generativeSummary.description: סיכום התיאורים הגנרטיביים.
generativeSummary.references: מערך של עד 5 ביקורות המשמשות להצגת תוכן לסיכום התיאור. אם אין סיכום של התיאורים, המערך הזה ריק.

דוגמה לבקשת סיכום של סקירה כללית

הדוגמה הבאה של חיפוש טקסט מחזירה רק את הסיכום 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"
        },
        . . .
}

בקשת סיכום של האזור שנוצר על ידי AI

סיכומי אזורים הם סיכומים גנרטיביים שנוצרו על ידי ה-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"
              ]
            }
          }
        ]
      }
    },
    ...
  ]
}

בקשה לקבלת תוצאות חיפוש לפי הקשר

התשובה לבקשת Text Search (New) (חיפוש טקסט) מכילה מערך של מקומות שתואמים לקריטריונים של מחרוזת החיפוש שהוזן. עכשיו תוכלו לבקש נתוני חיפוש לפי הקשר בתשובה בהתאם לשאילתת הקלט ל-API.

כדי לתמוך בסיכומים לפי הקשר, התשובה מText Search (New) מכילה מערך חדש בשם 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 ממליצה לעבד סיכומים של AI גנרטיבי במצב חנייה בחוויות בכלי רכב. במקרה שסיכומי רינדור במצב נהיגה, המידע במסך צריך להיות פשוט, ברור ותמציתי, כדי להבטיח שתשומת הלב של הנהג תחזור במהירות לכביש.

עד 3 שורות
120 תווים או 24 מילים או פחות
גודל קדמי מינימלי של 24dp

במיוחד בהקשרים של כלי רכב, באחריות המפתח לעבד סיכומים שנוצרו על ידי AI גנרטיבי באופן בטוח שתואם לכל החוקים והתקנות המקומיים.

שיוכים

כשאתם מציגים ביקורות, תמונות וסיכומים שנוצרו על ידי AI גנרטיבי באפליקציה, כולל תקצירים של מקומות ותחומים, חשוב לוודא שגם הפרטים האלה מוצגים.

הצגת ייחוסים עבור סיכומים גנרטיביים

כשמציגים באפליקציה סיכומים של AI גנרטיבי, כולל סיכומים של מקומות ואזורים, צריך להציג גם את הייחוסים הנדרשים. בקטע הזה מוסבר איך להציג את הייחוסים על סמך האופן שבו מציגים את הסיכומים של ה-AI הגנרטיבי באפליקציה.

בכל המקרים, השיוך חייב להיות שימוש באותיות רישיות וקטנות. פרטי הייחוס והלוגו של Google חייבים לעמוד בכל התקנים של צבעים, סגנון וגופנים. למידע נוסף על הסטנדרטים האלה, ראו מדיניות בנושא Places API (חדש).

סיכום של הבינה המלאכותית הגנרטיבית שמוצג בהקשר של נתונים אחרים בחשבון Google

במקרה הזה, אפשר להציג את הייחוס של ה-AI הגנרטיבי לבדו מעל או מתחת לסיכום, על סמך השיוך של Google לתוכן במקום אחר.

לצורך השיוך, צריך להשתמש בטקסט 'סיכום על ידי AI' שמוצג בתמונה:

לצורך השיוך, משתמשים בטקסט 'סוכמו על ידי AI'.

סיכום של הבינה המלאכותית הגנרטיבית מוצג בנפרד

כשסיכום שנוצר על ידי AI גנרטיבי מופיע במקום תוכן אחר ממפות Google, הוא צריך לכלול גם את השיוך של AI גנרטיבי וגם את השיוך ל-Google, ולהפריד ביניהן באמצעות נקודה. לצורך השיוך, צריך להשתמש בטקסט 'Summarized by AI' ובלוגו של Google כמו שמוצג בתמונה:

לסיכום שמוצג באופן מבודד, צריך לכלול שיוך (Attribution) של AI גנרטיבי
ואת השיוך של Google
מופרדים בתו פסקה.

סיכום של AI גנרטיבי מופיע ברשימה

בחזרה על סקירה כללית של סיכום המקום על ידי AI גנרטיבי, ברשימה של מקומות, כשכל:

תוכן הרשימה משויך ל-Google
הסיכומים שמוצגים נוצרו על ידי AI
התוכן זמין מ-Google

הייחוס צריך להיות מוצג מעל או מתחת לרשימה בשורה אחת. השיוך (Attribution) של ה-AI מיושר לשמאל, והשיוך של Google מיושר לימין:

עבור רשימה, הציגו ייחוס מעל או מתחת לרשימה בשורה אחת.

אם מוצגים ברשימה סיכומי תיאורים ארוכים יותר שמבוססים על AI גנרטיבי, לכל סיכום צריך להיות שיוך AI ('סיכום על ידי AI' עם סמל או לחצן מידע).

הצגת מידע על סיכום שנוצר על ידי AI גנרטיבי בתיבת דו-שיח

בנוסף לסיכום על ידי AI גנרטיבי, אתם צריכים להציג למשתמשי הקצה תיבת דו-שיח עם מידע על הסיכום, וכן קישור לדיווח על בעיות. כשמשתמשים בסיכום התיאור של AI גנרטיבי, צריך לכלול מידע על המקורות של הסיכום, שנקרא references.

כדי לתת גישה לתיבת הדו-שיח הזו, צריך לכלול סמל מידע (כעלות אינטראקטיבית) בשילוב עם שיוך (Attribution) AI (כמו שמתואר בדוגמאות שלמעלה) ולהגדיר את אזור השיוך (Attribution) והסמל של AI כתגובה ללחיצה/קליק.

כדי לקבל סיכומי מקומות גנרטיביים, מציגים את הפרטים הבאים:

מידע כללי	תקצירים של מקומות שנוצרו על ידי AI נוצרים מביקורות ב-Google ומנתונים אחרים.
דיווח על בעיה	כדי לדווח ל-Google על בעיה בנוגע לתוכן של סיכום, צריך ללחוץ על הקישור הזה.
קובצי עזר	ביקורות על המקור

למשל:

הצגת מידע על סיכום שנוצר על ידי AI גנרטיבי בתיבת דו-שיח.

כדי לקבל סיכומי אזורים גנרטיביים, צריך להציג את:

מידע כללי	סיכומים של אזורי AI נוצרים על סמך ביקורות ב-Google ונתונים מקומיים.
דיווח על בעיה	כדי לדווח ל-Google על בעיה בנוגע לתוכן של סיכום, צריך ללחוץ על הקישור הזה.

שיוך של סיכום אזור התצוגה.