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

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

برای مثال، خلاصه‌های مکان ممکن است غذاها، خدمات، یا کالاهای پرطرفدار موجود برای خرید در یک مکان را برجسته کند:

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

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

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

زبان منطقه
انگلیسی

هند

ایالات متحده

درخواست خلاصه تولیدکننده مکان

برای برگرداندن خلاصه مکان در پاسخ، فیلد زیر را در ماسک فیلد درخواست قرار دهید:

  • جزئیات مکان (جدید): 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"
        }
      }
    },
    /.../
  ]
}

ارجاع‌ها

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