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

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

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

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

  • "במרחק 2-4 דקות הליכה, יש כמה מסעדות וחנויות כולל שף צ'ו, שף צ'ו, חנוית ברביקיו קוריאני, אמבר הודו, פסיפיק למצוא כמה חנויות מכולת כמו Walmart , Whole Foods Market וגם העסק של יוסי."

  • "במרחק של דקה עד 5 דקות הליכה, יש כמה מסעדות וחנויות שונות, כולל קאו קאנג תאי Kitchen, Roger's Deli דונאטס ולה Costeña. כשמדובר בסושי, ג'וי סושי היא אפשרות טובה. לחנויות מכולת, דולר ארה"ב מציע מגוון מוצרים במחירי הנחה."

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

"מסעדה צמחונית פיקנטית במאונטיין ויו, קליפורניה"

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

"מסעדה טבעונית פיקטיבית במאונטיין ויו, קליפורניה"

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

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

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

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

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

מה זה Gemini?

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

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

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

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

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

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

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

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

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

  • פרטי מקום: 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"
        },
        . . .
}

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

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

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

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

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

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

areaSummary למקום בתשובה מכיל מערך של עד contentBlocks הנושא של כל קטע מבוסס על סוג המקום:

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

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

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

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

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

שיוכים

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

לדוגמה:

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

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

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

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