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

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

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

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

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

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

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

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

«میانای برنامه‌سازی کاربردی مکان‌ها» (جدید) دو نوع خلاصه منطقه هوش مصنوعی ارائه می‌دهد:

• خلاصه‌های محله که نمای کلی سطح بالایی از جاذبه‌های اطراف برای مکان‌هایی با انواع 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 همراه باشد. برای اطلاعات بیشتر، خط‌مشی‌های API «مکان‌ها» را ببینید.