افزونه نقشه گرویتی ویو | GravityView Maps

افزونه نقشه گرویتی ویو (GravityView Maps) از GravityKit ورودی‌های فرم‌های Gravity Forms را روی نقشه گوگل نشان می‌دهد و هر ورودی را از روی نشانی‌اش به یک نشانگر تبدیل می‌کند. این افزونه لایه‌ای برای GravityView است و کد آن فعال بودن GravityView و Gravity Forms را لازم می‌داند. برای رسم نقشه به کلید API گوگل نیاز است.

این افزونه را وردپرس نیاز در میان افزونه‌های کاربردی وردپرس عرضه می‌کند. سازنده در صفحه محصول آن را Maps Layout (لایه نقشه) می‌نامد.

دو کلید گوگل برای GravityView Maps

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

افزونه دو کلید API از Google Cloud می‌خواهد که در پیشخوان، زیر GravityKit و تنظیمات، در بخش گوگل مپس وارد می‌شوند. کلید نقشه‌ها برای نمایش نقشه به بازدیدکننده است و در مرورگر دیده می‌شود؛ صفحه تنظیمات برایش فعال بودن Maps JavaScript API و Places API را لازم می‌داند. کلید کدگذاری جغرافیایی برای ژئوکدینگ است، یعنی تبدیل نشانی به مختصات. این کلید دیده نمی‌شود و صفحه تنظیمات برایش Geocoding API را لازم می‌داند.

در نصب آزمایشی بدون هیچ کلیدی، صفحه View جای نقشه را خالی نشان داد و در کد صفحه آدرس اسکریپتی از Google Maps نبود؛ هر دو فیلد کلید هم در صفحه تنظیمات الزامی علامت خورده بودند؛ ولی ژئوکدینگ (بخش پایین‌تر) بدون کلید هم مختصات پیدا کرد. طبق مستندات سازنده، این لایه فقط از Google Maps پشتیبانی می‌کند.

ساخت View از نوع نقشه در GravityView

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

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

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

ژئوکدینگ و مختصات نشانی‌ها

ورودی‌ای که مختصات ندارد نشانگر هم ندارد. طبق مستندات سازنده، افزونه اول از گوگل می‌پرسد و اگر پاسخی نیامد، با وارد بودن کلید Bing یا MapQuest از آن‌ها و در پایان از OpenStreetMap می‌پرسد.

در نصب آزمایشی بدون هیچ کلیدی و با ژئوکدینگ خودکار روشن، افزونه برای هر یک از شش نشانی نمونه اول به گوگل (با کلید خالی) و بعد به OpenStreetMap درخواست فرستاد. چهار نشانی مختصات گرفتند و برای دو نشانی دیگر پیام «No provider could provide the address» ذخیره شد. فهرست نشانگرهای View هم، که از مسیر REST خود افزونه و بدون ورود به سایت خوانده شد، فقط چهار ورودی از شش ورودی را داشت.

در صفحه هر ورودی، زیر فیلد نشانی، دو کادر عرض و طول جغرافیایی و دکمه‌های «جئوکد کردن این آدرس» و «مشاهده در گوگل مپس» اضافه می‌شود. وقتی ژئوکدر نشانی را پیدا نکند، می‌شود مختصات را دستی نوشت: در آزمایش، مختصاتی که با اسکریپت برای یکی از دو ورودی بی‌نشانگر وارد شد (برای آزمایش)، پس از کلیک اسکریپتی روی «به‌روزرسانی» ذخیره شد و افزونه «مختصات با موفقیت به‌روزرسانی شدند» نوشت.

آنچه سازنده می‌گوید و نصب آزمایشی اجرا نکرد

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

• خوشه‌بندی: نشانگرهای نزدیک به هم در یک دایره شماره‌دار جمع می‌شوند و با بزرگ‌نمایی از هم باز می‌شوند.
• جعبه اطلاعات: با کلیک روی نشانگر جعبه‌ای باز می‌شود که محتوایش می‌تواند Merge Tag، شورت‌کد و HTML داشته باشد.
• آیکون سفارشی: آیکون نشانگر می‌تواند بر اساس مقدار یک فیلد یا انتخاب کاربر در فرم فرق کند.
• چند نشانگر برای یک ورودی: اگر فرم چند فیلد نشانی داشته باشد، برای هر کدام یک نشانگر می‌گذارد.
• جستجوی شعاعی: فیلدی با نام «Geolocation Radius» به ابزارک نوار جستجو اضافه می‌شود و ورودی‌های نزدیک به یک نشانی یا مکان فعلی بازدیدکننده را پیدا می‌کند؛ View باید دسترسی REST داشته باشد.
• تکمیل خودکار نشانی در فرم: فیلد نشانی Gravity Forms گزینه‌ای برای تکمیل خودکار با Places API دارد.
• نقشه در View‌هایی با طرح‌بندی دیگر: ابزارک «Multiple Entries Map» نقشه را به View جدول، فهرست و مانند آن‌ها اضافه می‌کند.

پیش از خرید

برای کار با این افزونه GravityView و Gravity Forms باید روی سایت فعال باشند. طبق کد افزونه، اگر GravityView یا Gravity Forms فعال نباشد، اعلان خطا نشان داده می‌شود. برای نمایش نقشه باید کلید گوگل خودتان را در Google Cloud بسازید؛ مستندات سازنده پیشنهاد می‌کند کلید نقشه‌ها به دامنه سایت و کلید ژئوکدینگ به IP سرور محدود شود.

اگر فرم‌های Gravity Forms شما نشانی دارند و می‌خواهید ورودی‌ها کنار فهرستشان روی نقشه دیده شوند، این افزونه نقشه را به View همان فرم اضافه می‌کند. فقط باید کلیدهای گوگل را بسازید و مختصات نشانی‌هایی را که ژئوکدر پیدا نکرد دستی بنویسید. اگر ترجیح می‌دهید راه‌اندازی آن را متخصص بر عهده بگیرد، خدمات نگهداری و عیب‌یابی سایت برای همین کار است.