قابلیت‌های مدل Gemini برای Places API

قابلیت‌های مدل Gemini برای Places API (جدید) پشتیبانی از LLM‌ها را به Places API می‌آورد تا بتوانید داده‌های مرتبط با یک مکان (ساعت کاری، نظرات، عکس‌ها) را به همراه داده‌های ارائه شده توسط LLM برگردانید. این داده‌های تولیدی حاوی داده‌های انباشته‌شده و خلاصه‌شده از LLM‌ها است تا داده‌هایی را که قبلاً با یک مکان مرتبط است، افزایش دهد.

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

اما ممکن است بخواهید درک بهتری از منطقه اطراف ایستگاه شارژ داشته باشید، به خصوص اگر قرار است یک ساعت یا بیشتر در حین شارژ شدن وسیله نقلیه خود در آنجا باشید. هنگام استفاده از قابلیت‌های مدل Gemini برای همان جستجو، پاسخ می‌تواند حاوی توضیحات پویا و مولد از هر مکان در پاسخ باشد، از جمله اطلاعات مربوط به منطقه اطراف ایستگاه شارژ:

  • در فاصله 2 تا 4 دقیقه پیاده روی، چندین گزینه غذاخوری و خرید وجود دارد، از جمله Chef Chu's، Gen Korean BBQ House، Amber India، Pacific Catch، و چندین فروشگاه مواد غذایی مانند Walmart، Whole Foods Market، و Trader Joe.

  • "در فاصله 1 تا 5 دقیقه پیاده روی، چندین گزینه غذاخوری و خرید وجود دارد، از جمله آشپزخانه Khao Kang Thai، Roger's Deli & Donuts، و La Costeña. برای سوشی، Joy Sushi گزینه خوبی است. برای مواد غذایی، Dollar Tree انواع مختلفی را ارائه می دهد. محصولات با قیمت های تخفیفی."

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

ویژگی های جدید مبتنی بر هوش مصنوعی به Places API اضافه شده است (جدید)

این قابلیت‌ها داده‌های زیر را به پاسخ Places API (جدید) اضافه می‌کنند:

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

خلاصه مکان های تولیدی مختص یک شناسه مکان هستند. خلاصه مکان ها انواع مختلفی از داده ها را در یک خلاصه واحد برای مکان جمع می کند.

Places API (جدید) دو نوع خلاصه مکان مولد را ارائه می دهد:

  • خلاصه‌های مرور کلی : مروری مختصر از یک مکان، به طور متوسط ​​حدود 100 کاراکتر، که می‌تواند به کاربران کمک کند یک عکس فوری از یک مکان داشته باشند.

  • خلاصه توضیحات : خلاصه های طولانی تر از یک مکان، به طور متوسط ​​حدود 400 کاراکتر، که نمای کلی دقیقی را ارائه می دهد که جنبه های برتر مکان را پوشش می دهد.

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

خلاصه های منطقه مولد

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

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

خلاصه‌های منطقه در حال حاضر برای انواع مکان‌های نشان‌داده‌شده در انواع پشتیبانی‌شده برای دسته مسکن ، و همچنین انواع مکان‌های خاص electric_vehicle_charging_station ، geocode ، و premise موجود است.

تولید خلاصه مکان و منطقه

هم خلاصه‌های مکان مولد و هم خلاصه‌های ناحیه تولیدی اغلب به‌طور آفلاین توسط Google ایجاد می‌شوند. با تولید این خلاصه‌ها به‌صورت آفلاین، می‌توانید از محتوای ارائه‌شده توسط Gemini بهره ببرید و در عین حال همان عملکردی را از Places API (جدید) ببینید که قبلاً انتظارش را داشتید.

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

نتایج جستجوی متنی

جستجوی متن (جدید) اطلاعات مجموعه‌ای از مکان‌ها را بر اساس یک رشته برمی‌گرداند - برای مثال «پیتزا در نیویورک» یا «فروشگاه‌های کفش در نزدیکی اتاوا». پاسخ جستجوی متن (جدید) شامل فهرستی از مکان‌های منطبق با رشته متن و هرگونه سوگیری مکان تنظیم شده در درخواست است.

وقتی نتایج جستجوی متنی را به پاسخ اضافه می‌کنید، اکنون پاسخ شامل نظرات، عکس‌ها و توجیهاتی می‌شود که به کاربران کمک می‌کند به سؤالات پاسخ دهند:

  • چرا من این مکان را در نتایج می بینم؟
  • چرا باید این مکان را انتخاب کنم؟

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

با این حال، برای جستجوی متن (جدید) با استفاده از قابلیت‌های جدید، پاسخ می‌تواند شامل داده‌هایی باشد که از خود رشته جستجوی ورودی مشتق شده‌اند. این بدان معناست که نتایج جستجوی متنی برای رشته پرس و جو منحصر به فرد است. به عنوان مثال، شما یک درخواست جستجوی متن (جدید) با رشته پرس و جو زیر ایجاد می کنید:

"رستوران گیاهی تند در Mountain View، CA"

سپس تمام پارامترهای ورودی را یکسان می گذارید و فقط رشته پرس و جو را به:

"رستوران وگان تند در Mountain View، CA"

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

فعال کردن قابلیت‌های مدل Gemini برای Places API (جدید)

برای استفاده از قابلیت‌های مدل Gemini برای Places API (جدید) باید Places API (جدید) را فعال کنید. برای اطلاعات بیشتر، به تنظیم پروژه Google Cloud خود مراجعه کنید.

محدودیت برای انتشار آزمایشی

این نسخه فقط از خلاصه مکان ها و مناطق برای مکان های ایالات متحده فقط به زبان انگلیسی پشتیبانی می کند.

جمینی چیست؟

برای آشنایی با مدل Gemini، به سوالات متداول Gemini مراجعه کنید.

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

خلاصه‌های مکان، خلاصه‌های تولیدی هستند که توسط LLM برای یک مکان خاص ایجاد می‌شوند. Places API (جدید) دو نوع خلاصه به پاسخ اضافه می کند:

  • خلاصه‌های تولیدی را مرور کنید که شبیه به خلاصه سرمقاله ثابت مرتبط با یک مکان هستند. خلاصه های کوتاه تولیدی، به طور متوسط ​​حدود 100 کاراکتر، چندین مزیت دارند:

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

    • آنها از LLM تولید می شوند، بنابراین نیازی به نگهداری از مالک مکان نیست.

  • خلاصه‌های تولیدی توضیحات از منابع بسیاری مشتق شده‌اند، از جمله نظرات Google Maps. توضیحات، به طور متوسط ​​حدود 400 کاراکتر، شامل لیستی از بررسی های مورد استفاده برای ایجاد توضیحات طولانی است.

    برای تولید خلاصه‌های توضیحات به صورت دستی، نیاز است که شخص داده‌ها را از مکان‌های مختلف جمع‌آوری کند و سپس محتوا را دستی ساخته و نگهداری کند. قابلیت‌های مدل Gemini برای Places API (جدید) این خلاصه‌ها را از LLMها ایجاد می‌کند تا دامنه و تازگی محتوای تولید شده را حفظ کند.

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

  • جزئیات مکان : generativeSummary

  • جستجوی متن و جستجوی نزدیک : places.generativeSummary

فیلد generativeSummary شامل فیلدهای زیر است:

  • generativeSummary.overview : خلاصه نمای کلی تولیدی.
  • generativeSummary.description : خلاصه توضیحات تولیدی.
  • generativeSummary.references : آرایه ای از حداکثر پنج بررسی که برای ارائه محتوا برای خلاصه توضیحات استفاده می شود. اگر خلاصه توضیحاتی وجود نداشته باشد، این آرایه خالی است.
  • overviewFlagContentUri : پیوندی که در آن کاربران می توانند یک مشکل را با خلاصه نمای کلی علامت گذاری کنند.
  • descriptionFlagContentUri : پیوندی که در آن کاربران می‌توانند مشکلی را با خلاصه توضیحات علامت‌گذاری کنند.

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

این مثال از یک ماسک فیلد places.generativeSummary .generativeSummary برای برگرداندن کل شیء generativeSummary از جمله فیلدهای generativeSummary.overview ، generativeSummary.description و generativeSummary.references استفاده می‌کند:

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": "ChIJQ8nPjFW3j4ARcAaUg5pF-Ts",
      "displayName": {
        "text": "Zareen's",
        "languageCode": "en"
      },
      "generativeSummary": {
        "overview": {
          "text": "Casual restaurant serving halal Pakistani and Indian cuisine, plus a selection of vegetarian items.",
          "languageCode": "en-US"
        },
        "description": {
          "text": "Pakistani restaurant dishing up comfort food including vegetarian, vegan, and halal options.
          Offerings include chicken tikka masala, naan, and paratha. There's also a salad bar, and dessert is
          available.\nOpen for breakfast, lunch, and dinner, the venue has a casual atmosphere and outdoor rooftop
          seating. People mention the ambiance and say the service is prompt.\nCustomers typically spend $10–20.",
          "languageCode": "en-US"
        },
        "references": {
          "reviews": [
            {
              "name": "places/ChIJQ8nPjFW3j4ARcAaUg5pF-Ts/reviews/ChZDSUhNMG9nS0VJQ0FnSUN4aUtDbVJREAE",
              "relativePublishTimeDescription": "12 months ago",
              "rating": 5,
              "text": {
                "text": "Insanely good Pakistani food with the perfect ambiance! This food never disappoints AND THEY ARE OPEN TILL MIDNIGHT!!",
                "languageCode": "en"
              },
              "originalText": {
                "text": "Insanely good Pakistani food with the perfect ambiance! This food never disappoints AND THEY ARE OPEN TILL MIDNIGHT!!",
                "languageCode": "en"
              },
              "authorAttribution": {
                "displayName": "John Smith",
                "uri": "https://www.google.com/maps/contrib/11685942231/reviews",
                "photoUri": "https://lh3.googleusercontent.com/a-/ALV-UjWbImVTop_1d-cc-rp-mo"
              },
              "publishTime": "2023-05-09T07:24:36Z"
              "flagContentUri": "https://www.google.com/local/review/rap/report?postId=ChRAB&d=17924085&t=1",
              "googleMapsUri": "https://www.google.com/maps/reviews/data=!4m7558ccfc943:0x3bf9459a83940670"
            },
            . . .
          ]
        },
        "overviewFlagContentUri": "https://www.google.com/local/review/rap/report?postId=CiUweDgwOGZiNzU1O085&t=12",
        "descriptionFlagContentUri": "https://www.google.com/local/review/rap/report?postId=CiUweDgwOG&t=12"
      }
    },
    {
      "id": "ChIJETHw0F-7j4AR85V_I6OobCI",
      "displayName": {
        "text": "Hyderabad Dum Biryani",
        "languageCode": "en"
      },
      "generativeSummary": {
        "overview": {
          "text": "Indian restaurant offering comfort food including vegetarian and vegan options.",
          "languageCode": "en-US"
        },
        . . .
}

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

این مثال جستجوی متن فقط خلاصه overview رستوران های گیاهی تند در Mountain View، CA را نشان می دهد:

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

پاسخ شامل قسمت generativeSummary.overview است که شامل overview.text و overview.languageCode است:

{
  "places": [
    {
      "id": "ChIJQ8nPjFW3j4ARcAaUg5pF-Ts",
      "displayName": {
        "text": "Zareen's",
        "languageCode": "en"
      },
      "generativeSummary": {
        "overview": {
          "text": "Casual restaurant serving halal Pakistani and Indian cuisine, plus a selection of vegetarian items.",
          "languageCode": "en-US"
        }
      }
    },
    {
      "id": "ChIJETHw0F-7j4AR85V_I6OobCI",
      "displayName": {
        "text": "Hyderabad Dum Biryani",
        "languageCode": "en"
      },
      "generativeSummary": {
        "overview": {
          "text": "Casual eatery offering vegetarian & non-vegetarian Indian fare, plus breads & desserts.",
          "languageCode": "en-US"
        }
      }
    },
  . . .
}

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

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

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

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

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

  • areaSummary (جزئیات مکان)
  • places.areaSummary (جستجوی متن و جستجوی نزدیک).

فیلد areaSummary برای مکانی در پاسخ حاوی فیلد flagContentUri است که می‌توانید از آن برای پرچم‌گذاری محتوای نامناسب استفاده کنید تا Google بتواند آن را حذف کند. همچنین حاوی آرایه ای از حداکثر چهار contentBlocks است. موضوع هر بلوک بر اساس نوع مکان است:

  • برای یک ایستگاه شارژ EV که به عنوان مکانی از نوع electric_vehicle_charging_station تعریف می‌شود، بلوک‌های موضوعی عبارتند از: "overview" ، "coffee" ، "restaurant" و "store" .

  • برای مکانی با یک نوع تعریف شده توسط دسته اقامت ، و انواع مکان های خاص geocode و premise ، بلوک های موضوع عبارتند از: "overview" ، "activity" ، "restaurant" و "store" .

درخواست مثال برای خلاصه منطقه یک ایستگاه شارژ EV

این مثال درخواست Place Details خلاصه منطقه یک ایستگاه شارژ خودروی الکتریکی خاص در Mountain View را که با شناسه مکان ChIJC5b6QKiwj4ARgn2EwlnJnWU شناسایی شده است، برمی گرداند:

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

پاسخ شامل قسمت areaSummary ، از جمله آرایه contentBlocks است:

  • فیلد topic نوع بلوک محتوا را مشخص می کند. از آنجایی که مکان در این مثال یک ایستگاه شارژ EV است، چهار بلوک محتوا عبارتند از "overview" ، "coffee" ، "restaurant" و "store" .

  • فیلد content شامل خلاصه آن موضوع، از جمله کد زبان است.

  • آرایه references نام منابع مکان را به شکل places/ PLACE_ID مشخص می کند که برای ارائه محتوا برای بلوک محتوا استفاده می شود.

{
  "id": "ChIJC5b6QKiwj4ARgn2EwlnJnWU",
  "displayName": {
    "text": "EVgo Charging Station",
    "languageCode": "en"
  },
  "areaSummary": {
    "contentBlocks": [
      {
        "topic": "overview",
        "content": {
          "text": "Within a 4-minute walk, there are several dining and shopping options from this charging station, including Starbucks and Los Altos Taqueria.",
          "languageCode": "en-US"
        },
        "references": {
          "places": [
            "places/ChIJ-f-lEaiwj4ARB1IwfdLFfRY",
            "places/ChIJhzHBsAe6j4ARvq9oi8u-bqQ"
          ]
        }
      },
      {
        "topic": "coffee",
        "content": {
          "text": "Starbucks offers Wi-Fi, light bites, and its signature roasts in a cozy space.",
          "languageCode": "en-US"
        },
        "references": {
          "places": [
            "places/ChIJ-f-lEaiwj4ARB1IwfdLFfRY"
          ]
        }
      },
      {
        "topic": "restaurant",
        "content": {
          "text": "Los Altos Taqueria serves classic Mexican dishes in a kid-friendly venue.\nHyderabad Dum Biryani specializes in vegetarian and vegan Indian fare, including lunch and dinner options.\nSushi Jin is a popular spot for sushi and other Japanese dishes, featuring a relaxed atmosphere.\nSuper tacos el conrro is a kid-friendly spot for Mexican fare.",
          "languageCode": "en-US"
        },
        "references": {
          "places": [
            "places/ChIJhzHBsAe6j4ARvq9oi8u-bqQ",
            "places/ChIJETHw0F-7j4AR85V_I6OobCI",
            "places/ChIJ-9pg_Qmxj4AR4deSLfZINW0",
            "places/ChIJvcqEhTyxj4AR4ZdQevNxGZk"
          ]
        }
      },
      {
        "topic": "store",
        "content": {
          "text": "Safeway provides a range of groceries, along with a deli and a bakery.",
          "languageCode": "en-US"
        },
        "references": {
          "places": [
            "places/ChIJF7_iDaiwj4ARzdC4NlGzJFI"
          ]
        }
      }
    ],
    "flagContentUri": "https://www.google.com/local/review/rap/report?postId=IhkpuV1UwBQ&d=17924085&t=12"
  }
}

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

این مثال درخواست جستجوی متن از هتل‌ها در Mountain View، CA درخواست می‌کند:

curl -X  POST -d '{
  "textQuery": "Hotels",
  "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.areaSummary" \
https://places.googleapis.com/v1/places:searchText

پاسخ شامل قسمت areaSummary ، از جمله آرایه contentBlocks است. پاسخ برای مکان‌هایی از نوع هتل شامل بلوک‌های محتوایی برای موضوعات "overview" ، "activity" ، "restaurant" و "store" است:

{
  "places": [
    {
      "id": "ChIJ81X7bC63j4ARNJTuqMFBq-4",
      "displayName": {
        "text": "Shashi Hotel Mountain View, an Urban Resort",
        "languageCode": "en"
      },
      "areaSummary": {
        "contentBlocks": [
          {
            "topic": "overview",
            "content": {
              "text": "This area offers several attractions, including Cinemark Century Mountain View 16 and Computer History Museum. Charleston Park provides picnic spots and the Pear Theatre hosts performances.",
              "languageCode": "en-US"
            },
            "references": {
              "places": [
                "places/ChIJOYvCo1W3j4AR1LAifgk13rs",
                "places/ChIJm7NJkla3j4AR8vR-HWRxgOo",
                "places/ChIJo4za6vi5j4ARMua093RgGGA",
                "places/ChIJ4V-yslC3j4ARE6I2cpvyOeU"
              ]
            }
          },
          {
            "topic": "activity",
            "content": {
              "text": "Cinemark Century Mountain View 16 offers XD and RealD 3D screens, plus comfortable seating and a snack bar.\nComputer History Museum showcases the evolution of technology with interactive exhibits.\nRyptic Room Escape Mountain View presents themed rooms where teams solve puzzles to escape.",
              "languageCode": "en-US"
            },
            "references": {
              "places": [
                "places/ChIJOYvCo1W3j4AR1LAifgk13rs",
                "places/ChIJm7NJkla3j4AR8vR-HWRxgOo",
                "places/ChIJ1_ZkCKqwj4ARPaLA4yiEtdI"
              ]
            }
          },
          {
            "topic": "restaurant",
            "content": {
              "text": "Cucina Venti Restaurant prepares Italian cuisine in a rustic setting with outdoor seating.\nRoger Bar and Restaurant provides cocktails on tap, along with an indoor-outdoor bar and dining area.\nBroma Restaurant serves Spanish-inspired tapas and shareable plates in a trendy atmosphere.",
              "languageCode": "en-US"
            },
            "references": {
              "places": [
                "places/ChIJC_3cdla3j4ARMgf4Pw8Irek",
                "places/ChIJh1Y1MA23j4AREJz6Kxl75Uo",
                "places/ChIJLRvDZtu3j4ARgoNrKZnNw8g"
              ]
            }
          },
          {
            "topic": "store",
            "content": {
              "text": "NASA Gear Store and Food Mart offer a variety of gifts and convenience store items.",
              "languageCode": "en-US"
            },
            "references": {
              "places": [
                "places/ChIJh64-r0O3j4ARy1P41IH2j3k",
                "places/ChIJ5ZJtB8u3j4ARR0gohzD8-ns"
              ]
            }
          }
        ],
        "flagContentUri": "https://www.google.com/local/review/rap/report?postId=GQAAAA085&t=12"
      }
    },
    ...
  ]
}

نتایج جستجوی متنی را درخواست کنید

پاسخ به درخواست جستجوی متن (جدید) حاوی آرایه‌ای از مکان‌ها است که با معیارهای رشته جستجوی ورودی مطابقت دارد. اکنون می توانید داده های جستجوی متنی را در پاسخ بر اساس پرس و جوی ورودی به API درخواست کنید.

برای پشتیبانی از خلاصه‌های متنی، پاسخ از جستجوی متن (جدید) حاوی یک آرایه جدید به نام contextualContents در همان سطح آرایه places در پاسخ است:

{
  "places": [],
  "contextualContents":[]
}

هر عنصر در آرایه contextualContents ، از نوع ContextualContent ، در محل آرایه مربوطه به عنوان مکان در آرایه places قرار دارد. یعنی عنصر در contextualContents[0] با مکان places[0] .

هر عنصر آرایه حاوی فیلدهای آرایه زیر است:

  • contextualContents.reviews : آرایه ای از حداکثر سه بررسی .
  • contextualContents.photos : آرایه ای از حداکثر پنج عکس .

  • contextualContents.justifications : مجموعه ای از توجیهات برای مکان، از جمله:

    • reviewJustification : بخشی از بررسی کاربر را که می تواند برای کاربر نهایی جالب باشد برجسته کنید.
    • businessAvailabilityAttributesJustification : شامل ویژگی‌هایی برای یک کسب‌وکار است که می‌تواند برای کاربر نهایی جالب باشد.

برای گنجاندن نتایج جستجوی متنی در پاسخ، contextualContents در ماسک فیلد درخواست جستجوی متن (جدید) قرار دهید: 

curl -X  POST  -d '{
  "textQuery": "Spicy vegetarian restaurant in Mountain View, CA",
  "openNow": true,
  "maxResultCount": 3
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.id,places.displayName,contextualContents" \
https://places.googleapis.com/v1/places:searchText

پاسخ شامل آرایه contextualContents برای هر مکان در پاسخ است:

{
  "places": [
    {
      "id": "ChIJETHw0F-7j4AR85V_I6OobCI",
      "displayName": {
        "text": "Hyderabad Dum Biryani",
        "languageCode": "en"
      }
    },
    . . .
  ],
  "contextualContents": [
    {
      "reviews": [
        {
          "name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/reviews/ChdDSUhNMG9nS0VJQ0FnSURSeEtMdHZ3RRAB",
          "relativePublishTimeDescription": "a year ago",
          "rating": 5,
          "text": {
            "text": "Very tasty! Rich spices and textures. We really appreciated
            all of the vegan options. We shared samosas (great sauce!) , tofu 65
            (spicy!!), gobi manchurian (less flavorful but a nice sweet offset to
            the tofu 65) and veg pakoras (very crunchy and awesome flavor). We
            enjoyed all of it, with the pakoras being the table's favorite.",
            "languageCode": "en"
          },
          "originalText": {
            "text": "Very tasty! Rich spices and textures. We really appreciated
            all of the vegan options. We shared samosas (great sauce!) , tofu 65
            (spicy!!), gobi manchurian (less flavorful but a nice sweet offset
            to the tofu 65) and veg pakoras (very crunchy and awesome flavor).
            We enjoyed all of it, with the pakoras being the table's favorite.",
            "languageCode": "en"
          },
          "authorAttribution": {
            "displayName": "Jane Doe",
            "uri": "https://www.google.com/maps/contrib/113193/reviews",
            "photoUri": "https://lh3.googleusercontent.com/a-/ALVVXe4iwrp-mo-br100"
          },
          "publishTime": "2023-04-18T02:48:02Z",
          "flagContentUri": "https://www.google.com/local/review/rap/report?postIWkF24085&t=1",
          "googleMapsUri": "https://www.google.com/maps/reviews/data=!4m6!1sChZDSUhb1e9679abc80b8db"
        },
        {
          "name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/reviews/ChdDSUhzlhTG53RRAB",
          "relativePublishTimeDescription": "10 months ago",
          "rating": 5,
          "text": {
            "text": "This is a nice little spot to eat at. I'm a big fan of
            curries, and they are spot on when it comes to flavor and spice. I highly recommend this place.",
            "languageCode": "en"
          },
          "originalText": {
            "text": "This is a nice little spot to eat at. I'm a big fan of curries,
            and they are spot on when it comes to flavor and spice. I highly recommend this place.",
            "languageCode": "en"
          },
          "authorAttribution": {
            "displayName": "Bob Jones",
            "uri": "https://www.google.com/maps/contrib/11034435/reviews",
            "photoUri": "https://lh3.googleusercontent.com/a/ACg8ocIAGguhz-EccsS9p-mo-ba4-br100"
          },
          "publishTime": "2023-07-03T16:51:49Z",
          "flagContentUri": "https://www.google.com/local/review/rap/report?postIWkF3EAE&d=17924085&t=1",
          "googleMapsUri": "https://www.google.com/maps/reviews/data=!4m6!14m5!1m4!2m3!1sChZDSUhb1e9679abc80b8db"
        },
        . . .
      ],
      "photos": [
        {
          "name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/photos/Vt2DAKajwJfgC_I-baPKjSeSw-JAXY-tCZOBAe7pBxxIS0Vo1w23sCO9o5RzoxJ",
          "widthPx": 1920,
          "heightPx": 1080,
          "authorAttributions": [
            {
              "displayName": "A Google User",
              "uri": "//maps.google.com/maps/contrib/113010465422",
              "photoUri": "//lh3.googleusercontent.com/a-/ALV-UjV_8hbrtgyc0-p-k-no-mo"
            }
          ],
          "flagContentUri": "https://www.google.com/local/review/rap/report?postId=ChZDSWkF3EAE&d=15&t=1",
          "googleMapsUri": "https://www.google.com/maps/reviews/data=!4m6!14m5!1m4!2m3!1sChZDSUhNbc80b8db"
        },
        {
          "name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/photos/AUGGfZkJ4MMlLikE2EyP-b13GeFZ9Nwhk24vK212hZo",
          "widthPx": 960,
          "heightPx": 720,
          "authorAttributions": [
            {
              "displayName": "Toast"
            }
          ],
          "flagContentUri": "https://www.google.com/local/review/rap/report?postId4085&t=1",
          "googleMapsUri": "https://www.google.com/maps/reviews/data=!4m6!14m5!1m4!2m3!b1e9679abc80b8db"
        },
        . . .
      ],
      "justifications": [
        {
          "reviewJustification": {
            "highlightedText": {
              "text": "\"Not too spicy or oily.\"",
              "highlightedTextRanges": [
                {
                  "startIndex": 9,
                  "endIndex": 14
                }
              ]
            },
            "review": {
              "name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/reviews/ChZDSUhNMG9nS0VJQ0FnSUR4djR2Z1B3EAE",
              "relativePublishTimeDescription": "10 months ago",
              "rating": 5,
              "text": {
                "text": "Not too spicy or oily. We have the mutton dum biryanis
                and tandoori fish. Very flavorful. The food was served promptly.
                Clean environment. A little small more like a hole in the wall.
                We'd come back for sure.",
                "languageCode": "en"
              },
              "originalText": {
                "text": "Not too spicy or oily. We have the mutton dum biryanis
                and tandoori fish. Very flavorful. The food was served promptly.
                Clean environment. A little small more like a hole in the wall.
                We'd come back for sure.",
                "languageCode": "en"
              },
              "authorAttribution": {
                "displayName": "Stan Davis",
                "uri": "https://www.google.com/maps/contrib/112959/reviews",
                "photoUri": "https://lh3.googleuser-cc-rp-mo"
              },
              "publishTime": "2023-06-18T06:12:41Z",
              "flagContentUri": "https://www.google.com/local/review/rap/report?postt=1",
              "googleMapsUri": "https://www.google.com/maps/reviews/75a95dd8ebd:0xb1e9679abc80b8db"
            }
          }
        },
        {
          "businessAvailabilityAttributesJustification": {
            "dineIn": true
          }
        }
      ]
    },
    . . .
  ]
}

راهنمای پیاده سازی برای موارد استفاده از خودرو

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

  • بیش از 3 خط نیست
  • 120 کاراکتر یا 24 کلمه یا کمتر
  • حداقل اندازه جلو 24dp

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

اسناد

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

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

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

در همه موارد، انتساب باید از حروف جمله استفاده کند. منبع و نشان‌واره Google باید با تمام استانداردهای رنگ، سبک و تایپ مطابقت داشته باشد. برای اطلاعات بیشتر در مورد این استانداردها، به API سیاست‌های مکان‌ها (جدید) مراجعه کنید.

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

در این مورد، انتساب هوش مصنوعی تولیدی می‌تواند به تنهایی در بالا یا پایین خلاصه نمایش داده شود، با تکیه بر انتساب Google از محتوا در جاهای دیگر.

برای انتساب، از متن "Summarized by AI" همانطور که در این تصویر نشان داده شده است استفاده کنید:

برای انتساب، از متن خلاصه شده توسط هوش مصنوعی استفاده کنید.

خلاصه هوش مصنوعی مولد به صورت مجزا نمایش داده می شود

هنگامی که یک خلاصه هوش مصنوعی تولیدی جدا از هر محتوای دیگری از Google Maps ظاهر می‌شود، باید هر دو انتساب هوش مصنوعی تولیدی و انتساب به Google را که با یک interpunct از هم جدا شده‌اند، داشته باشد. برای انتساب، از متن "Summarized by AI" و لوگوی Google همانطور که در این تصویر نشان داده شده است استفاده کنید:

برای خلاصه نمایش داده شده به صورت مجزا، انتساب هوش مصنوعی تولیدی و انتساب Google با یک interpunct جدا شده است.

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

هنگام تکرار یک نمای کلی خلاصه مکان مولد هوش مصنوعی در لیستی از مکان‌ها، جایی که همه:

  • محتوای فهرست به گوگل نسبت داده می شود
  • خلاصه های نشان داده شده توسط هوش مصنوعی تولید شده است
  • محتوا از Google در دسترس است

انتساب باید در بالا یا پایین لیست در یک خط نمایش داده شود. انتساب هوش مصنوعی تراز چپ و انتساب Google تراز راست است:

برای یک لیست، انتساب را در بالا یا پایین لیست در یک خط نشان دهید.

اگر خلاصه‌های توصیفی مولد هوش مصنوعی به شکل طولانی‌تر در فهرستی استفاده می‌شود، هر خلاصه باید دارای انتساب هوش مصنوعی باشد ("خلاصه شده توسط AI" با نماد/دکمه اطلاعات).

اطلاعات مربوط به خلاصه هوش مصنوعی تولیدی را در یک گفتگو نمایش دهید

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

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

برای خلاصه مکان های تولیدی، نمایش دهید:

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

به عنوان مثال:

اطلاعات مربوط به خلاصه هوش مصنوعی تولیدی را در یک گفتگو نمایش دهید.

برای خلاصه های منطقه تولیدی، نمایش دهید:

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

انتساب خلاصه منطقه را نمایش دهید.