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

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

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

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

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

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

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

אוסטרליה

קנדה

הודו

ניו זילנד

סינגפור

ארצות הברית

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

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

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

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

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

בקשה ל-Place Details (New)‎

הבקשה הבאה של Place Details (חדש) מחזירה סיכום של 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.