درباره داده‌ها و پرس‌وجوهای Places Insights

داده‌های بینش مکان‌ها

Places Insights مجموعه داده‌های کامل و نمونه را در BigQuery ارائه می‌دهد.

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

فهرست نمونه شامل داده‌های مربوط به یک شهر برتر برای هر یک از کشورهای پشتیبانی‌شده است: سیدنی (استرالیا)، سائوپائولو (برزیل)، تورنتو (کالیفرنیا)، زوریخ (CH)، برلین (DE)، مادرید (ES)، پاریس (FR)، لندن (UK)، جاکارتا (ID)، بمبئی (IN)، رم (IT)، توکیو (JP)، مکزیکوسیتی (MX)، نیویورک (US).

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

هر مجموعه داده کشور، فهرست مخصوص به خود را دارد که باید جداگانه در آن مشترک شوید. برای اطلاعات بیشتر در مورد اشتراک در یک فهرست، به بخش «تنظیم اطلاعات مکان‌ها» مراجعه کنید.

طرحواره‌های مجموعه داده

طرحواره مجموعه داده‌های مکان‌ها برای هر کشور از دو بخش تشکیل شده است:

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

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

طرحواره مجموعه داده برندها سه فیلد را تعریف می‌کند:

• id : شناسه برند.
• name : نام برند، مانند «هرتز» یا «چیس».
• category : دسته بندی سطح بالای برند، مانند "پمپ بنزین"، "غذا و نوشیدنی" یا "اقامتگاه".

توجه: داده‌های برندها در نسخه فعلی فقط برای ایالات متحده در دسترس است.

داده‌های بینش مکان‌های جستجو

Places Insights دو روش برای جستجوی مجموعه داده‌ها ارائه می‌دهد:

• پرس‌وجوی مستقیم از مجموعه داده‌ها با استفاده از SQL : پرس‌وجوهای استاندارد BigQuery SQL را در برابر جداول مجموعه داده‌ها اجرا کنید. این قابلیت بیشترین انعطاف‌پذیری را برای فیلترهای پیچیده، اتصال به داده‌های خودتان، تجزیه و تحلیل سفارشی و پشتیبانی از توابع تجمیع اضافی فراتر از COUNT مانند AVG ، SUM و GROUP BY فراهم می‌کند. به مستندات مراجعه کنید .
• پرس‌وجوی مجموعه داده‌ها با استفاده از توابع شمارش مکان‌ها : توابع شمارش مکان‌ها، پرس‌وجوهای SQL از پیش تعریف‌شده و بهینه‌شده‌ای هستند که مستقیماً در BigQuery اجرا می‌شوند و وظایف بازیابی داده‌های رایج را ساده می‌کنند. آن‌ها بینش‌های جزئی‌تری مانند بازگرداندن شناسه‌های مکان برای جستجوی جزئیات مربوط به مکان‌های منفرد ارائه می‌دهند. به مستندات مراجعه کنید .

پرس و جوهای مستقیم

پرس‌وجوی مستقیم داده‌ها، آستانه تجمیع را اعمال می‌کند. نتیجه فقط در صورتی برگردانده می‌شود که پرس‌وجو حداقل ۵ مکان را جمع کند. به عنوان مثال، اگر نتیجه معیار جستجوی شما تعداد ۰، ۱، ۲، ۳ یا ۴ باشد، نتیجه از پاسخ حذف می‌شود. به عنوان مثال، یک پرس‌وجو برای تعداد کل رستوران‌ها در یک منطقه مشخص، فقط در صورتی پاسخی برمی‌گرداند که تعداد کل ۵ یا بیشتر باشد، در غیر این صورت پاسخی برگردانده نمی‌شود.

نمایش داده شد تابع شمارش مکان

توابع شمارش مکان می‌توانند فهرستی از شناسه‌های مکان را برگردانند که می‌توان از آن‌ها برای جستجوی اطلاعات تک تک مکان‌ها با استفاده از سایر محصولات GMP مانند Places API و Places UI Kit استفاده کرد.

توابع شمارش مکان، آستانه تجمیع را اعمال نمی‌کنند، بلکه حداقل ناحیه جستجو را ۴۰.۰ متر در ۴۰.۰ متر (۱۶۰۰ متر ^مربع ) اعمال می‌کنند. این بدان معناست که تا زمانی که عبارت جستجوی شما بزرگتر از حداقل ناحیه جستجو باشد، همیشه نتیجه‌ای دریافت خواهید کرد، از جمله اگر ۰ مکان مطابق با عبارت شما وجود داشته باشد.

چه زمانی داده‌ها را مستقیماً جستجو کنیم و چه زمانی از توابع استفاده کنیم

اگر به تعداد نتایج پایین نیاز ندارید، اگر می‌خواهید بینشی فراتر از تعداد، مانند AVG ، SUM یا COUNTIF ، به دست آورید، یا اگر نیاز به انجام پرس‌وجوهای پیچیده‌تری مانند اتصال مجموعه داده‌ها دارید، مستقیماً از داده‌ها پرس‌وجو کنید.

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

این جدول مقایسه دقیقی از تفاوت‌های بین پرس‌وجوهای مستقیم و توابع شمارش مکان ارائه می‌دهد.

	توابع شمارش مکان	پرس‌وجوهای مستقیم از مجموعه داده‌ها
مزایا	شناسه‌های مکان را برمی‌گرداند که می‌توانند برای پرس‌وجو از APIهای دیگر استفاده شوند. می‌تواند هر تعداد را برگرداند. برای عملکرد و هزینه پردازش پایین بهینه شده است. استفاده آسان. نیازی به نوشتن کوئری‌های پیچیده نیست. پارامترهای ورودی را اعتبارسنجی می‌کند و خطایی را برمی‌گرداند که استفاده و اشکال‌زدایی آن را آسان‌تر می‌کند.	امکان پرس‌وجوهای پیچیده مانند فیلترینگ پیشرفته و اتصال‌ها را فراهم می‌کند. حداقل منطقه جستجو را اعمال نمی‌کند. از توابع تجمیعی اضافی فراتر از COUNT مانند AVG ، SUM و GROUP BY پشتیبانی می‌کند.
رابط	چهار تابع SQL از پیش تعریف شده که بینش‌های COUNT را تولید می‌کنند: شمارش تکی، شمارش به ازای هر نوع، شمارش به ازای هر جغرافیا، شمارش به ازای هر سلول H3. یک JSON_OBJECT آرگومان‌ها را به تابع ارسال می‌کند.	SQL خودتان را برای اجرای توابع تجمیع مانند COUNT ، COUNT_IF ، SUM و AVG. با استفاده از JOIN ، GROUP BY ، WHERE و موارد دیگر می‌توان بینش‌های بیشتری ایجاد کرد.
محدودیت‌ها	حداقل ناحیه جستجو را ۴۰.۰ متر در ۴۰.۰ متر (۱۶۰۰ متر ^مربع ) اعمال می‌کند. یک تابع، حتی اگر تعداد تجمع کمتر از ۵ باشد، تا زمانی که حداقل ناحیه جستجو رعایت شود، نتیجه را برمی‌گرداند.	نتایجی که تعدادشان کمتر از ۵ باشد، از نتایج حذف می‌شوند (یعنی ردیف مورد نظر حذف می‌شود).
فیلترهای ویژگی پشتیبانی شده	پارامترهای فیلتر تابع شمارش مکان، همانند فیلترهای ویژگی کوئری مستقیم پشتیبانی می‌شوند، به جز موارد زیر: id مکان اجزای آدرس ساعات کاری گزینه‌های شارژ EV برندها	طرحواره کامل پشتیبانی می‌شود.