اضافه کردن فایل json نقشه استان‌های ایران به متابیس


ارائه شده در تیم محصول فروشگاه دیجی شهر
ارائه شده در تیم محصول فروشگاه دیجی شهر


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



چرا باید از فایل سفارشی IranGeo.json استفاده کنیم؟

نقشه‌برداری منطقه‌ای ایران معمولاً به مرزهای دقیقی نیاز دارد که در تنظیمات پیش‌فرض متابیس موجود نیست. اضافه کردن فایل IranGeo.json مزایای زیر را ارائه می‌دهد:

  • نمایش دقیق مناطق ایران.
  • بهبود تجسم داده‌ها با توجه به داده‌های مکانی دیتابیس.
  • تصمیم‌گیری بهتر با هماهنگی داده‌ها و جغرافیای منطقه‌ای.

قبل از شروع توضیحات نحوه افزودن فایل، موارد زیر لازم به ذکر است:

  • منظور از نقشه منطقه‌ای، حالتی از نمایش داده‌ها مرتبط با طول و عرض جغرافیایی است که در هر منطقه (متریک مورد نظر) بصورت شاخص رنگی نمایش داده می‌شود که در این جا هر منطقه، استان‌های ایران و شاخص، هر متریک عددی می‌تواند باشد.

نمونه‌ای از نقشه منطقه‌ای ایران که با کمک فایل Json طول و عرض جغرافیایی استان‌ها ایران درست شده است.

نمونه‌ای از نقشه منطقه‌ای ایران که با کمک فایل Json طول و عرض جغرافیایی استان‌ها ایران درست شده است.
نمونه‌ای از نقشه منطقه‌ای ایران که با کمک فایل Json طول و عرض جغرافیایی استان‌ها ایران درست شده است.



  • بصورت پیش‌فرض هر نقطه در نقشه متابیس، با داشتن دیتا طول و عرض جغرافیایی قابل نظیر کردن است که توزیع در هر نقطه از نقشه را می‌تواند نشان دهد. این نوع نقشه متفاوت از نقشه منطقه‌ای است. این قابلیت بصورت پیش‌فرض در دسترس است و موضوع صحبت این پست نیست.
نمونه‌ای از نقشه پیش‌فرض متابیس که هر داده را در در هر طول و عرض نشان می‌دهد.
نمونه‌ای از نقشه پیش‌فرض متابیس که هر داده را در در هر طول و عرض نشان می‌دهد.
  • فایل نقاط طول عرض جغرافیایی استان‌ها ارائه شده، از دقت حداکثری برخوردار است بگونه‌ای که اگر استانی حاوی جزیره باشد، آن جزایر نیز در نظر گرفته شده است.
  • در طی مراحل تنظیم فایل نقشه، نیاز هست مشخصه هر منطقه در فایل json و آنچه در دیتا داریم یکسان باشد. منظور از مشخصه عبارتی است که استان‌ها را از هم متمایز می‌کند. مانند نام استان‌ها. در غیر اینصورت مناطقی که مغایرت داشته باشند با رنگ طوسی نمایش داده می‌شوند. علت این موضوع این است که عبارت متمایز کننده در دیتا و عبارت متمایز کننده در اطلاعات منطقه‌ای فایل json باید یکسان باشند تا بتواند اطلاعات بصورت صحیح جانمایی شوند.

چگونه از فایل سفارشی IranGeo.json استفاده کنیم؟

در این پست بصورت گام به گام نحوه اتصال فایل json نقشه استان‌ها ایران بیان می‌شود.

مرحله۱:

برای این امر نیاز است نقش ادمین داشته باشیم. ابتدا وارد بخش ادمین متابیس شده و به بخش Maps می‌رویم.

صفحه ادمین متابیس (نیازمند سطح دسترسی ادمین)
صفحه ادمین متابیس (نیازمند سطح دسترسی ادمین)


مرحله۲:

در این صفحه دو منبع نقشه قابل تنظیم است. منبع اول نقشه عادی متابیس می‌باشد که بصورت پیش‌فرض آنچه در place holder مشخص است می‌باشد. اگر این لینک مورد تأیید نیست می‌توان با لینک نقشه دلخواه جایگزین کرد. لازم به ذکر است که این نقشه جدا از بحث نقشه منطقه‌ای این پست است.

نقشه منطقی ایران از دکمه آبی سمت راست مانند شکل زیر، قابل اضافه کردن است. می‌توان چند لینک نقشه منطقه‌ای ثبت کرد.

صفحه تنظیمات نقشه پنل ادمین متابیس
صفحه تنظیمات نقشه پنل ادمین متابیس


مرحله۳:

بعد از زدن دکمه آبی رنگ افزودن نقشه منطقه‌ای در مرحله۲، مودالی مانند شکل زیر باز می‌شود. در این قسمت اطلاعات لازم وارد شده و در نهایت نقشه منطقه‌ای ثبت می‌شود.

مودال ثبت اطلاعات نقشه منطقه‌ای پنل ادمین متابیس


مودال ثبت اطلاعات نقشه منطقه‌ای پنل ادمین متابیس
مودال ثبت اطلاعات نقشه منطقه‌ای پنل ادمین متابیس
لینک فایل IranGeo.json استان‌های ایران
لینک فایل Province_City_Iran.xlsx استان‌های ایران

لینک‌های بالا بصورت آزاد برای عموم قابل استفاده است. فایل json برای اضافه کردن به متابیس تهییه شده است. فایل xlsx جزئیات استان و شهر هست که در کنار قسمت عمومی کدپستی شهرها، مختصات جغرافیایی مرکز هر شهر، اولویت نیز برای هر ردیف مشخص شده است. این اولویت به میزان جمعیت هر شهر بستگی دارد که کاربرد آن در استفاده از این لیست نمود دارد، که برای کاربر تجربه پیدا کردن راحت‌تر شهرها را به همراه دارد.

لیست مختصات استان‌های ایران، که در فایل بالا وجود دارد، به قرار زیر است:

  1. آذربایجان غربی
  2. آذربایجان شرقی
  3. اردبیل
  4. گیلان
  5. کردستان
  6. کرمانشاه
  7. ایلام
  8. خوزستان
  9. خراسان شمالی
  10. گلستان
  11. خراسان رضوی
  12. خراسان جنوبی
  13. سیستان و بلوچستان
  14. بوشهر
  15. هرمزگان
  16. مازندران
  17. سمنان
  18. زنجان
  19. قزوین
  20. مرکزی
  21. اصفهان
  22. چهارمحال و بختیاری
  23. کهگیلویه و بویراحمد
  24. فارس
  25. کرمان
  26. همدان
  27. لرستان
  28. یزد
  29. قم
  30. تهران
  31. البرز


مرحله۴:

در فیلد اول مانند شکل زیر می‌توان اسم دلخواه برای نقشه منطقه‌ای در نظر گرفت. سپس لازم است لینک فایل json شخصی سازی شده را در جایگاه مرتبط، مطابق شکل وارد کرد. این لینک حاوی فایل json می‌باشد که بعد از ثبت لینک و زدن دکمه "بارگذاری" آبی رنگ، بعد از مدت کوتاهی اطلاعات از فایل استخراج شده و بصورت پیش نمایش در می‌آید. (تصاویر ۱ تا ۳ تنظیمات مودال ثبت نقشه منطقه‌ای پنل ادمین متابیس)

تصویر ۱ تنظیمات مودال ثبت نقشه منطقه‌ای پنل ادمین متابیس
تصویر ۱ تنظیمات مودال ثبت نقشه منطقه‌ای پنل ادمین متابیس
تصویر ۲ تنظیمات مودال ثبت نقشه منطقه‌ای پنل ادمین متابیس
تصویر ۲ تنظیمات مودال ثبت نقشه منطقه‌ای پنل ادمین متابیس
تصویر ۳ تنظیمات مودال ثبت نقشه منطقه‌ای پنل ادمین متابیس
تصویر ۳ تنظیمات مودال ثبت نقشه منطقه‌ای پنل ادمین متابیس

مرحله۵:

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

انتخاب عبارت متمایز کننده مناطق در تنظیمات پاپ‌آپ ثبت نقشه منطقه‌ای پنل ادمین متابیس
انتخاب عبارت متمایز کننده مناطق در تنظیمات پاپ‌آپ ثبت نقشه منطقه‌ای پنل ادمین متابیس

مرحله۶:

آخرین فیلد انتخابی، نام نمایشی مناطق است که باید انتخاب شود. لازم به ذکر است تمام این جزئیات در فایل json ثبت شده‌اند، بنابرین به صورت دلخواه، شخصی‌ساز پذیرند. بعد از اتمام ثبت اطلاعات، بعد از زدن دکمه آبی رنگ <افزودن نقشه>، نقشه مورد نظر به لیست نقشه‌ها اضافه می‌شود.

نما نهایی ثبت اطلاعات نقشه منطقه‌ای
نما نهایی ثبت اطلاعات نقشه منطقه‌ای

مرحله۷:

بعد از افزودن نقشه و اضافه شدن به لیست، کاربران متابیس می‌توانند هر دیتایی که شامل طول و عرض جغرافیایی باشد در قسمت "نقشه" ـــ "تنظیمات" آن جدول می‌توان به نتیجه‌ای مشابه تصویر زیر رسید. در لیست نقشه‌ها، تمام مواردی که در لیست ادمین برای نقشه منطقه‌ای اضافه شده است قابل انتخاب می‌باشد. لازم به ذکر است که شاخص مورد ارزیابی نیز باید انتخاب شود. به عنوان مثال تعداد ثبت‌نام بر اساس استان.

مثال از نحوه استفاده نقشه منطقه‌ای متابیس
مثال از نحوه استفاده نقشه منطقه‌ای متابیس
انتخاب نقشه‌ها منطقه‌ای اضافه شده.
انتخاب نقشه‌ها منطقه‌ای اضافه شده.

پست فوق به توضیح مراحل افزودن نقشه سفارشی استان‌های ایران به ابزار متابیس برای ایجاد داشبوردهای تعاملی و نمایش داده‌های مکانی پرداخت. بصورت خلاصه این مراحل شامل موارد زیر است:

  1. ورود به پنل مدیریت متابیس و دسترسی به تنظیمات نقشه.
  2. افزودن لینک فایل IranGeo.json برای تعریف نقشه منطقه‌ای ایران.
  3. تنظیم مشخصه‌هایی مانند نام استان‌ها برای تشخیص مناطق مختلف.
  4. استفاده از نقشه در داشبوردها برای نمایش داده‌ها بر اساس طول و عرض جغرافیایی یا شاخص‌های دیگر.

این فرآیند کمک می‌کند تا تجسم داده‌ها دقیق‌تر باشد و تصمیم‌گیری بر اساس داده‌های جغرافیایی بهبود یابد.

جمع‌بندی:

اضافه کردن فایل سفارشی IranGeo.json به متابیس، امکان استفاده از نقشه‌های منطقه‌ای دقیق برای نمایش داده‌های مرتبط با استان‌های ایران را فراهم می‌کند. این قابلیت به کاربران متابیس کمک می‌کند تا از داده‌های مکانی خود به شکلی بصری و قابل درک استفاده کنند و آن را با جزئیات دقیق نقشه‌های جغرافیایی مطابقت دهند. فایل ارائه شده، در تیم محصول فروشگاه دیجی شهر توسعه داده شده است اما بصورت آزاد برای عموم قابل استفاده است.