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

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

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

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

סיכומי מקומות נתמכים על ידי Place Details (חדש),‏ Text Search (חדש) ו-Nearby Search (חדש). סיכומי מקומות זמינים לסוגי מקומות שמוצגים בסוגים נתמכים בקטגוריות תרבות, בידור ופנאי, אוכל ושתייה, קניות, שירותים וספורט.

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

שפה אזור
אנגלית

הודו

ארצות הברית

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

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

  • Place Details (New): generativeSummary
  • ‫Text Search (New) ו-Nearby Search (New): 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.