science این محصول یا ویژگی در پیش نمایش (قبل از GA) است. محصولات و ویژگیهای Pre-GA ممکن است پشتیبانی محدودی داشته باشند، و تغییرات در محصولات و ویژگیهای pre-GA ممکن است با سایر نسخههای pre-GA سازگار نباشد. پیشنهادات قبل از GA تحت پوشش
شرایط خاص سرویس پلتفرم Google Maps هستند. برای اطلاعات بیشتر، به
توضیحات مرحله راه اندازی مراجعه کنید. برای آزمایش Places Insights
ثبت نام کنید !
Places Insights را تنظیم کنید
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
در نسخه پیشنمایش، Places Insights دادههای خاص شهر را در اتاقهای تمیز داده BigQuery برای کشورهای هدف ارائه میکند. اتاقهای تمیز دادهها محیطی با امنیت بالا فراهم میکنند که در آن چندین طرف میتوانند داراییهای داده خود را بدون جابجایی یا افشای دادههای زیربنایی به اشتراک بگذارند، بپیوندند و تجزیه و تحلیل کنند.
قبل از اینکه بتوانید پرس و جوهای SQL را بر اساس داده ها در اتاق تمیز بنویسید، ابتدا باید برای دسترسی به محصول Places Insights ثبت نام کنید . هنگامی که حساب شما وارد شد، می توانید در اتاق تمیز کشور مورد نظر خود مشترک شوید .
پیش نیازها
برای دسترسی به دادههای Places Insights در اتاق تمیز، باید:
برای آزمایش Places Insights ثبت نام کنید .
یک حساب Google Cloud داشته باشید.
اگر حساب ندارید، روی دکمه شروع که به یک تجربه راهاندازی تعاملی در کنسول Cloud برای کاربران جدید پیوند میدهد، کلیک کنید:
شروع کنید
BigQuery API را فعال کنید. برای دستورالعملهای فعال کردن BigQuery و برای آموزش استفاده از BigQuery، به جستجوی مجموعه داده عمومی با کنسول Google Cloud مراجعه کنید.
Analytics Hub API را فعال کنید.
مطمئن شوید که حساب شما دارای نقشهای مشترک Analytics Hub ( roles/analyticshub.subscriber
) و Analytics Hub Subscriber Owner ( roles/analyticshub.subscriptionOwner
) برای انجام وظایف مشترک در اتاقهای تمیز داده است.
مطمئن شوید که حساب شما دارای نقش BigQuery User ( roles/bigquery.user
) برای ایجاد مجموعه داده است.
برای اطلاعات بیشتر، به مجوزهای مشترک اضافی مراجعه کنید.
در اتاق تمیز داده مشترک شوید
دادههای Places Insights برای شهرها و کشورهای فهرستشده در جدول زیر موجود است. هر شهر و کشور اتاق تمیز داده مخصوص به خود را دارد که باید به صورت جداگانه در آن مشترک شوید.
برای اشتراک در اتاق تمیز:
پیوند اشتراک برای شهر مورد نظر را از جدول زیر انتخاب کنید.
یک گفتگو برای آن کشور در کنسول Google Cloud باز می شود. به عنوان مثال برای اتاق تمیز نیویورک، ایالات متحده (ایالات متحده):

دکمه اشتراک را در گفتگو انتخاب کنید.
پس از تکمیل، اشتراک جدول در پانل BigQuery Explorer در کنسول Google Cloud ظاهر می شود. در پرس و جوهای SQL خود، از نام جدول نشان داده شده در زیر برای دسترسی به داده ها استفاده کنید.

اتاق های تمیز موجود
جدول زیر شهرها و کشورهای پشتیبانی شده را فهرست می کند:
شهر، کشور | لینک اشتراک | نام جدول | سیدنی، استرالیا | AU | places_insights___au___sample.places_sample |
سائوپائولو، برزیل | BR | places_insights___br___sample.places_sample |
تورنتو، کانادا | CA | places_insights___ca___sample.places_sample |
پاریس، فرانسه | FR | places_insights___fr___sample.places_sample |
برلین، آلمان | DE | places_insights___de___sample.places_sample |
لندن، بریتانیای کبیر | گیگابایت | places_insights___gb___sample.places_sample |
بمبئی، هند | در | places_insights___in___sample.places_sample |
جاکارتا، اندونزی | شناسه | places_insights___id___sample.places_sample |
رم، ایتالیا | IT | places_insights___it___sample.places_sample |
توکیو، ژاپن | JP | places_insights___jp___sample.places_sample |
مکزیکو سیتی، مکزیک | MX | places_insights___mx___sample.places_sample |
مادرید، اسپانیا | ES | places_insights___es___sample.places_sample |
زوریخ، سوئیس | CH | places_insights___ch___sample.places_sample |
شهر نیویورک، ایالات متحده آمریکا | ایالات متحده | places_insights___us___sample.places_sample places_insights___us___sample.brands |
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-22 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-22 بهوقت ساعت هماهنگ جهانی."],[],[],null,["In the Preview release, Places Insights provides city-specific data in BigQuery\n[data clean rooms](https://cloud.google.com/bigquery/docs/data-clean-rooms) for\nthe target countries. Data clean rooms provide a security-enhanced environment\nin which multiple parties can share, join, and analyze their data assets without\nmoving or revealing the underlying data.\n\nBefore you can write SQL queries against the data in a clean room, you must\nfirst [sign up](https://docs.google.com/forms/d/e/1FAIpQLSetyVSIJc2U4C8rn7Z2olWhK9MEbD_YPadqHuPO3SE-yL21yg/viewform)\nto get access to the Places Insights product. Once your account\nhas been onboarded, you will be able to **subscribe** to the clean room for your\ntarget country.\n\nPrerequisites\n\nTo access the Places Insights data in a clean room, you must:\n\n1. [Sign up](https://docs.google.com/forms/d/e/1FAIpQLSetyVSIJc2U4C8rn7Z2olWhK9MEbD_YPadqHuPO3SE-yL21yg/viewform)\n to test Places Insights.\n\n2. Have a [Google Cloud](https://cloud.google.com/) account.\n\n If you don't have an account, click the **Get Started** button that links to\n an interactive setup experience in the Cloud console for new\n users:\n\n [Get Started](https://console.cloud.google.com/google/maps-apis/start?utm_source=Docs_GS_Button&ref=https://developers.google.com/maps/&utm_content=Docs_Central)\n3. Enable the BigQuery API. For instructions on enabling BigQuery and for a\n tutorial on using BigQuery, see [Query a public dataset with the Google Cloud console](https://cloud.google.com/bigquery/docs/quickstarts/query-public-dataset-console).\n\n4. Enable the [Analytics Hub API](https://console.cloud.google.com/apis/api/analyticshub.googleapis.com/metrics).\n\n5. Ensure that your account has the [Analytics Hub Subscriber](https://cloud.google.com/bigquery/docs/analytics-hub-grant-roles#ah-subscriber-role)\n (`roles/analyticshub.subscriber`) and [Analytics Hub Subscription\n Owner](https://cloud.google.com/bigquery/docs/analytics-hub-grant-roles#ah-subscription-owner-role)\n (`roles/analyticshub.subscriptionOwner`) roles to perform subscriber tasks\n on the data clean rooms.\n\n6. Ensure that your account has the [BigQuery User](https://cloud.google.com/bigquery/docs/access-control#bigquery.user)\n (`roles/bigquery.user`) role to create datasets.\n\n For more information, see [Additional subscriber\n permissions](https://cloud.google.com/bigquery/docs/data-clean-rooms#additional_subscriber_permissions).\n\nSubscribe to a data clean room\n\nPlaces Insights data is available for the cities and countries listed in the\n[table below](#available-clean-rooms). Each city and country has its own data\nclean room that you must subscribe to individually.\n\nTo subscribe to a clean room:\n\n1. Select the subscribe link for the city of interest from the [table\n below](#available-clean-rooms).\n\n2. A dialog opens for that country in the Google Cloud console. For example\n for the New York City, United States (US) clean room:\n\n3. Select the **Subscribe** button in the dialog.\n\n4. When complete, the table subscription appears in the BigQuery **Explorer**\n panel in the Google Cloud console. In your SQL queries, use the table name\n shown below to access the data.\n\nAvailable clean rooms\n\nThe following table lists the supported cities and countries:\n\n| City, Country | Subscribe link | Table names |\n|------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------|\n| Sydney, Australia | [AU](https://console.cloud.google.com/bigquery;cameo=analyticshub;pageName=exchange-detail;pageResource=maps-platform-analytics-hub.us.places_insights_AU_sample) | `places_insights___au___sample.places_sample` |\n| Sao Paulo, Brazil | [BR](https://console.cloud.google.com/bigquery;cameo=analyticshub;pageName=exchange-detail;pageResource=maps-platform-analytics-hub.us.places_insights_BR_sample) | `places_insights___br___sample.places_sample` |\n| Toronto, Canada | [CA](https://console.cloud.google.com/bigquery;cameo=analyticshub;pageName=exchange-detail;pageResource=maps-platform-analytics-hub.us.places_insights_CA_sample) | `places_insights___ca___sample.places_sample` |\n| Paris, France | [FR](https://console.cloud.google.com/bigquery;cameo=analyticshub;pageName=exchange-detail;pageResource=maps-platform-analytics-hub.us.places_insights_FR_sample) | `places_insights___fr___sample.places_sample` |\n| Berlin, Germany | [DE](https://console.cloud.google.com/bigquery;cameo=analyticshub;pageName=exchange-detail;pageResource=maps-platform-analytics-hub.us.places_insights_DE_sample) | `places_insights___de___sample.places_sample` |\n| London, Great Britian | [GB](https://console.cloud.google.com/bigquery;cameo=analyticshub;pageName=exchange-detail;pageResource=maps-platform-analytics-hub.us.places_insights_GB_sample) | `places_insights___gb___sample.places_sample` |\n| Mumbai, India | [IN](https://console.cloud.google.com/bigquery;cameo=analyticshub;pageName=exchange-detail;pageResource=maps-platform-analytics-hub.us.places_insights_IN_sample) | `places_insights___in___sample.places_sample` |\n| Jakarta, Indonesia | [ID](https://console.cloud.google.com/bigquery;cameo=analyticshub;pageName=exchange-detail;pageResource=maps-platform-analytics-hub.us.places_insights_ID_sample) | `places_insights___id___sample.places_sample` |\n| Rome, Italy | [IT](https://console.cloud.google.com/bigquery;cameo=analyticshub;pageName=exchange-detail;pageResource=maps-platform-analytics-hub.us.places_insights_IT_sample) | `places_insights___it___sample.places_sample` |\n| Tokyo, Japan | [JP](https://console.cloud.google.com/bigquery;cameo=analyticshub;pageName=exchange-detail;pageResource=maps-platform-analytics-hub.us.places_insights_JP_sample) | `places_insights___jp___sample.places_sample` |\n| Mexico City, Mexico | [MX](https://console.cloud.google.com/bigquery;cameo=analyticshub;pageName=exchange-detail;pageResource=maps-platform-analytics-hub.us.places_insights_MX_sample) | `places_insights___mx___sample.places_sample` |\n| Madrid, Spain | [ES](https://console.cloud.google.com/bigquery;cameo=analyticshub;pageName=exchange-detail;pageResource=maps-platform-analytics-hub.us.places_insights_ES_sample) | `places_insights___es___sample.places_sample` |\n| Zurich, Switzerland | [CH](https://console.cloud.google.com/bigquery;cameo=analyticshub;pageName=exchange-detail;pageResource=maps-platform-analytics-hub.us.places_insights_CH_sample) | `places_insights___ch___sample.places_sample` |\n| New York City, United States | [US](https://console.cloud.google.com/bigquery;cameo=analyticshub;pageName=exchange-detail;pageResource=maps-platform-analytics-hub.us.places_insights_US_sample) | `places_insights___us___sample.places_sample` `places_insights___us___sample.brands` |"]]