ایড্রেস آٹوকমপ্লিট گریوی فارمز کے لیے

پلگ ان کو کیسے فعال کریں؟

گریوٹی فارمز کے لیے ایڈریس آٹو مکمل خریدنے کے بعد، آپ کو یہ کرنا ہوگا:

1. پ্লাগইন کو اپنی ورڈপ্রেস ویب سائٹ پر انسٹال کریں۔.
2. اپنی گوگل اے پی آئی کلید بنائیں اور درج کریں۔.
3. ایک ایڈریس پر آٹو مکمل فعال کریں یا سنگل لائن ٹیکسٹ فیلڈ.

نیچے دیے گئے ہدایات میں آپ کو بتایا جائے گا کہ اپنا پلگ ان کیسے انسٹال کریں، ایڈریس آٹو مکمل کے لیے گوگل اے پی آئی کلید کیسے بنائیں اور اسے ایڈریس فیلڈ یا سنگل لائن ٹیکسٹ فیلڈ پر کیسے فعال کریں۔.

پلگ ان کو Plugin Brewery کے ساتھ رجسٹر کریں

	اپنی ورڈپریس ویب سائٹ پر لاگ ان کریں اور پلگ انز (Plugins) > پلگ ان شامل کریں (Add Plugin) > پلگ ان اپ لوڈ کریں (Upload Plugin) پر جائیں، زپ فائل انسٹال کریں اور اسے ایکٹیویٹ کریں۔. ایک بار فعال ہونے کے بعد، پلگ ان فارمز > ایڈ آنز > انسٹالڈ میں ظاہر ہوتا ہے اور اس کی سیٹنگز فارمز > سیٹنگز > ایڈریس آٹو مکمل کے تحت ہوتی ہیں۔.
	بائیں ہاتھ کے نیویگیشن پر، Forms > Settings > Address Autocomplete > License پر جائیں۔ اپنی لائسنس کی درج کریں اور اسے فعال کریں۔ اس کے بعد نیچے دیے گئے گوگل API کی جنریشن کی ترتیبات پر جائیں۔.

گوگل اے پی آئی کلید بنائیں اور درج کریں

ایڈریس آٹو کمپلیٹ استعمال کرنے سے پہلے، آپ کو گوگل کلاؤڈ پلیٹ فارم کنسول میں ایک API کلید بنانی ہوگی۔.

	گوگل کو فعال کریں پ্লেسز اے پی آئی (نیو) اور گوگل میپس جاوا اسکرپٹ اے پی آئی. ہدایات موصول ہوئیں
	گوگل اے پی آئی کلید بنائیں اور اس پر پابندی عائد کریں۔. ہدایات موصول ہوئیں
	گوگل اے پی آئی کلید درج کریں۔.

ایڈریس کے خانوں پر فعال کریں

	اپنے فارم میں ایڈریس کا خانہ شامل کریں۔.
	فیلڈ کی سیٹنگز کھولیں، اور اس پر جائیں ایڈوانسڈ سیکشن، اور فعال کریں ایড্রেস آٹوকমপ্লিট چیک باکس.

سنگل لائن ٹیکسٹ فیلڈز پر فعال کریں

	اپنے فارم میں ایک سنگل لائن ٹیکسٹ فیلڈ شامل کریں۔.
	فیلڈ کی سیٹنگز کھولیں، اور اس پر جائیں ایڈوانسڈ سیکشن، اور فعال کریں ایড্রেস آٹوকমপ্লিট چیک باکس.

گوگل اے پی آئی کی کلید تیار کرنا

ایک نیا گوگل کلاؤڈ پروجیکٹ بنائیں یا موجودہ منتخب کریں

گوگل اے پی آئی کلید حاصل کرنے سے پہلے، آپ کو نیا بنائیں گوگل کلاؤڈ پلیٹ فارم پروجیکٹ (یا اگر آپ کے پاس ہے تو موجودہ کو منتخب کریں)۔.

نوٹ: اگر آپ نیا جی سی پی (GCP) پروجیکٹ بنا رہے ہیں تو ہم تجویز کرتے ہیں کہ آپ اسے اس ویب سائٹ کے لیے مخصوص رکھیں جس پر آپ کام کر رہے ہیں، تاکہ بوقتِ ضرورت اسی ویب سائٹ کے لیے گوگل اے پی آئی (API) کی دیگر خدمات بھی استعمال کی جا سکیں۔.

ضروری اے پی آئیز فعال کریں

گૂگل کلاؤڈ پروجیکٹ بنانے یا منتخب کرنے کے بعد، APIs & Services > API Library پر جائیں اور درج ذیل APIs کو فعال کریں:

نوٹ: پلیسز API کو فعال کرنے سے پہلے گوگل کو آپ کے پروجیکٹ کے ساتھ بلنگ اکاؤنٹ منسلک کرنے کی ضرورت ہوتی ہے۔ زیادہ تر ویب سائٹس کے لیے استعمال گوگل کی مفت حد میں آتا ہے، لیکن پھر بھی ادائیگی کے طریقہ کار کی ضرورت ہوتی ہے۔.

پ্লেسز اے پی آئی (نیو)

فوری ربط

آپ کو “Places API” اور “Places API (New)” نظر آ سکتا ہے – ہمارا پلگ ان “Places API (New)” کے ساتھ مطابقت رکھنے کے لیے بنایا گیا ہے۔”

نقشے جاوا اسکرپٹ اے پی آئی

فوری ربط

کلید بنائیں

اب جب کہ آپ نے اپنے پروجیکٹ میں دونوں API کو فعال کر دیا ہے، آپ اپنی API کلید بنا سکتے ہیں۔.

پر جائیں۔ APIs اور خدمات > اسناد, ، پھر "+ اسناد بنائیں" پر کلک کریں اور آخر میں "API کلید" پر کلک کریں۔“

ایک سائیڈ ڈائیلاگ ونڈو باہر پھسل جائے گی جہاں آپ اپنی کلید کا نام دے سکتے ہیں۔.

اس مقام پر، آپ نیچے سکرول کر سکتے ہیں اور "تخلیق کریں" پر کلک کر سکتے ہیں اور آپ کی کلید فوری طور پر تیار ہو جائے گی، تاہم… آپ کو اپنی کلید کے غیر مجاز استعمال کو روکنے کے لیے اگلے مرحلے میں اس پر پابندی لگانی چاہیے۔.

نوٹ: یہ بہت اہم ہے! چابیاں دیکھنے کے قابل ہیں لہذا آپ نہیں چاہتے ہیں کہ کوئی برا اداکار آپ کے مفت استعمال کو چوری کرے۔

ڈائیلاگ ونڈو میں "ایپلیکیشن پابندیاں" تک سکرول کرنا جاری رکھیں۔.

"درخواست کی پابندیاں" کے تحت "ویب سائٹس" کو منتخب کریں“

"ویب سائٹ کی پابندیاں" کے تحت اپنی ویب سائٹس شامل کریں جہاں api کلید استعمال کی جانی چاہیے۔ https شامل نہ کریں۔.

ہم www اور غیر www ڈومینز پر کلیدی کاموں کو یقینی بنانے کے لیے وائلڈ کارڈ ڈومین شامل کرنے کی تجویز کرتے ہیں: *.example-website.com/*

تخلیق پر کلک کریں اور آپ کی کلید آگے ظاہر ہوگی۔.

اب آپ کی API کلید بن گئی ہے! اسے کاپی کریں، اور اسے پلگ ان کے ایڈریس خودکار تکمیل کی ترتیبات میں چسپاں کریں اور آپ بالکل تیار ہیں!

ڈومین فارمیٹنگ: فارمیٹ کا استعمال کرتے ہوئے ہر ڈومین کو اس کی اپنی لائن پر درج کریں۔ example.com/* - نہیں https://, خود ڈومین پر کوئی ٹریلنگ سلیش نہیں ہے، لیکن شامل ہے۔ /* آخر میں تمام صفحات کی اجازت دینے کے لیے۔ تمام ذیلی ڈومینز کا احاطہ کرنے کے لیے (جیسے www) کے طور پر ایک علیحدہ اندراج شامل کریں۔ *.example.com/*. مقامی ترقی کے لیے استعمال کریں۔ localhost یا localhost:3000/* آپ کے سیٹ اپ پر منحصر ہے۔.

yourdomain.com/*
*.yourdomain.com/*
staging.yourdomain.com/*
localhost:8080/*

Google کی سروس کی شرائط اور رازداری کی پالیسی

Plugin Brewery ایڈریس خودکار مکمل ایڈریس تلاش کرنے کے لیے گوگل کی سروسز کو فارم ڈیٹا بھیجتا ہے۔ گوگل کے رہنما خطوط کے مطابق، Places API استعمال کرنے والی کسی بھی ایپلیکیشن کو گوگل کا لنک دکھانا چاہیے۔ سروس کی شرائط اور رازداری کی پالیسی.

آپ کے ملک یا علاقے پر منحصر ہے، آپ کو مقام کا ڈیٹا اکٹھا کرنے سے پہلے صارف کی رضامندی بھی حاصل کرنے کی ضرورت پڑ سکتی ہے۔.

خصوصیت کی تفصیلات

فیلڈ کی اقسام کی حمایت کی

دونوں کشش ثقل فارم فیلڈ اقسام پر کام کرتا ہے:

• ایڈریس فیلڈ (ملٹی ان پٹ)
• سنگل لائن ٹیکسٹ (ایک لائن ایڈریس ان پٹ)

ایڈریس فیلڈز کا استعمال کریں جب آپ مقامی GF ایڈریس ذیلی فیلڈز، یا سنگل لائن ٹیکسٹ جب آپ آسان فارم لے آؤٹ چاہتے ہیں۔.

تجزیہ شدہ ایڈریس میپنگ (نیا)

اپنے فارم میں مخصوص فیلڈز میں منتخب ایڈریس کے اجزاء کا نقشہ بنائیں:

• ایڈریس لائن 1
• ایڈریس لائن 2
• پوسٹل/زپ
• شہر/ قصبہ
• ریاست/صوبہ/علاقہ
• ملک

ڈیلیوری زون چیک، CRM روٹنگ، مشروط اطلاعات اور آٹومیشن میں استعمال ہونے والے پوشیدہ فیلڈز کے لیے بہت اچھا ہے۔.

زپ / پوسٹل کوڈ تلاش (نیا)

سنگل لائن ٹیکسٹ فیلڈ کو پوسٹل/زپ کوڈ کی تلاش میں تبدیل کریں۔ ایڈریس خودکار تکمیل کو فعال کریں، پھر فیلڈ کی ایڈوانس سیٹنگز میں پوسٹل کوڈ تلاش کو آن کریں۔.

• تجاویز پوسٹل/زپ کوڈز تک محدود ہیں۔
• فیلڈ صرف منتخب کوڈ رکھتا ہے (مکمل پتہ نہیں)
• شہر، ریاست/علاقہ (اور ملک/کاؤنٹی اگر نقشہ لگایا گیا ہے) خود بخود بھر جائیں، بشمول پوشیدہ فیلڈز
• پوسٹل کوڈز والے کسی بھی ملک کے لیے کام کرتا ہے۔

سروس ایریا کی جانچ پڑتال، شپنگ منطق، اور آپ کے CRM کو کلین لوکیشن ڈیٹا بھیجنے کے لیے بہترین۔.

سنگل لائن ٹیکسٹ پوسٹل/زپ ہینڈلنگ

سنگل لائن ٹیکسٹ فیلڈز کے لیے، پلگ ان گوگل کے فارمیٹ شدہ ایڈریس کا استعمال کرتا ہے اور پوسٹل/زپ کوڈ کو شامل کرتا ہے جب یہ دستیاب ہوتا ہے لیکن ظاہر شدہ متن سے غائب ہوتا ہے۔ اگر Google کسی نتیجے کے لیے پوسٹل کوڈ واپس نہیں کرتا ہے، تو اسے شامل نہیں کیا جا سکتا۔.

میٹا ڈیٹا انٹری میٹا میں محفوظ ہو گیا۔

جب صارفین کوئی تجویز منتخب کرتے ہیں، تو پلگ ان اسٹور کرتا ہے:

• جگہ کی شناخت
• عرض بلد
• طول البلد
• فارمیٹ شدہ پتہ

ملکی پابندیاں + بین الاقوامی تعاون

آپ آئی ایس او الفا-2 کوڈ والے مخصوص ممالک تک تجاویز کو محدود کر سکتے ہیں (مثال کے طور پر: US,CA,GB)، یا عالمی شکلوں کے لیے غیر محدود چھوڑ دیں۔.

لیبلز اور نقشہ سازی کے اختیارات ملک کے لحاظ سے غیر جانبدار ہیں، لہذا امریکی اور غیر امریکی ٹیموں کے لیے ورک فلو واضح رہتے ہیں۔.

کارکردگی + مطابقت

حقیقی دنیا کی پروڈکشن سائٹس کے لیے ڈیزائن کیا گیا:

• فرنٹ اینڈ اسکرپٹ صرف اسی جگہ شروع ہوتی ہیں جہاں فعال فیلڈز موجود ہوں۔
• معیاری اور AJAX Gravity Forms کے بہاؤ کے ساتھ کام کرتا ہے۔
• زیادہ تر کنفیگریشنز میں عام کیشنگ/CDN سیٹ اپ کے ساتھ ہم آہنگ

ٹیگز کو ضم کریں۔

جب کوئی وزیٹر خودکار تکمیل کی تجویز کا انتخاب کرتا ہے، تو پلگ ان اندراج پر میٹا ڈیٹا اسٹور کر سکتا ہے۔ آپ اس ڈیٹا کو کنفرمیشنز، نوٹیفیکیشنز اور دیگر جگہوں پر داخل کر سکتے ہیں جو گریوٹی فارمز ضم ٹیگز کو سپورٹ کرتے ہیں۔.

فارمیٹ: {pb_aac:ID:KEY}

ID کو ایڈریس یا سنگل لائن ٹیکسٹ فیلڈ کی فیلڈ ID سے تبدیل کریں جس میں ایڈریس آٹوکمپلٹ فعال ہے (وہی فیلڈ جہاں تجاویز ظاہر ہوتی ہیں)۔.

دستیاب چابیاں (KEY):

مثالیں (اگر آپ کا خود بخود مکمل فیلڈ فیلڈ 12 ہے):

• {pb_aac:12:place_id}
• {pb_aac:12:lat}
• {pb_aac:12:lng}
• {pb_aac:12:formatted}
• {pb_aac:12:google_maps_url}

چنندہ: فارم ایڈیٹر میں، فعال فیلڈز کو یہ ٹیگ ضم کرنے والے ٹیگ چننے والے میں بھی ملتے ہیں جیسے "ایڈریس خودکار تکمیل: …"۔.

نوٹ: اقدار صرف اندراجات کے لیے موجود ہیں جہاں ایک تجویز منتخب کی گئی تھی اور میٹا ڈیٹا محفوظ کیا گیا تھا۔ بصورت دیگر ٹیگ خالی (ڈیزائن کے ذریعہ) حل کرتا ہے۔.

اکثر پوچھے گئے سوالات

کیا Google Places API مفت ہے؟

Google خود بخود آپ کے اکاؤنٹ میں $200 ماہانہ کریڈٹ لاگو کرتا ہے، جس کے خلاف آپ کے Places API کے استعمال کا بل لیا جاتا ہے۔ زیادہ تر سائٹس کے لیے، یہ تمام اخراجات کا احاطہ کرتا ہے — موجودہ شرحوں پر، تقریباً 10,000 خودکار تکمیلی سیشنز ہر ماہ اس کریڈٹ میں آتے ہیں۔.

اس نے کہا، قیمتوں کا تعین تبدیل ہوسکتا ہے، لہذا چیک کریں گوگل میپس پلیٹ فارم کی قیمتوں کا ٹیبل تازہ ترین نمبروں کے لیے۔.

کیا میں اسے "سنگل لائن ٹیکسٹ" فیلڈ کے ساتھ استعمال کر سکتا ہوں؟

جی ہاں! معیاری ایڈریس فیلڈ کے علاوہ، آپ کسی بھی سنگل لائن ٹیکسٹ فیلڈ پر خودکار تکمیل کو فعال کر سکتے ہیں۔ ان فارمز کے لیے مثالی ہے جن کو صرف ایک ایڈریس ان پٹ کی ضرورت ہے۔.

کیا یہ بین الاقوامی پتوں کے لیے کام کرتا ہے؟

بالکل۔ پلگ ان گوگل کے عالمی ایڈریس ڈیٹا کو سپورٹ کرتا ہے۔.

کیا سیٹ اپ پیچیدہ ہے؟

ہرگز نہیں۔ بس پلگ ان کی ترتیبات میں اپنی Google API کلید شامل کریں، اپنی منتخب کردہ فیلڈز پر خودکار تکمیل کو فعال کریں، اور آپ کا کام ہو گیا۔ یہ اتنا آسان ہے۔.

کیا میں نتائج کو مخصوص ممالک تک محدود کر سکتا ہوں؟

جی ہاں فیلڈ سیٹنگز میں، ISO 3166-1 alpha-2 کنٹری کوڈز کی کوما سے الگ کردہ فہرست فراہم کریں (مثال کے طور پر،, US,CA,GB).

میں گوگل کلاؤڈ میں کون سے مقامات کے API کو فعال کروں؟

"Places API (New)" کو فعال کریں کیونکہ میراث "Places API" کو بند کرنے اور "Maps JavaScript API" کے لیے شیڈول کیا گیا ہے۔.

کیا میں ایڈریس میٹا ڈیٹا کو اطلاعات یا انضمام میں استعمال کر سکتا ہوں؟

جی ہاں ایڈریس آٹوکمپلیٹ پلیس آئی ڈی، عرض البلد، طول البلد، فارمیٹ شدہ پتہ، اور گوگل میپس یو آر ایل کے لیے انضمام کے ٹیگز شامل کرتا ہے۔ کسی بھی اطلاع، تصدیق، یا فیڈ میپنگ میں Gravity Forms merge-tag picker کا استعمال کریں۔.

کیا ڈویلپرز اپنی مرضی کے مطابق بنا سکتے ہیں جو گوگل واپس کرتا ہے؟

جی ہاں استعمال کریں۔ pb_aac_request درخواست کو ایڈجسٹ کرنے کے لیے JavaScript فلٹر — مثال کے طور پر، کسی علاقے کے لیے نتائج کی طرفداری کرنا، باؤنڈنگ باکس شامل کرنا، یا کاروبار کو شامل کرنے کے لیے توسیع کرنا۔.

کیا میں کسی فیلڈ کو زپ/پوسٹل کوڈ تلاش کرنے کے طور پر استعمال کر سکتا ہوں؟

جی ہاں سنگل لائن ٹیکسٹ فیلڈ پر، ایڈریس خودکار تکمیل کو فعال کریں اور پھر پوسٹل کوڈ تلاش کو آن کریں۔ فیلڈ زپ/پوسٹل کی تجاویز دکھاتا ہے، اور ایک کو منتخب کرنے سے آپ کے منتخب کردہ شہر اور ریاست/علاقے کی فیلڈز بھر جاتی ہیں (بشمول پوشیدہ)۔ "اپنے علاقے کو چیک کریں" اسٹائل فارمز اور CRM روٹنگ کے لیے بہت اچھا ہے۔.