סיכומים של מקומות מבוססי-AI

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

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

  • "מסעדה ב-Forum Shops שמגישה מנות גדולות של אוכל איטלקי מסורתי בסביבה לא רשמית"
  • "סלון אופנתי שמציע תספורות וצביעה, וגם טיפולי 'שטיפה וייבוש'."
  • "חנות גדולה עם הרבה מוכרים שמציעים מגוון של פריטי וינטג', רהיטים ובגדים"

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

שליחת בקשה ליצירת סיכום של מקום

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

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

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

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

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

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

curl -X GET https://places.googleapis.com/v1/places/ChIJ1eOF7HLTD4gRry3xPjk8DkU \
-H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: displayName,generativeSummary"

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

{
  "displayName": {
    "text": "Sushi Nova - Lincoln Park",
    "languageCode": "en"
  },
  "generativeSummary": {
    "overview": {
      "text": "Casual eatery with all-you-can-eat sushi and other Japanese fare, plus beer and sake.",
      "languageCode": "en-US"
    },
    "overviewFlagContentUri": "https://www.google.com/local/review/rap/report?postId=CiUweDg4MGZkMzcyZWM4NWUzZDU6MHg0NTBlM2MzOTNlZjEyZGFmMAI&d=17924085&t=12",
    "disclaimerText": {
      "text": "Summarized with Gemini",
      "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" \
'https://places.googleapis.com/v1/places:searchText'

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

{
  "places": [
    {
      "id": "ChIJ8wN5kzm3j4AR_dRdUHoqrPI",
      "displayName": {
        "text": "Plant-Based Vegan Vietnamese",
        "languageCode": "en"
      }
    },
    {
      "id": "ChIJw4RuczO3j4ARC7RByZ5K9nI",
      "displayName": {
        "text": "sweetgreen",
        "languageCode": "en"
      },
      "generativeSummary": {
        "overview": {
          "text": "Casual eatery offering healthy, made-to-order salads, plates, and grain bowls with vegan options.",
          "languageCode": "en-US"
        },
        "overviewFlagContentUri": "https://www.google.com/local/review/rap/report?postId=CiUweDgwOGZiNzMzNzM2ZTg0YzM6MHg3MmY2NGE5ZWM5NDFiNDBiMAI&d=17924085&t=12",
        "disclosureText": {
          "text": "Summarized with Gemini",
          "languageCode": "en-US"
        }
      }
    },
    /.../
  ]
}

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

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

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

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

{
  "places": [
    {
      "id": "ChIJOa08KlqnlVQR_ZZx1jEcTYY",
      "generativeSummary": {
        "overview": {
          "text": "BBQ and Thai street fare, plus imaginative tropical cocktails, served in a vibrant space.",
          "languageCode": "en-US"
        },
        "disclosureText": {
          "text": "Summarized with Gemini",
          "languageCode": "en-US"
        }
      }
    },
    {
      "id": "ChIJU4OzoWynlVQRxlQMpGenSvA",
      "generativeSummary": {
        "overview": {
          "text": "Beer hall with a big selection of German brews, plus a central courtyard with food trucks.",
          "languageCode": "en-US"
        },
        "disclosureText": {
          "text": "Summarized with Gemini",
          "languageCode": "en-US"
        }
      }
    },
    /.../
  ]
}

שיוכים

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