این نسخه از Places Insights که در تاریخ ۴ سپتامبر ۲۰۲۵ منتشر شد، شامل تغییرات زیر نسبت به نسخه اولیه است:
- از امکان عضویت در Places Insights در مکان مورد نظر شما در BigQuery پشتیبانی میکند.
مجموعه دادههای Places Insights را از اتاقهای تمیز داده به فهرستهای تبادل داده BigQuery منتقل میکند.
فیلدهای آدرس در طرح مجموعه داده، فیلدهای
idوnameرا به فیلدهای رشتهای گسسته یا آرایهای رشتهای تفکیک میکنند.
مهاجرت به فهرستها
نسخه پیشنمایش اولیه Places Insights دادهها را در اتاقهای تمیز داده BigQuery مستقر کرد. با انتشار در ۴ سپتامبر ۲۰۲۵، مجموعه دادهها را به فهرستهای BigQuery منتقل کردیم تا به شما امکان دهیم در یک منطقه خاص BigQuery در مجموعه دادهها مشترک شوید. این تغییر هیچ تاثیری بر ویژگیهای محصول و قابلیت استفاده Places Insights ندارد.
برای اینکه در یک منطقه خاص در Places Insights مشترک شوید، باید در BigQuery Sharing در فهرستهای جدید مشترک شوید. پس از اینکه در فهرستهای جدید مشترک شدید، نیازی به تغییر کوئریهای SQL خود ندارید. آنها همچنان به همان شکل عمل خواهند کرد.
کاربران جدید: اگر کاربر جدید Places Insights هستید، مراحل موجود در Setup Places Insights را دنبال کنید تا محیط توسعه خود را برای دسترسی به فهرستها پیکربندی کنید.
کاربران فعلی: برای مهاجرت به فهرستهای استفاده، مراحل زیر را دنبال کنید
مراحل مهاجرت
برای مهاجرت به فهرستها، باید:
در فهرستهای شهر و کشور انتخابی خود مشترک شوید. برای دستورالعملها، به «تنظیم بینش مکانها» مراجعه کنید.
نام مجموعه داده را در کوئریها یا توابع خود به نام مجموعه دادهای که در بالا انتخاب کردید، بهروزرسانی کنید.
اگر قبلاً از توابع استفاده میکردید، نام پروژهای که با اتاقهای تمیز داده (
maps-platform-analytics-hub) استفاده میشد را حذف کنید.کوئریها یا توابع موجود خود را طوری تغییر دهید که نام پروژه (اختیاری) و فیلدهای آدرس جدید را شامل شوند.
نام پروژه خود را هنگام ارجاع به فهرست ذکر کنید (اختیاری)
با استفاده از فهرستها، میتوانید نام پروژه خود را در پرسوجو وارد کنید. اگر نام پروژه را مشخص نکنید، پرسوجوی شما بهطور پیشفرض به پروژه فعال ارجاع داده میشود.
اگر مجموعه دادههایی با نام یکسان در پروژههای مختلف دارید یا اگر در حال پرسوجو از جدولی خارج از پروژه فعال هستید، میتوانید نام پروژه خود را نیز ذکر کنید.
مثال کوئری بهروزرسانیشده با نام پروژه و مجموعه داده
این کوئری شامل نام پروژه است و از نام مجموعه داده my_dataset_name استفاده میکند:
SELECT WITH AGGREGATION_THRESHOLD
COUNT(*) AS count
FROM `PROJECT_NAME.my_dataset_name.places`
به فیلدهای آدرس جدید مهاجرت کنید
در نسخه اولیه Places Insights، طرحواره مجموعه داده، یک فیلد آدرس را به عنوان یک STRUCT یا RECORD حاوی یک زیرفیلد id و name نمایش میداد. این نسخه، طرحواره را مسطح میکند تا فیلدهای جداگانه و سطح بالا را برای id و name تعریف کند. فیلدهای جدید یا رشتهای هستند یا فیلدهای آرایهای رشتهای.
برای مثال، طرحواره مربوط به مؤلفه آدرس محلی برای انتشار اولیه در زیر نشان داده شده است:
locality | STRUCT | |
locality.id | STRING | |
locality.name | STRING | |
در این نسخه، مجموعه دادهها اکنون شامل دو فیلد آرایه رشتهای سطح بالا است. به عنوان مثال، طرحواره دادههای محلی بهروزرسانیشده در زیر نشان داده شده است:
locality_ids | ARRAY<string> |
locality_names | ARRAY<string> |
به مرجع کامل طرح مراجعه کنید.
فیلدهای غیر آرایهای
در این نسخه، فیلدهای id و name اکنون برای فیلدهای آدرس غیر آرایهای، فیلدهای STRING سطح بالا هستند:
administrative_area_level_1_id | STRING |
administrative_area_level_1_name | STRING |
این قالب جدید برای همه فیلدهای موجود در فرم administrative_area_level_N اعمال میشود، که در آن N از ۱ تا ۷ است.
مثال با استفاده از فیلدهای جدید
در نسخه اولیه Places Insights، شما از فیلد administrative_area_level_1.name در یک عبارت WHERE برای فیلتر کردن نتایج استفاده کردید:
SELECT WITH AGGREGATION_THRESHOLD
COUNT(*) AS count
FROM `PROJECT_NAME.places_insights___us.places`
WHERE administrative_area_level_1.name = "New York";
با فیلدهای جدید، شما کوئری را با استفاده از فیلد administrative_area_level_1_name مینویسید:
SELECT WITH AGGREGATION_THRESHOLD
COUNT(*) AS count
FROM `PROJECT_NAME.places_insights___us.places`
WHERE administrative_area_level_1_name = "New York";