راهنمای مهاجرت

این نسخه Places Insights در 4 سپتامبر 2025 شامل تغییرات زیر نسبت به نسخه اولیه است:

  • از امکان اشتراک در Places Insights در مکان BigQuery مورد نظر شما پشتیبانی می کند.

  • مجموعه داده‌های Places Insights را از اتاق‌های تمیز داده به فهرست‌های تبادل داده BigQuery منتقل می‌کند.

  • فیلدهای آدرس در طرح مجموعه داده، فیلدهای id و name به رشته‌های مجزا یا رشته‌های آرایه رشته‌ای جدا می‌کنند.

مهاجرت به لیست ها

انتشار اولیه پیش‌نمایش Places Insights داده‌ها را در اتاق‌های تمیز داده BigQuery مستقر کرد. با انتشار در 4 سپتامبر 2025، مجموعه داده‌ها را به فهرست‌های BigQuery منتقل کردیم تا به شما امکان دهیم در یک منطقه خاص BigQuery در مجموعه داده مشترک شوید. این تغییر تأثیری بر ویژگی‌های محصول و قابلیت استفاده Places Insights ندارد.

برای اشتراک در Places Insights در یک منطقه خاص، باید در فهرست‌های جدید در اشتراک‌گذاری BigQuery مشترک شوید. هنگامی که در لیست های جدید مشترک شدید، نیازی به تغییر پرس و جوهای SQL خود ندارید. آنها همچنان به همان صورت عمل خواهند کرد.

  • کاربران جدید: اگر کاربر جدیدی از Places Insights هستید، مراحل راه‌اندازی Places Insights را دنبال کنید تا محیط توسعه خود را برای دسترسی به فهرست‌ها پیکربندی کنید.

  • کاربران موجود: مراحل زیر را برای مهاجرت به استفاده از فهرست ها دنبال کنید

مراحل مهاجرت

برای مهاجرت به لیست ها باید:

  1. در لیست های شهر و کشور انتخابی خود مشترک شوید. برای دستورالعمل‌ها، به راه‌اندازی اطلاعات آماری مکان‌ها مراجعه کنید.

  2. نام مجموعه داده ها را در پرس و جوها یا توابع خود به نام مجموعه داده ای که در بالا انتخاب کرده اید به روز کنید.

  3. اگر قبلاً از توابع استفاده کرده‌اید، نام پروژه مورد استفاده در اتاق‌های تمیز داده ( maps-platform-analytics-hub ) را حذف کنید.

  4. درخواست ها یا توابع موجود خود را تغییر دهید تا نام پروژه شما (اختیاری) و فیلدهای آدرس جدید را شامل شود.

هنگام ارجاع به فهرست، نام پروژه خود را درج کنید (اختیاری)

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

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

نمونه درخواست به روز شده با نام پروژه و مجموعه داده

این کوئری شامل نام پروژه است و از نام مجموعه داده 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 از 1 تا 7 است.

مثال با استفاده از فیلدهای جدید

در نسخه اولیه 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";