خلاصه‌های مرور هوشواره‌ای

خلاصه‌های مرور با بهره‌گیری از هوش مصنوعی خلاصه‌هایی از مکان‌ها هستند که با هوش مصنوعی و صرفاً براساس مرورهای کاربر تولید می‌شوند. خلاصه‌های مرورها با ترکیب عناصر کلیدی مرورهای کاربران، مانند مشخصه‌های مکان و احساسات مرورگر، اطلاعات آماری سطح بالایی ارائه می‌دهند و به کاربران کمک می‌کنند تصمیمات آگاهانه بگیرند.

برای مثال، خلاصه مرورهای «ساختمان فری» در سان‌فرانسیسکو شامل اطلاعاتی از غذا و خرید گرفته تا مناظر و جو است:

«بازدیدکنندگان می‌گویند این مکان تاریخی مجموعه‌ای متنوع از فروشگاه‌ها، رستوران‌ها، و بازار کشاورزان را ارائه می‌دهد و بسیاری از آن‌ها چشم‌اندازهای خلیج و شهر را تحسین می‌کنند. آن‌ها همچنین فضای پرجنب‌وجوش، دسترسی راحت به فرابر برای رفتن به مقصدهای دیگر، و فرصت لذت بردن از کسب‌وکارهای محلی را برجسته می‌کنند.»

خلاصه مرورها در جزئیات جا (جدید)، جستجوی نوشتار (جدید)، و جستجوی اطراف (جدید) پشتیبانی می‌شود.

خلاصه مرورها برای مکان‌های جالب به زبان‌ها و در مناطق زیر پشتیبانی می‌شود:

زبان منطقه
انگلیسی آرژانتین، بولیوی، برزیل، شیلی، کلمبیا، کاستاریکا، جمهوری دومینیکن، اکوادور، گواتمالا، هند، ژاپن، مکزیک، پاراگوئه، پرو، پادشاهی متحد (UK)، ایالات متحده، اروگوئه، ونزوئلا
ژاپنی ژاپن
پرتغالی برزیل
اسپانیایی آرژانتین، بولیوی، شیلی، کلمبیا، کاستاریکا، جمهوری دومینیکن، اکوادور، گواتمالا، مکزیک، پاراگوئه، پرو، ایالات متحده، اروگوئه، ونزوئلا

درخواست خلاصه مرورها

برای درخواست خلاصه مرور، reviewSummary را در ماسک فیلد درخواست اضافه کنید:

  • جزئیات جا (جدید): reviewSummary
  • جستجوی نوشتار (جدید) و جستجوی اطراف (جدید): places.reviewSummary

ارجاع‌های خلاصه مرور باید شامل پیوندی به مرورهای مکان در Google Maps باشد. برای بازیابی آن پیوند، reviewSummary.reviewsUri را در ماسک فیلد درخواست اضافه کنید.

بدنه پاسخ شامل سه فیلد است:

  • text: خلاصه مرور تولیدشده با هوش مصنوعی.
  • 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"

پاسخ به‌صورت زیر است:

{
  "displayName": {
    "text": "Dumpling House",
    "languageCode": "en"
  },
  "reviewSummary": {
    "text": {
      "text": "People say this restaurant serves delicious dumplings, noodles, and pork belly buns. They highlight the generous portions, reasonable prices, and quick service. They also like the friendly and accommodating staff.",
      "languageCode": "en-US"
    },
    "flagContentUri": "https://www.google.com/local/review/rap/report?postId=5%401:CAIQACodChtyc19oOnNwOUFtUVhIX1BoTEZjTFg0MmNXNEE%7CCAIQACorChtyc19oOnNwOUFtUVhIX1BoTEZjTFg0MmNXNEESDAikt7HDBhDopLLxAg&d=17924085&t=8",
    "disclosureText": {
      "text": "Summarized with Gemini",
      "languageCode": "en-US"
    },
    "reviewsUri": "https://www.google.com/maps/place//data=!4m4!3m3!1s0x89d14bb69376690f:0x53d61573fb1dcd0b!9m1!1b1"
  }
}

درخواست «جستجوی نوشتار (جدید)»

مثال زیر خلاصه مرورها را برای قهوه‌سرایی در شهر نیویورک درخواست می‌کند:

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" \
'https://places.googleapis.com/v1/places:searchText'

متن پاسخ در فرم است:

{
  "places": [
    {
      "id": "ChIJyfJXNphZwokRbo-oe0DjVT4",
      "reviewSummary": {
        "text": {
          "text": "People say this coffee shop serves up delicious oat milk lattes, cold brew, and pastries, such as almond croissants and cheese danish. They also highlight the friendly staff, cozy atmosphere, and outdoor seating.",
          "languageCode": "en-US"
        },
        "flagContentUri": "https://www.google.com/local/review/rap/report?postId=5%401:CAIQACodChtyc19oOkk1Z1UwZkp4cEJ3bnA3aGt5VGJLMFE%7CCAIQACorChtyc19oOkk1Z1UwZkp4cEJ3bnA3aGt5VGJLMFESDAj7p9_BBhCYsoeAAw&d=17924085&t=8",
        "disclosureText": {
          "text": "Summarized with Gemini",
          "languageCode": "en-US"
        },
        "reviewsUri": "https://www.google.com/maps/place//data=!4m4!3m3!1s0x89c259983657f2c9:0x3e55e3407ba88f6e!9m1!1b1"
      }
    },
    {
      "id": "ChIJHcFFXH9ZwokR_QKedPacLiQ",
      "reviewSummary": {
        "text": {
          "text": "People say this cafe offers delicious matcha, lattes, and freshly baked pastries, including the popular rose honey latte and blueberry lemon muffin. They highlight the spacious, chill, and cinema-inspired vibe, perfect for working or socializing, and the fast, friendly service. They also like the free WiFi, outlets, and clean restrooms.",
          "languageCode": "en-US"
        },
        "flagContentUri": "https://www.google.com/local/review/rap/report?postId=5%401:CAIQACodChtyc19oOl8yWTlXS0NDVTk1UEhiTFdBQzhlelE%7CCAIQACorChtyc19oOl8yWTlXS0NDVTk1UEhiTFdBQzhlelESDAikt7HDBhDopLLxAg&d=17924085&t=8",
        "disclosureText": {
          "text": "Summarized with Gemini",
          "languageCode": "en-US"
        },
        "reviewsUri": "https://www.google.com/maps/place//data=!4m4!3m3!1s0x89c2597f5c45c11d:0x242e9cf6749e02fd!9m1!1b1"
      }
    },
    ...
  ]
}

درخواست «جستجوی اطراف (جدید)»

نمونه زیر هتل‌های نزدیک مرکز شهر سیاتل را درخواست می‌کند:

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" \
'https://places.googleapis.com/v1/places:searchNearby'

پاسخ به‌صورت زیر است:

{
  "places": [
    {
      "id": "ChIJRwVmS-BrkFQRpAB3pO5JOuQ",
      "reviewSummary": {
        "text": {
          "text": "People say this hotel offers clean, modern, and spacious rooms with comfortable beds and phenomenal city views. They highlight the convenient downtown location, with easy walking access to popular attractions, and the efficient self-parking option. They also like the friendly and helpful staff, and the smooth check-in and check-out process.",
          "languageCode": "en-US"
        },
        "flagContentUri": "https://www.google.com/local/review/rap/report?postId=5%401:CAIQACodChtyc19oOlJWVG5YOXZrSnZhTXBqUy1rc1JZc3c%7CCAIQACorChtyc19oOlJWVG5YOXZrSnZhTXBqUy1rc1JZc3cSDAikt7HDBhDopLLxAg&d=17924085&t=8",
        "disclosureText": {
          "text": "Summarized with Gemini",
          "languageCode": "en-US"
        },
        "reviewsUri": "https://www.google.com/maps/place//data=!4m4!3m3!1s0x54906be04b660547:0xe43a49eea47700a4!9m1!1b1"
      }
    },
    {
      "id": "ChIJQVJVX7RqkFQRcpsm3VVub9U",
      "reviewSummary": {
        "text": {
          "text": "People say this hotel offers spacious rooms, a convenient location near the convention center and Pike Place Market, and a tasty restaurant. They also highlight the friendly and attentive staff, the comfortable beds and pillows, and the convenient amenities such as a Starbucks in the lobby and a club lounge.\n\nSome reviews mention the rooms can be noisy.",
          "languageCode": "en-US"
        },
        "flagContentUri": "https://www.google.com/local/review/rap/report?postId=5%401:CAIQACodChtyc19oOldJVUlodGhTUTJOdUdTSmFxQWw2Nnc%7CCAIQACorChtyc19oOldJVUlodGhTUTJOdUdTSmFxQWw2NncSDAikt7HDBhDopLLxAg&d=17924085&t=8",
        "disclosureText": {
          "text": "Summarized with Gemini",
          "languageCode": "en-US"
        },
        "reviewsUri": "https://www.google.com/maps/place//data=!4m4!3m3!1s0x54906ab45f555241:0xd56f6e55dd269b72!9m1!1b1"
      }
    },
    ...
  ]
}

ارجاع‌ها

همه خلاصه‌های تولیدشده با هوش مصنوعی که در برنامه‌تان نمایش داده می‌شود باید با ارجاع مناسب مطابق با خط‌مشی‌ها و استانداردهای Google همراه باشد. برای اطلاعات بیشتر، خط‌مشی‌های Places API را ببینید.