סיכומי אזורים מבוססי-AI

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

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

  • "האזור התוסס הזה בסן פרנסיסקו, שמכיל את North Beach ואת Chinatown, ממוקם בצפון-מערב הרובע הפיננסי. באזור יש מונומנטים ספרותיים, אטרקציות תרבותיות ייחודיות ומגוון מסעדות. בין המקומות הידועים: חנות הספרים המפורסמת City Lights, מוזיאון הרכבל המרתק והרחובות התוססים של צ'יינה טאון.

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

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

  • "באזור יש מגוון אפשרויות קולינריות במרחק 9 דקות הליכה, כולל סטארבקס, סושי ג'ין וסופרמרקט Safeway"

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

ב-Places API (חדש) יש שני סוגים של סיכומי אזורים מבוססי-AI:

  • סיכומי שכונות, שמספקים סקירה כללית ברמה גבוהה של האטרקציות בסביבה למקומות עם הסוגים premise, street_address וכל הסוגים בקטגוריות דיור ואירוח.
  • סיכומי שירותים של תחנות טעינה לרכבים חשמליים (EVCS), שמספקים סקירה כללית על האטרקציות בקרבת מקום במקומות מסוג electric_vehicle_charging_station.

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

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

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

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

השדה neighborhoodSummary של מקום בתגובה מכיל את הפרטים הבאים:

  • שני שדות משנה: overview ו-description. שדה המשנה overview כולל מוקדי עניין בסביבה שספציפיים למקום, ואילו שדה המשנה description מספק מידע כללי יותר על האזור שמסביב. כל שדה משנה כולל רשימה של שמות של משאבי מקומות שמצוינים בהפניה, בפורמט place/PLACE_ID.
  • קישור flagContentUri שבו משתמשים יכולים לסמן בעיה באמצעות הסיכום שנוצר.
  • מחרוזת טקסט מותאמת לשוק המקומי עם טקסט הגילוי הנאות 'הסיכום נוצר באמצעות Gemini', שצריך לכלול בזיכויים.

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

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

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

{
  "id": "ChIJT0DdRo1ZwokRkufwSD-TdGM",
  "displayName": {
    "text": "Courtyard New York Manhattan/SoHo",
    "languageCode": "en"
  }
  "neighborhoodSummary": {
    "overview": {
      "content": {
        "text": "This area resides within SoHo, a trendy Lower Manhattan neighborhood celebrated for its upscale boutiques, designer shops, and thriving art scene. The area is home to the Color Factory and Dominique Ansel Bakery, known for its popular Cronuts.",
        "languageCode": "en-US"
      },
      "referencedPlaces": [
        "places/ChIJZd0F3oxZwokRiaEouMZKQ-0",
        /.../
      ]
    },
    "description": {
      "content": {
        "text": "SoHo's walkability and convenient public transportation options make exploration easy. A diverse array of restaurants and cafes cater to varied tastes. SoHo's central location, surrounded by vibrant neighborhoods, contributes to its fast-paced and energetic atmosphere, with a focus on fashion and design.",
        "languageCode": "en-US"
      },
      "referencedPlaces": [
        "places/ChIJZd0F3oxZwokRiaEouMZKQ-0",
        /.../
      ]
    },
    "flagContentUri": "https://www.google.com/local/review/rap/report?postId=&d=17924085&t=12",
    "disclosureText": {
      "text": "Summarized with Gemini",
      "languageCode": "en-US"
    }
  }
}

שליחת בקשה לקבלת סיכום של שירותי הטעינה לרכב חשמלי

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

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

השדה evChargeAmenitySummary של מקום בתגובה מכיל את הפרטים הבאים:

  • ארבעה שדות משנה: overview,‏ coffee,‏ restaurant ו-store. כל שדה משנה כולל תיאור קצר של מוקדי עניין בקרבת מקום ורשימת שמות של משאבי מיקומים שצוינו, בפורמט place/PLACE_ID.
  • קישור flagContentUri שבו משתמשים יכולים לסמן בעיה בסיכום שנוצר.
  • מחרוזת טקסט מותאמת לשוק המקומי עם טקסט הגילוי הנאות 'סיכום באמצעות Gemini', שצריך לכלול בזיקות.

בדוגמה הבאה מופיעה בקשה לסיכום של המתקנים בתחנת טעינה לרכב חשמלי (EV) ב-Mountain View:

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

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

{
  "id": "ChIJf8j-4z23j4AR_MQ2-bgMmrY",
  "displayName": {
    "text": "EVgo Charging Station",
    "languageCode": "en"
  },
  "evChargeAmenitySummary": {
    "overview": {
      "content": {
        "text": "Within a short walk, there are several coffee and restaurant options, including Clocktower Coffee Roasting Company, Khao Kang Thai Kitchen, and Roger's Deli & Donuts.",
        "languageCode": "en-US"
      },
      "referencedPlaces": [
        "places/ChIJZZR2-j23j4ARi5CXEIAc57Q",
        /.../
      ]
    },
    "coffee": {
      "content": {
        "text": "Clocktower Coffee Roasting Company has Wi-Fi and a variety of coffee and pastries in a laid-back atmosphere.",
        "languageCode": "en-US"
      },
      "referencedPlaces": [
        "places/ChIJZZR2-j23j4ARi5CXEIAc57Q"
      ]
    },
    "restaurant": {
      "content": {
        "text": "Roger's Deli & Donuts is a bustling deli with sandwiches and breakfast items.\nJoy Sushi serves classic Japanese dishes, including vegetarian and healthy options.\nSubway is a chain sandwich shop offering its usual subs, wraps, and salads.",
        "languageCode": "en-US"
      },
      "referencedPlaces": [
        "places/ChIJQ4F3PBa3j4ARf7_QjN1Cklo",
        /.../
      ]
    },
    "store": {
      "content": {
        "text": "Rotten Robbie is a chain gas station with a convenience store and a restroom.",
        "languageCode": "en-US"
      },
      "referencedPlaces": [
        "places/ChIJA6deFBa3j4AREY0EyTEGhN8",
        /.../
      ]
    },
    "flagContentUri": "https://www.google.com/local/review/rap/report?postId=ABCDEFG=1234567&t=12",
    "disclosureText": {
      "text": "Summarized with Gemini",
      "languageCode": "en-US"
    }
  }
}

שיוכים

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