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

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

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

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

  • "במרחק 2-4 דקות הליכה יש כמה אפשרויות לאכול ולקנות, כולל Chef Chu's,‏ Gen Korean BBQ House,‏ Amber India,‏ Pacific Catch וכמה חנויות מכולת כמו Walmart,‏ Whole Foods Market ו-Trader Joe's".

  • "במרחק הליכה של דקה עד 5 דקות יש כמה אפשרויות למסעדות ולשופינג, כולל Khao Kang Thai Kitchen,‏ Roger's Deli & Donuts ו-La Costeña. לסושי, Joy Sushi היא אפשרות טובה. ב-Dollar Tree יש מגוון מוצרים במחירים מוזלים."

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

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

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

סיכומים גנרטיביים של מקומות

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

ב-Places API (חדש) יש שני סוגים של סיכומי מקומות גנרטיביים:

  • סיכומי סקירה כללית: סקירה כללית קצרה של מקום, באורך של כ-100 תווים בממוצע, שיכולה לעזור למשתמשים לקבל תמונה מפורטת של המקום.

  • סיכומי תיאורים: סיכומים ארוכים יותר של מקום, באורך ממוצע של כ-400 תווים, שמספקים סקירה כללית מפורטת של ההיבטים העיקריים של המקום.

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

סיכומים גנרטיביים של אזורים

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

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

סיכומי האזורים זמינים כרגע לסוגים של מקומות שמופיעים בסוגי המקומות הנתמכים בקטגוריה אירוח, וגם לסוגים הספציפיים של המקומות electric_vehicle_charging_station,‏ geocode ו-premise.

יצירת סיכומים של מקומות ואזורים

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

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

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

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

כשאתם מוסיפים לתשובה תוצאות חיפוש לפי הקשר, התשובה כוללת עכשיו ביקורות, תמונות ותירוצים שיעזרו למשתמשים לענות על השאלות:

  • למה המקום הזה מופיע בתוצאות?
  • למה כדאי לבחור במקום הזה?

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

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

"מסעדה צמחונית עם מנות חריפות ב-Mountain View, קליפורניה"

לאחר מכן משאירים את כל פרמטרים הקלט ללא שינוי ומשנים רק את מחרוזת השאילתה ל:

"מסעדה טבעונית עם מנות חריפות ב-Mountain View, קליפורניה"

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

הפעלת יכולות של מודל Gemini ב-Places API (חדש)

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

הגבלות לגרסה הניסיונית

הגרסה הזו תומכת רק בסיכומי מקומות ואזורים של מקומות בארה"ב, באנגלית בלבד.

מה זה Gemini?

מידע נוסף על מודל Gemini זמין בשאלות הנפוצות על Gemini.

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

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

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

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

    • הם נוצרים מ-LLM, כך שאין צורך לבעלי המקום לנהל אותם.

  • הסיכומים הגנרטיביים של תיאור מבוססים על מקורות רבים, כולל ביקורות ממפות Google. התיאור, באורך ממוצע של כ-400 תווים, כולל רשימת ביקורות ששימשו ליצירת התיאור הארוך.

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

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

  • פרטי המקום: generativeSummary

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

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

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

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

בדוגמה הזו נעשה שימוש במסכת שדה של places.generativeSummary כדי להחזיר את כל האובייקט generativeSummary, כולל השדות generativeSummary.overview,‏ generativeSummary.description ו-generativeSummary.references:

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": "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": "John Smith",
                "uri": "https://www.google.com/maps/contrib/11685942231/reviews",
                "photoUri": "https://lh3.googleusercontent.com/a-/ALV-UjWbImVTop_1d-cc-rp-mo"
              },
              "publishTime": "2023-05-09T07:24:36Z"
              "flagContentUri": "https://www.google.com/local/review/rap/report?postId=ChRAB&d=17924085&t=1",
              "googleMapsUri": "https://www.google.com/maps/reviews/data=!4m7558ccfc943:0x3bf9459a83940670"
            },
            . . .
          ]
        },
        "overviewFlagContentUri": "https://www.google.com/local/review/rap/report?postId=CiUweDgwOGZiNzU1O085&t=12",
        "descriptionFlagContentUri": "https://www.google.com/local/review/rap/report?postId=CiUweDgwOG&t=12"
      }
    },
    {
      "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"
        },
        . . .
}

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

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

בקשה לקבלת סיכום של אזור גנרטיבי

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

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

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

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

  • areaSummary (פרטי המקום)
  • places.areaSummary (חיפוש טקסט וחיפוש בקרבת מקום).

השדה areaSummary של מקום בתגובה מכיל את השדה flagContentUri, שבעזרתו אפשר לסמן תוכן בלתי הולם כדי ש-Google תוכל להסיר אותו. הוא מכיל גם מערך של עד ארבעה contentBlocks. הנושא של כל בלוק מבוסס על סוג המקום:

  • בתחנת טעינה לרכב חשמלי, שמוגדרת כמקום מסוג electric_vehicle_charging_station, בלוקים של נושאים כוללים את הערכים: "overview",‏ "coffee",‏ "restaurant" ו-"store".

  • למקום עם סוג שמוגדר לפי הקטגוריה אירוח וסוגי המקומות הספציפיים geocode ו-premise, בלוקים של נושאים כוללים את הערכים הבאים: "overview",‏ "activity",‏ "restaurant" ו-"store".

דוגמה לבקשה לסיכום של תחנת טעינה לרכב חשמלי (EV) באזור

בקשת הדוגמה הזו לפרטים של מקום מחזירה את סיכום האזור של תחנת טעינה ספציפית לרכב חשמלי במאונטן וויו, שמזוהה לפי מזהה המקום 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 מציין את סוג בלוק התוכן. מכיוון שהמקום בדוגמה הזו הוא תחנת טעינה לרכב חשמלי, ארבעת קטעי התוכן הם "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"
          ]
        }
      }
    ],
    "flagContentUri": "https://www.google.com/local/review/rap/report?postId=IhkpuV1UwBQ&d=17924085&t=12"
  }
}

דוגמה לבקשה לסיכום של אזור מסוים עבור מלון

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

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"
              ]
            }
          }
        ],
        "flagContentUri": "https://www.google.com/local/review/rap/report?postId=GQAAAA085&t=12"
      }
    },
    ...
  ]
}

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

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

כדי לתמוך בסיכומים לפי הקשר, התשובה מ-Text Search (New) מכילה מערך חדש בשם contextualContents באותה רמה כמו מערך places בתגובה:

{
  "places": [],
  "contextualContents":[]
}

כל אלמנט במערך contextualContents, מסוג ContextualContent, נמצא במיקום המערך התואם למקום במערך places. כלומר, הרכיב ב-contextualContents[0] תואם למקום ב-places[0].

כל רכיב במערך מכיל את שדות המערך הבאים:

  • contextualContents.reviews: מערך של עד שלוש ביקורות.
  • contextualContents.photos: מערך של עד חמש תמונות.

  • contextualContents.justifications: מערך של הצדקות למיקום, כולל:

    • reviewJustification: הדגשת קטע בביקורת של משתמש שעשוי לעניין משתמש קצה.
    • businessAvailabilityAttributesJustification: כולל מאפיינים של עסק שעשויים לעניין משתמש קצה.

כדי לכלול בתשובה את תוצאות החיפוש לפי הקשר, צריך לכלול את הערך contextualContents במסכת השדה של הבקשה Text Search (New):

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": "Jane Doe",
            "uri": "https://www.google.com/maps/contrib/113193/reviews",
            "photoUri": "https://lh3.googleusercontent.com/a-/ALVVXe4iwrp-mo-br100"
          },
          "publishTime": "2023-04-18T02:48:02Z",
          "flagContentUri": "https://www.google.com/local/review/rap/report?postIWkF24085&t=1",
          "googleMapsUri": "https://www.google.com/maps/reviews/data=!4m6!1sChZDSUhb1e9679abc80b8db"
        },
        {
          "name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/reviews/ChdDSUhzlhTG53RRAB",
          "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": "Bob Jones",
            "uri": "https://www.google.com/maps/contrib/11034435/reviews",
            "photoUri": "https://lh3.googleusercontent.com/a/ACg8ocIAGguhz-EccsS9p-mo-ba4-br100"
          },
          "publishTime": "2023-07-03T16:51:49Z",
          "flagContentUri": "https://www.google.com/local/review/rap/report?postIWkF3EAE&d=17924085&t=1",
          "googleMapsUri": "https://www.google.com/maps/reviews/data=!4m6!14m5!1m4!2m3!1sChZDSUhb1e9679abc80b8db"
        },
        . . .
      ],
      "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/113010465422",
              "photoUri": "//lh3.googleusercontent.com/a-/ALV-UjV_8hbrtgyc0-p-k-no-mo"
            }
          ],
          "flagContentUri": "https://www.google.com/local/review/rap/report?postId=ChZDSWkF3EAE&d=15&t=1",
          "googleMapsUri": "https://www.google.com/maps/reviews/data=!4m6!14m5!1m4!2m3!1sChZDSUhNbc80b8db"
        },
        {
          "name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/photos/AUGGfZkJ4MMlLikE2EyP-b13GeFZ9Nwhk24vK212hZo",
          "widthPx": 960,
          "heightPx": 720,
          "authorAttributions": [
            {
              "displayName": "Toast"
            }
          ],
          "flagContentUri": "https://www.google.com/local/review/rap/report?postId4085&t=1",
          "googleMapsUri": "https://www.google.com/maps/reviews/data=!4m6!14m5!1m4!2m3!b1e9679abc80b8db"
        },
        . . .
      ],
      "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": "Stan Davis",
                "uri": "https://www.google.com/maps/contrib/112959/reviews",
                "photoUri": "https://lh3.googleuser-cc-rp-mo"
              },
              "publishTime": "2023-06-18T06:12:41Z",
              "flagContentUri": "https://www.google.com/local/review/rap/report?postt=1",
              "googleMapsUri": "https://www.google.com/maps/reviews/75a95dd8ebd:0xb1e9679abc80b8db"
            }
          }
        },
        {
          "businessAvailabilityAttributesJustification": {
            "dineIn": true
          }
        }
      ]
    },
    . . .
  ]
}

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

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

  • לא יותר מ-3 שורות
  • 120 תווים או 24 מילים או פחות
  • גודל מינימלי בחזית של 24dp

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

שיוכים

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ברשימת פריטים, צריך להציג את השיוך מעל או מתחת לרשימה בשורה אחת.

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

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

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

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

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

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

לדוגמה:

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

בסיכומי אזורים גנרטיביים, מוצגים:

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

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