قابلیت‌های مدل 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 : آرایه ای از حداکثر پنج بررسی که برای ارائه محتوا برای خلاصه توضیحات استفاده می شود. اگر خلاصه توضیحاتی وجود نداشته باشد، این آرایه خالی است.

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

این مثال جستجوی متن فقط خلاصه 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"
        }
      }
    },
  . . .
}

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

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

{
  "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": "Anam Qureshi",
                "uri": "https://www.google.com/maps/contrib/116859422317024657778/reviews",
                "photoUri": "https://lh3.googleusercontent.com/a-/ALV-UjWbImVTop_1dl9FTSmec0x00000000-cc-rp-mo"
              },
              "publishTime": "2023-05-09T07:24:36Z"
            },
            . . .
          ]
        }
      }
    },
    {
      "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"
        },
        . . .
}

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

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

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

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

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

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

فیلد areaSummary برای یک مکان در پاسخ حاوی آرایه ای از حداکثر چهار 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"
          ]
        }
      }
    ]
  }
}

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

این مثال درخواست جستجوی متن از هتل‌ها در 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"
              ]
            }
          }
        ]
      }
    },
    ...
  ]
}

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

پاسخ به درخواست جستجوی متن (جدید) حاوی آرایه‌ای از مکان‌ها است که با معیارهای رشته جستجوی ورودی مطابقت دارد. اکنون می توانید داده های جستجوی متنی را در پاسخ بر اساس پرس و جوی ورودی به 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": "Guillaume Riesen",
            "uri": "https://www.google.com/maps/contrib/1131462893/reviews",
            "photoUri": "https://lh3.googleusercontent.com/a-/ALVVXe4iwG_WXt1SjB1rJg=s128-c-c0x00000000-cc-rp-mo-br100"
          },
          "publishTime": "2023-04-18T02:48:02Z"
        },
        {
          "name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/reviews/ChdDSUhNMG9nS0VJQ0FnSUNKZzlhTG53RRAB",
          "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": "Paul Sacks",
            "uri": "https://www.google.com/maps/contrib/1106671734435/reviews",
            "photoUri": "https://lh3.googleusercontent.com/a/ACg8ocIAGguhz-EccsS9sVQ=s128-c-c0x00000000-cc-rp-mo-ba4-br100"
          },
          "publishTime": "2023-07-03T16:51:49Z"
        },
        . . .
      ],
      "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/113209927655010465422",
              "photoUri": "//lh3.googleusercontent.com/a-/ALV-UjV_8hbrtgycOLDgOqPRYhzJ0EJlBFyKo9OrmacOo3C5YvrtR4Q=s100-p-k-no-mo"
            }
          ]
        },
        {
          "name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/photos/AUGGfZkJ4MMlLikE2EyP-b13GeFZ9YNzyjkjDMD15gyobIQtIYg1GFPy3BdQHAaA3iNwhk24vK212hZo",
          "widthPx": 960,
          "heightPx": 720,
          "authorAttributions": [
            {
              "displayName": "Toast"
            }
          ]
        },
        . . .
      ],
      "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": "Harpal Kochar",
                "uri": "https://www.google.com/maps/contrib/1166232959/reviews",
                "photoUri": "https://lh3.googleusercoEnzB1zdrNbR00000-cc-rp-mo"
              },
              "publishTime": "2023-06-18T06:12:41Z"
            }
          }
        },
        {
          "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" با نماد/دکمه اطلاعات).

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

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

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

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

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

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

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

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

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

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

،

قابلیت‌های مدل 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 : آرایه ای از حداکثر پنج بررسی که برای ارائه محتوا برای خلاصه توضیحات استفاده می شود. اگر خلاصه توضیحاتی وجود نداشته باشد، این آرایه خالی است.

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

این مثال جستجوی متن فقط خلاصه 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"
        }
      }
    },
  . . .
}

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

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

{
  "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": "Anam Qureshi",
                "uri": "https://www.google.com/maps/contrib/116859422317024657778/reviews",
                "photoUri": "https://lh3.googleusercontent.com/a-/ALV-UjWbImVTop_1dl9FTSmec0x00000000-cc-rp-mo"
              },
              "publishTime": "2023-05-09T07:24:36Z"
            },
            . . .
          ]
        }
      }
    },
    {
      "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"
        },
        . . .
}

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

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

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

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

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

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

فیلد areaSummary برای یک مکان در پاسخ حاوی آرایه ای از حداکثر چهار 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"
          ]
        }
      }
    ]
  }
}

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

این مثال درخواست جستجوی متن از هتل‌ها در 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"
              ]
            }
          }
        ]
      }
    },
    ...
  ]
}

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

پاسخ به درخواست جستجوی متن (جدید) حاوی آرایه‌ای از مکان‌ها است که با معیارهای رشته جستجوی ورودی مطابقت دارد. اکنون می توانید داده های جستجوی متنی را در پاسخ بر اساس پرس و جوی ورودی به 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": "Guillaume Riesen",
            "uri": "https://www.google.com/maps/contrib/1131462893/reviews",
            "photoUri": "https://lh3.googleusercontent.com/a-/ALVVXe4iwG_WXt1SjB1rJg=s128-c-c0x00000000-cc-rp-mo-br100"
          },
          "publishTime": "2023-04-18T02:48:02Z"
        },
        {
          "name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/reviews/ChdDSUhNMG9nS0VJQ0FnSUNKZzlhTG53RRAB",
          "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": "Paul Sacks",
            "uri": "https://www.google.com/maps/contrib/1106671734435/reviews",
            "photoUri": "https://lh3.googleusercontent.com/a/ACg8ocIAGguhz-EccsS9sVQ=s128-c-c0x00000000-cc-rp-mo-ba4-br100"
          },
          "publishTime": "2023-07-03T16:51:49Z"
        },
        . . .
      ],
      "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/113209927655010465422",
              "photoUri": "//lh3.googleusercontent.com/a-/ALV-UjV_8hbrtgycOLDgOqPRYhzJ0EJlBFyKo9OrmacOo3C5YvrtR4Q=s100-p-k-no-mo"
            }
          ]
        },
        {
          "name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/photos/AUGGfZkJ4MMlLikE2EyP-b13GeFZ9YNzyjkjDMD15gyobIQtIYg1GFPy3BdQHAaA3iNwhk24vK212hZo",
          "widthPx": 960,
          "heightPx": 720,
          "authorAttributions": [
            {
              "displayName": "Toast"
            }
          ]
        },
        . . .
      ],
      "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": "Harpal Kochar",
                "uri": "https://www.google.com/maps/contrib/1166232959/reviews",
                "photoUri": "https://lh3.googleusercoEnzB1zdrNbR00000-cc-rp-mo"
              },
              "publishTime": "2023-06-18T06:12:41Z"
            }
          }
        },
        {
          "businessAvailabilityAttributesJustification": {
            "dineIn": true
          }
        }
      ]
    },
    . . .
  ]
}

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

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

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

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

اسناد

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

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

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

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

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

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

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

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

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

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

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

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

هنگام تکرار یک نمای کلی خلاصه AI Place در لیستی از مکان ها ، که در آن همه:

  • محتوای لیست به Google نسبت داده می شود
  • خلاصه های نشان داده شده AI تولید می شوند
  • محتوا از Google در دسترس است

انتساب باید در بالا یا زیر لیست در یک خط واحد نمایش داده شود. انتساب AI با هم تراز شده و انتساب Google به سمت راست تراز شده است:

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

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

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

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

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

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

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

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

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

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

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

انتساب خلاصه منطقه.

،

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

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

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

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

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

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

ویژگی های جدید AI-Powered به مکان های API (جدید) اضافه شده است

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

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

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

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

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

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

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

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

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

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

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

نسل خلاصه مکان و منطقه

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

جمینی چیست؟

برای کسب اطلاعات در مورد مدل جمینی ، به سؤالات متداول جمینی مراجعه کنید.

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

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

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

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

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

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

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

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

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

  • جستجوی متن و جستجوی مجاور : places.generativeSummary

قسمت generativeSummary شامل زمینه های زیر است:

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

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

این مثال جستجوی متن فقط overview برای رستوران های گیاهی تند در Mountain View ، کالیفرنیا را برمی گرداند:

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 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"
        }
      }
    },
  . . .
}

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

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

{
  "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": "Anam Qureshi",
                "uri": "https://www.google.com/maps/contrib/116859422317024657778/reviews",
                "photoUri": "https://lh3.googleusercontent.com/a-/ALV-UjWbImVTop_1dl9FTSmec0x00000000-cc-rp-mo"
              },
              "publishTime": "2023-05-09T07:24:36Z"
            },
            . . .
          ]
        }
      }
    },
    {
      "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"
        },
        . . .
}

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

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

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

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

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

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

میدان areaSummary برای مکانی در پاسخ حاوی مجموعه ای از حداکثر چهار contentBlocks است. موضوع برای هر بلوک بر اساس نوع مکان است:

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

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

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

این مثال جزئیات درخواست درخواست خلاصه منطقه را برای یک ایستگاه شارژ خاص EV در Mountain View ، مشخص شده توسط محل ID 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 شامل خلاصه ای برای آن موضوع ، از جمله کد زبان است.

  • Array 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"
          ]
        }
      }
    ]
  }
}

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

این مثال درخواست جستجوی متن از هتل ها در 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"
              ]
            }
          }
        ]
      }
    },
    ...
  ]
}

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

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

برای پشتیبانی از خلاصه های متنی ، پاسخ از جستجوی متن (NEW) حاوی آرایه جدیدی است که به نام 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": "Guillaume Riesen",
            "uri": "https://www.google.com/maps/contrib/1131462893/reviews",
            "photoUri": "https://lh3.googleusercontent.com/a-/ALVVXe4iwG_WXt1SjB1rJg=s128-c-c0x00000000-cc-rp-mo-br100"
          },
          "publishTime": "2023-04-18T02:48:02Z"
        },
        {
          "name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/reviews/ChdDSUhNMG9nS0VJQ0FnSUNKZzlhTG53RRAB",
          "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": "Paul Sacks",
            "uri": "https://www.google.com/maps/contrib/1106671734435/reviews",
            "photoUri": "https://lh3.googleusercontent.com/a/ACg8ocIAGguhz-EccsS9sVQ=s128-c-c0x00000000-cc-rp-mo-ba4-br100"
          },
          "publishTime": "2023-07-03T16:51:49Z"
        },
        . . .
      ],
      "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/113209927655010465422",
              "photoUri": "//lh3.googleusercontent.com/a-/ALV-UjV_8hbrtgycOLDgOqPRYhzJ0EJlBFyKo9OrmacOo3C5YvrtR4Q=s100-p-k-no-mo"
            }
          ]
        },
        {
          "name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/photos/AUGGfZkJ4MMlLikE2EyP-b13GeFZ9YNzyjkjDMD15gyobIQtIYg1GFPy3BdQHAaA3iNwhk24vK212hZo",
          "widthPx": 960,
          "heightPx": 720,
          "authorAttributions": [
            {
              "displayName": "Toast"
            }
          ]
        },
        . . .
      ],
      "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": "Harpal Kochar",
                "uri": "https://www.google.com/maps/contrib/1166232959/reviews",
                "photoUri": "https://lh3.googleusercoEnzB1zdrNbR00000-cc-rp-mo"
              },
              "publishTime": "2023-06-18T06:12:41Z"
            }
          }
        },
        {
          "businessAvailabilityAttributesJustification": {
            "dineIn": true
          }
        }
      ]
    },
    . . .
  ]
}

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

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

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

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

اسناد

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

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

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

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

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

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

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

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

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

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

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

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

هنگام تکرار یک نمای کلی خلاصه AI Place در لیستی از مکان ها ، که در آن همه:

  • محتوای لیست به Google نسبت داده می شود
  • خلاصه های نشان داده شده AI تولید می شوند
  • محتوا از Google در دسترس است

انتساب باید در بالا یا زیر لیست در یک خط واحد نمایش داده شود. انتساب AI با هم تراز شده و انتساب Google به سمت راست تراز شده است:

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

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

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

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

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

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

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

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

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

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

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

انتساب خلاصه منطقه.

،

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

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

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

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

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

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

ویژگی های جدید AI-Powered به مکان های API (جدید) اضافه شده است

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

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

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

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

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

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

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

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

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

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

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

نسل خلاصه مکان و منطقه

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

جمینی چیست؟

برای کسب اطلاعات در مورد مدل جمینی ، به سؤالات متداول جمینی مراجعه کنید.

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

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

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

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

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

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

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

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

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

  • جستجوی متن و جستجوی مجاور : places.generativeSummary

قسمت generativeSummary شامل زمینه های زیر است:

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

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

این مثال جستجوی متن فقط overview برای رستوران های گیاهی تند در Mountain View ، کالیفرنیا را برمی گرداند:

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 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"
        }
      }
    },
  . . .
}

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

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

{
  "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": "Anam Qureshi",
                "uri": "https://www.google.com/maps/contrib/116859422317024657778/reviews",
                "photoUri": "https://lh3.googleusercontent.com/a-/ALV-UjWbImVTop_1dl9FTSmec0x00000000-cc-rp-mo"
              },
              "publishTime": "2023-05-09T07:24:36Z"
            },
            . . .
          ]
        }
      }
    },
    {
      "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"
        },
        . . .
}

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

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

به عنوان مثال ، شما به دنبال رزرو هتل در یک شهر جدید هستید و در حالی که می توانید هتلی را پیدا کنید که نیازهای شما را برآورده کند ، همچنین می خواهید اطلاعات بیشتری در مورد منطقه اطراف هتل کسب کنید. Rather than look at a map of the surrounding area, and then having to investigate each place on the map, you can instead generate an area summary for the hotel.

Area summaries are supported by Place Details (New) , Text Search (New) , and Nearby Search (New) .

To include the area summary in the response, include in the field mask of the request:

  • areaSummary (Place Details)
  • places.areaSummary (Text Search and Nearby Search).

The areaSummary field for a place in the response contains an array of up to four contentBlocks . The topic for each block is based on the type of the place:

  • For an EV charging station, defined as a place of type electric_vehicle_charging_station , the topic blocks include: "overview" , "coffee" , "restaurant" , and "store" .

  • For a place with a type defined by the Lodging category, and the specific place types geocode and premise , the topic blocks include: "overview" , "activity" , "restaurant" , and "store" .

Example request for area summary of an EV charging station

This example Place Details request returns the area summary for a specific EV charging station in Mountain View, identified by the place ID 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

The response contains the areaSummary field, including the contentBlocks array:

  • The topic field specifies the type of content block. Because the place in this example is an EV charging station, the four content blocks are "overview" , "coffee" , "restaurant" , and "store" .

  • The content field includes the summary for that topic, including the language code.

  • The references array specifies the place resource names, in the form places/ PLACE_ID , used to provide content for the content block.

{
  "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"
          ]
        }
      }
    ]
  }
}

Example request for area summary for a hotel

This example Text Search request requests hotels in 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

The response contains the areaSummary field, including the contentBlocks array. The response for places of type hotel contains content blocks for the topics "overview" , "activity" , "restaurant" , and "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"
              ]
            }
          }
        ]
      }
    },
    ...
  ]
}

Request contextual search results

The response to a Text Search (New) request contains an array of places that match the criteria of the input search string. Now you can request contextual search data in the response based on the input query to the API.

To support contextual summaries, the response from Text Search (New) contains a new array named contextualContents at the same level as the places array in the response:

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

Each element in the contextualContents array, of type ContextualContent , is at the corresponding array location as the place in the places array. That is, the element at contextualContents[0] corresponds to the place at places[0] .

Each array element contains the following array fields:

  • contextualContents.reviews : An array of up to three reviews .
  • contextualContents.photos : An array of up to five photos .
  • contextualContents.justifications : An array of justifications for the place, including:

    • reviewJustification : Highlight a section of a user review that could be of interest to an end user.
    • businessAvailabilityAttributesJustification : Includes attributes for a business that could be of interest to an end user.

To include the contextual search results in the response, include contextualContents in the field mask of the Text Search (New) request:

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

The response contains the contextualContents array for each place in the response:

{
  "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": "Guillaume Riesen",
            "uri": "https://www.google.com/maps/contrib/1131462893/reviews",
            "photoUri": "https://lh3.googleusercontent.com/a-/ALVVXe4iwG_WXt1SjB1rJg=s128-c-c0x00000000-cc-rp-mo-br100"
          },
          "publishTime": "2023-04-18T02:48:02Z"
        },
        {
          "name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/reviews/ChdDSUhNMG9nS0VJQ0FnSUNKZzlhTG53RRAB",
          "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": "Paul Sacks",
            "uri": "https://www.google.com/maps/contrib/1106671734435/reviews",
            "photoUri": "https://lh3.googleusercontent.com/a/ACg8ocIAGguhz-EccsS9sVQ=s128-c-c0x00000000-cc-rp-mo-ba4-br100"
          },
          "publishTime": "2023-07-03T16:51:49Z"
        },
        . . .
      ],
      "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/113209927655010465422",
              "photoUri": "//lh3.googleusercontent.com/a-/ALV-UjV_8hbrtgycOLDgOqPRYhzJ0EJlBFyKo9OrmacOo3C5YvrtR4Q=s100-p-k-no-mo"
            }
          ]
        },
        {
          "name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/photos/AUGGfZkJ4MMlLikE2EyP-b13GeFZ9YNzyjkjDMD15gyobIQtIYg1GFPy3BdQHAaA3iNwhk24vK212hZo",
          "widthPx": 960,
          "heightPx": 720,
          "authorAttributions": [
            {
              "displayName": "Toast"
            }
          ]
        },
        . . .
      ],
      "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": "Harpal Kochar",
                "uri": "https://www.google.com/maps/contrib/1166232959/reviews",
                "photoUri": "https://lh3.googleusercoEnzB1zdrNbR00000-cc-rp-mo"
              },
              "publishTime": "2023-06-18T06:12:41Z"
            }
          }
        },
        {
          "businessAvailabilityAttributesJustification": {
            "dineIn": true
          }
        }
      ]
    },
    . . .
  ]
}

Implementation guidance for automotive use cases

For driver safety, Google recommends rendering generative AI summaries in parked mode for automotive experiences. If rendering summaries in driving mode, on-screen information should be simple, clear, and concise to ensure that the driver's attention returns quickly to the road.

  • No more than 3 lines
  • 120 characters or 24 words or less
  • Minimum front size of 24dp

Especially in automotive contexts, it's the developer's responsibility to render generative AI summaries in ways that are safe and compliant with all local laws and regulations.

اسناد

When you display reviews, photos, and generative AI summaries in your app, including both place and area summaries, you must ensure that you also display the required attributions.

Display attributions for generative summaries

When you display generative AI summaries in your app, including place and area summaries, you must also display the necessary attributions. This section describes how to display attributions based on how you display the generative AI summaries in your app.

In all cases, the attribution must use sentence casing. The attribution and Google logo must conform to all color, style and typeface standards. For more information on these standards, see Policies for Places API (New) .

Generative AI summary displayed in the context of other Google data

In this case, the generative AI attribution can be displayed alone above or below the summary, relying on Google attribution of the content elsewhere.

For the attribution, use the text "Summarized by AI" as shown in this image:

For the attribution, use the text Summarized by AI.

Generative AI summary displayed in isolation

When a generative AI summary appears in isolation of any other content from Google Maps, it must include both generative AI attribution and attribution to Google separated by an interpunct. For the attribution, use the text "Summarized by AI" and the Google logo as shown in this image:

For summary displayed in isolation, include generative AI attribution and
  Google attribution separated by an interpunct.

Generative AI summary repeated in a list

When repeating a generative AI place summary overview in a list of places, where all:

  • List content is attributed to Google
  • Summaries shown are AI generated
  • Content is available from Google

The attribution should be displayed above or below the list on a single line. The AI attribution is left-aligned and the Google attribution is right-aligned:

For a list, display attribution above or below the list on a single line.

If longer form generative AI description summaries are used in a list, each summary must have AI attribution ("Summarized by AI" with the info icon/button).

Display information about a generative AI summary in a dialog

Along with a generative AI summary, you must make a dialog available to end users that displays information about the summary, and a link to report issues. When using a generative AI description summary , you must include information about sources of the summary, called the references .

Enable access to this dialog by including an info icon (as an interactivity affordance) in conjunction with AI attribution (as depicted in the above examples) and making the AI attribution area and icon respond to a press/click.

For generative place summaries, display:

درباره AI place summaries are generated from Google reviews and other data.
گزارش یک مشکل To report an issue to Google about the content of a summary, follow this link.
مراجع Source reviews

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

Display information about a generative AI summary in a dialog.

For generative area summaries, display:

درباره AI area summaries are generated from Google reviews and local data.
گزارش یک مشکل To report an issue to Google about the content of a summary, follow this link.

Display area summary attribution.