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

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

برای مثال، هنگام بازدید از شهری جدید، می‌توانید خلاصه تولیدشده محله را برای هتلی مشاهده کنید تا درباره منطقه اطراف آن بیشتر بدانید:

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

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

اگر قصد دارید خودرو برقی‌تان را شارژ کنید، می‌توانید خلاصه تولیدشده‌ای را برای ایستگاه شارژ خودرو برقی مشاهده کنید تا قهوه‌سراها یا رستوران‌های اطراف را پیدا کنید و در مدتی که منتظر هستید به آنجا بروید:

  • «این منطقه گزینه‌های متنوعی برای صرف غذا در فاصله ۹ دقیقه پیاده‌روی ارائه می‌دهد، ازجمله استارباکس، سوشی جین، و سیف‌وی.»

همراه با شرح منطقه، پاسخ حاوی فهرستی از شناسه‌های مکان برای مکان‌های ارجاع‌شده در شرح نیز هست.

‫Places API (جدید) دو نوع خلاصه منطقه با بهره‌گیری از هوش مصنوعی ارائه می‌دهد:

  • خلاصه‌های محله که نمای کلی سطح بالایی از جاذبه‌های اطراف برای مکان‌هایی با انواع premise، street_address، و همه انواع در دسته‌های مسکن و اقامتگاه ارائه می‌دهند.
  • خلاصه‌های امکانات رفاهی ایستگاه شارژ خودرو برقی (EVCS) که نمای کلی سطح بالایی از جاذبه‌های اطراف را برای مکان‌هایی با نوع electric_vehicle_charging_station ارائه می‌دهد.

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

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

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

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

خلاصه محله را می‌توان برای مکان‌هایی با نوع premise، street_address، و همه انواع در دسته‌های مسکن و اقامتگاه تولید کرد. برای برگرداندن خلاصه محله در پاسخ، موارد زیر را در ماسک فیلد درخواستتان اضافه کنید:

  • جزئیات جا (جدید): 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 تولید کرد. برای گنجاندن خلاصه امکانات رفاهی EVCS در پاسخ، موارد زیر را در ماسک فیلد درخواستتان اضافه کنید:

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

فیلد evChargeAmenitySummary برای مکانی در پاسخ حاوی موارد زیر است:

  • چهار فیلد فرعی: overview، coffee، restaurant، و store. هر زیرفیلد شامل شرح مختصری از نقاط جالب اطراف و فهرستی از نام‌های منبع مکان ارجاع‌شده در فرم place/PLACE_ID است.
  • پیوند flagContentUri که کاربران می‌توانند ازطریق آن مشکلات خلاصه تولیدشده را پرچم‌گذاری کنند.
  • رشته نوشتاری بومی‌سازی‌شده با متن شفاف‌سازی «خلاصه‌شده با Gemini» که باید در ارجاع‌ها گنجانده شود.

درخواست زیر نمونه‌ای از خلاصه امکانات رفاهی ایستگاه شارژ خودرو برقی برای ایستگاه شارژی در 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"
    }
  }
}

ارجاع‌ها

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