סיכומי ביקורות מבוססי-AI

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

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

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

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

שליחת בקשה לקבלת סיכום של הבדיקה

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

  • פרטי המקום (חדש): reviewSummary
  • חיפוש טקסט (חדש) וחיפוש בסביבה (חדש): places.reviewSummary

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

גוף התשובה כולל שלושה שדות:

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

בקשה ל'פרטי מקום' (חדשה)

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

curl -X GET https://places.googleapis.com/v1/places/ChIJD2l2k7ZL0YkRC80d-3MV1lM \
-H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: displayName,reviewSummary,googleMapsLinks.reviewsUri"

התגובה תהיה בפורמט:

{
  "displayName": {
    "text": "Dumpling House",
    "languageCode": "en"
  },
  "googleMapsLinks": {
    "reviewsUri": "https://www.google.com/maps/place//data=!4m4!3m3!1s0x89d14bb69376690f:0x53d61573fb1dcd0b!9m1!1b1",
  },
  "reviewSummary": {
    "text": {
      "text": "Diners say this lunch restaurant serves up delicious dumplings, including pork and chive, soup dumplings, and fried dumplings, alongside other Chinese dishes like fried rice, pork belly buns, and general tso's chicken. They also highlight the generous portions, reasonable prices, and efficient service.",
      "languageCode": "en-US"
    },
    "flagContentUri": "https://www.google.com/local/review/rap/report?postId=5%401:CAIQACodChtyc19oOkE4blltMzB1eXpWblVKUjFBQXFGbWc%7CCAIQACorChtyc19oOkE4blltMzB1eXpWblVKUjFBQXFGbWcSDAis0fW-BhCIp7blAg&d=17924085&t=8",
    "disclosureText": {
      "text": "Summarized with Gemini",
      "languageCode": "en-US"
    }
  }
}

בקשה חדשה: חיפוש טקסט

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

curl -X POST -d '{
  "textQuery": "coffee shop",
  "locationBias": {
    "circle": {
      "center": {
        "latitude": 40.722630,
        "longitude": -74.001397
      }
    }
  },
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.id,places.reviewSummary,places.googleMapsLinks.reviewsUri" \
'https://places.googleapis.com/v1/places:searchText'

גוף התשובה בפורמט:

{
  "places": [
    {
      "id": "ChIJyfJXNphZwokRbo-oe0DjVT4",
      "googleMapsLinks": {
        "reviewsUri": "https://www.google.com/maps/place//data=!4m4!3m3!1s0x89c259983657f2c9:0x3e55e3407ba88f6e!9m1!1b1",
      },
      "reviewSummary": {
        "text": {
          "text": "People say this coffee shop serves delicious oat milk lattes, iced lattes, and cappuccinos, and they praise the friendly staff and cozy atmosphere. They also highlight the great outdoor seating area and the unique latte flavors.",
          "languageCode": "en-US"
        },
        "flagContentUri": "https://www.google.com/local/review/rap/report?postId=5%401:CAIQACodChtyc19oOkFONEpuYU1UMzZWbTduX1lBQVRBRkE%7CCAIQACorChtyc19oOkFONEpuYU1UMzZWbTduX1lBQVRBRkESDAj9iuK_BhD4ouCwAw&d=17924085&t=8",
        "disclaimerText": {
          "text": "Summarized with Gemini",
          "languageCode": "en-US"
        }
      }
    },
    {
      "id": "ChIJl5qG27RZwokRzoy63vyI4Gk",
      "googleMapsLinks": {
        "reviewsUri": "https://www.google.com/maps/place//data=!4m4!3m3!1s0x89c259b4db869a97:0x69e088fcdeba8cce!9m1!1b1",
      },
      "reviewSummary": {
        "text": {
          "text": "People say this coffee shop serves delicious matcha, including the Blueberry Matcha Latte and Cherry Cold Brew Latte, and offers a variety of pastries. They also highlight the friendly and efficient staff, and the cute and aesthetic space.",
          "languageCode": "en-US"
        },
        "flagContentUri": "https://www.google.com/local/review/rap/report?postId=5%401:CAIQACodChtyc19oOkE4bmRodTgya2MxbkJNMXhBQU1MNXc%7CCAIQACorChtyc19oOkE4bmRodTgya2MxbkJNMXhBQU1MNXcSDAj9iuK_BhD4ouCwAw&d=17924085&t=8",
        "disclaimerText": {
          "text": "Summarized with Gemini",
          "languageCode": "en-US"
        }
      }
    },
    /.../
  ]
}

בקשה בנושא חיפוש בקרבת מקום (חדש)

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

curl -X POST -d '{
  "maxResultCount": 5,
  "locationRestriction": {
    "circle": {
      "center": {
        "latitude": 47.609937,
        "longitude": -122.340714
      },
      "radius": 1000
    }
  },
  "includedTypes": ["hotel"],
  "excludedTypes": [],
  "rankPreference":"POPULARITY"
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.id,places.reviewSummary,places.googleMapsLinks.reviewsUri" \
'https://places.googleapis.com/v1/places:searchNearby'

התגובה תהיה בפורמט:

{
  "places": [
    {
      "id": "ChIJRwVmS-BrkFQRpAB3pO5JOuQ",
      "googleMapsLinks": {
        "reviewsUri": "https://www.google.com/maps/place//data=!4m4!3m3!1s0x54906be04b660547:0xe43a49eea47700a4!9m1!1b1",
      },
      "reviewSummary": {
        "text": {
          "text": "Guests say this hotel has comfortable beds, spacious rooms, and a central location within walking distance of Pike Place Market, the waterfront, and the convention center. They also highlight the friendly and helpful staff, the modern and clean facilities, and the efficient elevators.",
          "languageCode": "en-US"
        },
        "flagContentUri": "https://www.google.com/local/review/rap/report?postId=5%401:CAIQACodChtyc19oOkJtODg0RUFFSndKbnhkTXZBQVpuV2c%7CCAIQACorChtyc19oOkJtODg0RUFFSndKbnhkTXZBQVpuV2cSDAj9iuK_BhD4ouCwAw&d=17924085&t=8",
        "disclaimerText": {
          "text": "Summarized with Gemini",
          "languageCode": "en-US"
        }
      }
    },
    {
      "id": "ChIJQVJVX7RqkFQRcpsm3VVub9U",
      "googleMapsLinks": {
        "reviewsUri": "https://www.google.com/maps/place//data=!4m4!3m3!1s0x54906ab45f555241:0xd56f6e55dd269b72!9m1!1b1",
      },
      "reviewSummary": {
        "text": {
          "text": "Guests say this hotel offers comfortable beds, spacious rooms with great views, and a well-equipped gym and pool. They also highlight the friendly and helpful staff, convenient location for walking to attractions and restaurants, and the well-stocked club lounge.\n\nSome reviews mention the elevators can be slow.",
          "languageCode": "en-US"
        },
        "flagContentUri": "https://www.google.com/local/review/rap/report?postId=5%401:CAIQACodChtyc19oOkE4blJFWWtBUFo5bjNYWndBQVYxZWc%7CCAIQACorChtyc19oOkE4blJFWWtBUFo5bjNYWndBQVYxZWcSDAj9iuK_BhD4ouCwAw&d=17924085&t=8",
        "disclaimerText": {
          "text": "Summarized with Gemini",
          "languageCode": "en-US"
        }
      }
    },
    /.../
  ]
}

שיוכים

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