درباره داده‌ها و پُرسمان‌های «اطلاعات آماری جاها»

داده‌های «اطلاعات آماری جاها»

«اطلاعات آماری جاها» مجموعه‌داده‌های کامل و نمونه را در BigQuery ارائه می‌دهد.

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

فهرست نمونه شامل داده‌های مربوط به یکی از شهرهای برتر برای هریک از کشورهای پشتیبانی‌شده است:

آمستردام (NL) هلسینکی (FI) پلودیو (BG)
آنکارا (TR) هنگ‌کنگ (HK) الرفاع (BH)
آرکیپا (PE) جاکارتا (ID) رم (IT)
آتن (GR) جده (SA) سانتیاگو (CL)
باد گاستین (اتریش) ژوهانسبورگ (ZA) سائوپائولو (BR)
برلین (DE) کوالالامپور (MY) شارجه (AE)
برنو (جمهوری چک) لیسبون (PT) سنگاپور (SG)
بروکسل (BE) لندن (GB) استکهلم (SE)
بخارست (RO) لوسیل (QA) سیدنی (استرالیا)
بوئنوس آیرس (AR) مادرید (ES) تایپه (TW)
بوسان (KR) مانیل (PH) تل‌آویو-یافا (IL)
قاهره (EG) مدلین (CO) توکیو (JP)
چیانگ مای (TH) مکزیکوسیتی (MX) تورنتو (CA)
کپنهاگ (DK) بمبئی (IN) ورشو (PL)
کورک (IE) شهر نیویورک (ایالات متحده) ولینگتون (نیوزیلند)
دبرسن (HU) اسلو (NO) زوریخ (CH)
هانوی (VN) پاریس (FR)

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

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

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

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

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

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

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

پُرسمان داده‌های «اطلاعات آماری جاها»

«اطلاعات آماری جاها» دو روش برای پُرسمان از مجموعه‌داده‌ها ارائه می‌دهد:

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

پُرسمان‌های مستقیم

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

پرسمان‌های تابع «شمارش مکان‌ها»

توابع «شمارش جاها» می‌توانند فهرستی از «شناسه‌های جا» را برگردانند که می‌توان از آن‌ها برای جستجوی اطلاعات جاهای مجزا بااستفاده از دیگر محصولات «پلاتفرم Google Maps» مثل Places API و کیت میانای کاربر «جاها» استفاده کرد.

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

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

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

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

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

توابع Places Count پُرسمان‌های مستقیم مجموعه داده
مزایا
  • «شناسه‌های جا» را برمی‌گرداند که می‌توان از آن‌ها برای پُرسمان میاناهای برنامه‌سازی کاربردی دیگر استفاده کرد.
  • می‌تواند هر تعداد را برگرداند.
  • برای عملکرد و هزینه پردازش کم بهینه‌سازی شده است.
  • استفاده آسان. نیازی به نوشتن پُرسمان‌های پیچیده نیست.
  • پارامترهای ورودی را اعتبارسنجی می‌کند و خطایی را برمی‌گرداند که استفاده و اشکال‌زدایی را آسان‌تر می‌کند.
  • امکان اجرای پُرسمان‌های پیچیده مانند فیلتر کردن پیشرفته و پیوستن را فراهم می‌کند.
  • حداقل منطقه جستجو را اعمال نمی‌کند.
  • از توابع تجمیعی اضافی فراتر از COUNT مانند AVG، SUM، و GROUP BY پشتیبانی می‌کند.
میانا چهار تابع SQL ازپیش تعریف‌شده که اطلاعات آماری COUNT را تولید می‌کنند: شمارش تکی، شمارش براساس نوع، شمارش براساس جغرافیا، شمارش براساس سلول H3. ‫JSON_OBJECT متغیرهای مستقل را به تابع ارسال می‌کند. SQL خودتان را برای اجرای توابع تجمیعی مثل COUNT، COUNT_IF، SUM، و AVG. بنویسید. بااستفاده از JOIN، GROUP BY، WHERE، و غیره می‌توانید اطلاعات آماری بیشتری تولید کنید.
محدودیت‌ها حداقل منطقه جستجوی ۴۰٫۰ متر در ۴۰٫۰ متر (۱۶۰۰ متر۲) را اعمال می‌کند. تابع نتیجه‌ای را برمی‌گرداند حتی اگر تعداد تجمیع کمتر از ۵ باشد، به‌شرطی که حداقل منطقه جستجو رعایت شده باشد. نتایجی که تعداد آن‌ها کمتر از ۵ است از نتایج حذف می‌شوند (یعنی ردیف مستثنی می‌شود).
فیلترهای مشخصه پشتیبانی‌شده پارامترهای فیلتر تابع «تعداد مکان‌ها» از همان فیلترهای مشخصه پُرسمان مستقیم پشتیبانی می‌کنند، به‌جز:
  • جای id
  • بخش‌های نشانی
طرح کامل پشتیبانی می‌شود.