এটি কী করে?

গ্র্যাভিটি ফর্মসের জন্য অ্যাড্রেস অটোক incomplète ব্যবহারকারীদের টাইপ করার সাথে সাথে গুগল-চালিত সাজেশন দেখিয়ে আরও দ্রুত নির্ভুল ঠিকানা জমা দিতে সাহায্য করে। উভয়টির সাথেই কাজ করে ঠিকানা এবং এক লাইনের পাঠ্য ক্ষেত্রসমূহ.

যখন একজন ব্যবহারকারী কোনো পরামর্শ নির্বাচন করেন, তখন প্লাগইনটি রাউটিং, অটোমেশন বা রিপোর্টিংয়ের জন্য ডেডিকেটেড ফিল্ডগুলো (লুকানো ফিল্ডসহ) পূরণ করতে দরকারী লোকেশন মেটাডেটা (যেমন প্লেস আইডি এবং স্থানাঙ্ক) ক্যাপচার করতে পারে এবং মূল ঠিকানার অংশগুলো ম্যাপ করতে পারে—অথবা একটি জিপ/পোস্টাল কোড লুকআপও চালাতে পারে।.

বৈশিষ্ট্যগুলি

দ্রুত ঠিকানা পূরণ
ব্যবহারকারীরা টাইপ করার সাথে সাথে গুগল-চালিত পরামর্শ পান, যা কিস্ট্রোক কমায় এবং জমা দেওয়ার প্রক্রিয়াকে দ্রুততর করে।.
ঠিকana + একক লাইনের পাঠ্য ক্ষেত্রের সাথে কাজ করে
যੇ কোনো ফিল্ড টাইপে অটোকম্প্লিট সক্ষম করুন, যাতে আপনি আপনার বর্তমান ফর্ম লেআউট বজায় রাখতে পারেন।.
পারse করা ফিল্ড ম্যাপিং
অ্যাড্রেস লাইন ১, লাইন ২, শহর/টাউন, রাজ্য/অঞ্চল, পোস্টাল/জিপ এবং দেশ-কে একই ফর্মের যেকোনো নির্বাচিত ক্ষেত্রে, এমনকি লুকানো ক্ষেত্রেও পাঠিয়ে দিন।.
আন্তর্জাতিকভাবে উপযোগী ঠিকানা পরিচালনা
এটি বৈশ্বিক ঠিকানা সমর্থন করে এবং মার্কিন যুক্তরাষ্ট্রের বাইরের দলগুলির জন্য সেটিংসে দেশ-নিরপেক্ষ লেবেল ব্যবহার করে।.
দেশ অনুসারে ফলাফল সীমাবদ্ধ করুন
ISO কোড ব্যবহার করে নির্দিষ্ট দেশগুলিতে পরামর্শ সীমাবদ্ধ করুন (উদাহরণস্বরূপ, US, CA, GB)।.
প্রতিটি এন্ট্রির সাথে মেটাডেটা সংরক্ষিত হয়
ইন্টিগ্রেশন, অটোমেশন এবং ট্রাবলশুটিংয়ের জন্য এটি প্লেস আইডি (Place ID), অক্ষাংশ, দ্রাঘিমাংশ এবং ফরম্যাট করা ঠিকানা সংরক্ষণ করে।.
ওয়ার্ডপ্রেস মাল্টিসাইট সামঞ্জস্যপূর্ণ
আপনার সমস্ত সাবসাইটে এটি ব্যবহার করতে একবার নেটওয়ার্ক-অ্যাক্টিভেট করুন। (আনলিমিটেড প্ল্যানে নেটওয়ার্ক মোড উপলব্ধ।)
অনুবাদ প্রস্তুত
আপনার নির্বাচিত অনুবাদ প্লাগইনের সাথে সম্পূর্ণ সামঞ্জস্যপূর্ণ।প্রি-ট্রান্সলেশন অন্তর্ভুক্ত নয় তবে শীঘ্রই আসছে)
জিপ / পোস্টাল কোড লুকআপ
একটি একক ফিল্ডকে জিপ/পোস্টাল কোড সার্চে রূপান্তর করুন যা স্বয়ংক্রিয়ভাবে আপনার শহর এবং রাজ্য/অঞ্চল ফিল্ডগুলো (লুকানো সহ) পূরণ করে — “আপনার এলাকা চেক করুন” ফর্ম এবং সিআরএম রাউটিংয়ের জন্য আদর্শ।.

ফিচার বিস্তারিত এ যান

গ্রavity ফর্মস-এর জন্য অ্যাড্রেস অটোকমপ্লিট পেতে প্রস্তুত?

আপনি যদি শুরু করতে প্রস্তুত হন, তাহলে এখানে উপলব্ধ বিকল্পগুলি দেওয়া হলো:

আমি কীভাবে প্লাগইনটি সচল করব?

গ্র্যাভিটি ফর্মসের জন্য অ্যাড্রেস অটোকম্প্লিট কেনার পর, আপনাকে যা করতে হবে:

আপনার ওয়ার্ডপ্রেস ওয়েবসাইটে প্লাগইনটি ইনস্টল করুন।.
আপনার গুগল এপিআই কী জেনারেট করুন এবং প্রবেশ করান।.
একটি ঠিকানায় অটোকম্প্লিট সক্ষম করুন অথবা এক লাইনের টেক্সট ফিল্ড.

নিচের নির্দেশাবলী আপনাকে দেখাবে কীভাবে আপনার প্লাগইন ইনস্টল করতে হয়, ঠিকানা স্বয়ংসম্পূর্ণ করার জন্য একটি গুগল এপিআই কী তৈরি করতে হয় এবং ঠিকানা ক্ষেত্র বা একক লাইনের পাঠ্য ক্ষেত্রে এটি সক্ষম করতে হয়।.

প্লাগইনটি Plugin Brewery এর সাথে নিবন্ধন করুন

গুগল এপিআই কী জেনারেট করে লিখুন

অ্যাড্রেস অটোকমপ্লিট ব্যবহার করার আগে, আপনাকে Google ক্লাউড প্ল্যাটফর্ম কনসোলে একটি API কী তৈরি করতে হবে।.

ঠিকানাগত ক্ষেত্রগুলোতে সক্ষম করুন

সিঙ্গেল লাইন টেক্সট ফিল্ডে সক্রিয় করুন

একটি গুগল এপিআই কী তৈরি করা হচ্ছে

একটি গুগল ক্লাউড প্রজেক্ট তৈরি করুন বা বিদ্যমান একটি নির্বাচন করুন

আপনার Google API কী পাওয়ার আগে, আপনাকে একটি নতুন তৈরি করুন গুগল ক্লাউড প্ল্যাটফর্ম প্রজেক্ট (অথবা আপনার কাছে থাকলে একটি বিদ্যমান প্রজেক্ট বেছে নিন)।.

দ্রষ্টব্য: আপনি যদি একটি নতুন জিসিপি (GCP) প্রজেক্ট তৈরি করে থাকেন, তবে আমরা এটি আপনার কাজ করা ওয়েবসাইটের জন্য সীমাবদ্ধ করার সুপারিশ করি, যদি আপনার একই ওয়েবসাইটের জন্য অন্য কোনো গুগল এপিআই পরিষেবার প্রয়োজন হয়।.

প্রয়োজনীয় এপিআই সক্ষম করুন

আপনি একটি গুগল ক্লাউড প্রজেক্ট তৈরি বা নির্বাচন করার পরে, APIs & Services > API Library-তে যান এবং নিম্নলিখিত APIগুলি সক্ষম করুন:

দ্রষ্টব্য: প্লেসেস এপিআই সক্ষম করার আগে গুগল-এর নিয়ম অনুযায়ী আপনার প্রজেক্টের সাথে একটি বিলিং অ্যাকাউন্ট যুক্ত করতে হবে। অধিকাংশ ওয়েবসাইটের ক্ষেত্রে ব্যবহারের পরিমাণ গুগল-এর ফ্রি টায়ার বা বিনামূল্যে ব্যবহারের সীমার মধ্যেই থাকে, তবুও পেমেন্ট পদ্ধতি যুক্ত করা বাধ্যতামূলক।.

প্লেসেস এপিআই (নতুন)

দ্রুত লিঙ্ক

আপনি “Places API” এবং “Places API (New)” দেখতে পারেন – আমাদের প্লাগইনটি “Places API (New)”-এর সাথে সামঞ্জস্যপূর্ণ করে তৈরি করা হয়েছে।”

মানচিত্র জাভাস্ক্রিপ্ট এপিআই

দ্রুত লিঙ্ক

চাবি তৈরি করুন

এখন যেহেতু আপনার প্রোজেক্টে উভয় API সক্রিয় করা আছে, আপনি আপনার API Key তৈরি করতে পারেন।.

যান এপিআই এবং পরিষেবা > পরিচয়পত্র, তারপর “+ Create Credentials”-এ ক্লিক করুন এবং সবশেষে “API key”-তে ক্লিক করুন।”

একটি সাইড ডায়ালগ উইন্ডো স্লাইড করে বেরিয়ে আসবে যেখানে আপনি আপনার কী-টির নাম দিতে পারবেন।.

এই পর্যায়ে, আপনি নিচে স্ক্রল করে “Create” এ ক্লিক করতে পারেন এবং আপনার কী (key) সাথে সাথে তৈরি হয়ে যাবে, তবে… আপনার কী-এর অননুমোদিত ব্যবহার রোধ করতে পরবর্তী ধাপে এটির উপর একটি বিধিনিষেধ আরোপ করা উচিত।.

দ্রষ্টব্য: এটি অত্যন্ত গুরুত্বপূর্ণ! কীগুলো দেখা যায়, তাই আপনি নিশ্চয়ই চাইবেন না যে কোনো দুষ্কৃতকারী আপনার বিনামূল্যে ব্যবহারের সুযোগটি চুরি করে নিক।

ডায়ালগ উইন্ডোতে “অ্যাপ্লিকেশন সীমাবদ্ধতা” পর্যন্ত স্ক্রোল করতে থাকুন।.

“অ্যাপ্লিকেশন সীমাবদ্ধতা”-এর অধীনে “ওয়েবসাইট” নির্বাচন করুন।”

“ওয়েবসাইট সীমাবদ্ধতা”-এর অধীনে আপনার সেই ওয়েবসাইটগুলো যোগ করুন যেখানে এপিআই কী ব্যবহার করা হবে। https যোগ করবেন না।.

আমরা একটি ওয়াইল্ডকার্ড ডোমেইন যোগ করার পরামর্শ দিই, যাতে কী-টি www এবং non-www উভয় ডোমেইনেই এইভাবে কাজ করে: *.example-website.com/*

তৈরি করুন-এ ক্লিক করুন এবং এরপর আপনার কী (key) দেখা যাবে।.

এখন আপনার API কী তৈরি হয়ে গেছে! এটি কপি করে প্লাগইনটির Address Autocomplete সেটিংসে পেস্ট করুন, তাহলেই কাজ শেষ!

ডোমেইন ফরম্যাটিং: প্রতিটি ডোমেইন আলাদা লাইনে এই ফরম্যাট অনুযায়ী লিখুন। example.com/* — না https://, ডোমেইনটির শেষে কোনো স্ল্যাশ থাকবে না, কিন্তু অন্তর্ভুক্ত থাকবে /* শেষে সমস্ত পৃষ্ঠা অনুমোদনের জন্য। সমস্ত সাবডোমেন (যেমন www), আলাদা এন্ট্রি হিসাবে যোগ করুন *.example.com/*. স্থানীয় উন্নয়নের জন্য ব্যবহার করুন localhost অথবা localhost:3000/* আপনার সেটআপের উপর নির্ভর করে।.

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

গুগলের পরিষেবার শর্তাবলী ও গোপনীয়তা নীতি

Plugin Brewery অ্যাড্রেস অটোকমপ্লিট ঠিকানা খোঁজার জন্য ফর্মের ডেটা গুগলের পরিষেবাগুলিতে পাঠায়। গুগলের নির্দেশিকা অনুসারে, প্লেসেস এপিআই (Places API) ব্যবহারকারী যেকোনো অ্যাপ্লিকেশনে গুগলের একটি লিঙ্ক প্রদর্শন করা উচিত। পরিষেবার শর্তাবলী এবং গোপনীয়তা নীতি.

আপনার দেশ বা অঞ্চলভেদে, অবস্থানের তথ্য সংগ্রহের আগে ব্যবহারকারীর সম্মতি নেওয়ার প্রয়োজন হতে পারে।.

ফিচারের বিবরণ

সমর্থিত ক্ষেত্রের প্রকার

উভয় গ্র্যাভিটি ফর্মস ফিল্ড টাইপেই কাজ করে:

ঠিকানা ক্ষেত্র (একাধিক ইনপুট)
এক লাইনের লেখা (এক লাইনে ঠিকানা ইনপুট)

নেটিভ জিএফ অ্যাড্রেস সাবফিল্ড চাইলে অ্যাড্রেস ফিল্ড ব্যবহার করুন, অথবা আরও সরল ফর্ম লেআউট চাইলে সিঙ্গেল লাইন টেক্সট ব্যবহার করুন।.

পার্স করা ঠিকানা ম্যাপিং (নতুন)

আপনার ফর্মে নির্বাচিত ঠিকানার উপাদানগুলিকে নির্দিষ্ট ফিল্ডে ম্যাপ করুন:

ঠিকানা লাইন ১
ঠিকানা লাইন ২
ডাকঘর / জিপ কোড
শহর / নগর
রাজ্য / প্রদেশ / অঞ্চল
দেশ

ডেলিভারি-জোন চেক, সিআরএম রাউটিং, শর্তসাপেক্ষ নোটিফিকেশন এবং অটোমেশনে ব্যবহৃত হিডেন ফিল্ডের জন্য এটি দারুণ।.

জিপ / পোস্টাল কোড অনুসন্ধান (নতুন)

একটি সিঙ্গেল লাইন টেক্সট ফিল্ডকে পোস্টাল/জিপ কোড সার্চে পরিণত করুন। অ্যাড্রেস অটোকমপ্লিট সক্ষম করুন, তারপর ফিল্ডটির অ্যাডভান্সড সেটিংসে পোস্টাল কোড লুকআপ চালু করুন।.

পরামর্শগুলি পোস্টাল/জিপ কোডের মধ্যে সীমাবদ্ধ।
ফিল্ডটি শুধু নির্বাচিত কোডটি রাখে (সম্পূর্ণ ঠিকানা নয়)।
শহর, রাজ্য/অঞ্চল (এবং ম্যাপ করা থাকলে দেশ/কাউন্টি) লুকানো ক্ষেত্রগুলি সহ স্বয়ংক্রিয়ভাবে পূরণ হয়ে যায়।
যেসব দেশে পোস্টাল কোড আছে, সেসব দেশের জন্যই কাজ করে।

সার্ভিস-এরিয়া চেক, শিপিং লজিক এবং আপনার CRM-এ নির্ভুল লোকেশন ডেটা পাঠানোর জন্য এটি আদর্শ।.

একক লাইনের টেক্সট পোস্টাল/জিপ হ্যান্ডলিং

সিঙ্গেল লাইন টেক্সট ফিল্ডের ক্ষেত্রে, প্লাগইনটি গুগলের ফরম্যাট করা ঠিকানা ব্যবহার করে এবং প্রদর্শিত টেক্সটে পোস্টাল/জিপ কোড অনুপস্থিত থাকলেও, তা যোগ করে দেয়। গুগল কোনো ফলাফলের জন্য পোস্টাল কোড না দেখালে, তা যোগ করা যায় না।.

এন্ট্রি মেটা-তে সংরক্ষিত মেটাডেটা

যখন ব্যবহারকারীরা কোনো পরামর্শ নির্বাচন করেন, তখন প্লাগইনটি সংরক্ষণ করে:

স্থান আইডি
অক্ষাংশ
দ্রাঘিমাংশ
ফর্ম্যাট করা ঠিকানা

দেশীয় সীমাবদ্ধতা + আন্তর্জাতিক সহায়তা

আপনি ISO আলফা-২ কোড ব্যবহার করে নির্দিষ্ট দেশগুলিতে পরামর্শ সীমাবদ্ধ করতে পারেন (উদাহরণস্বরূপ: US,CA,GB), অথবা গ্লোবাল ফর্মগুলির জন্য অবাধ রাখুন।.

লেবেল এবং ম্যাপিং বিকল্পগুলো দেশ-নিরপেক্ষ হওয়ায় মার্কিন ও অ-মার্কিন দলগুলোর জন্য কর্মপ্রবাহ স্পষ্ট থাকে।.

কর্মক্ষমতা + সামঞ্জস্য

বাস্তব উৎপাদন কেন্দ্রগুলির জন্য ডিজাইন করা হয়েছে:

ফ্রন্ট-এন্ড স্ক্রিপ্টগুলো শুধুমাত্র সেখানেই ইনিশিয়ালাইজ হয় যেখানে সক্রিয় ফিল্ডগুলো বিদ্যমান থাকে।
স্ট্যান্ডার্ড এবং এজেক্স গ্র্যাভিটি ফর্মস ফ্লো-এর সাথে কাজ করে
বেশিরভাগ কনফিগারেশনে প্রচলিত ক্যাশিং/সিডিএন সেটআপের সাথে সামঞ্জস্যপূর্ণ।

ট্যাগ একত্রিত করুন

যখন কোনো ভিজিটর একটি অটোকমপ্লিট সাজেশন নির্বাচন করেন, তখন প্লাগইনটি সেই এন্ট্রির মেটাডেটা সংরক্ষণ করতে পারে। আপনি সেই ডেটা কনফার্মেশন, নোটিফিকেশন এবং গ্র্যাভিটি ফর্মস মার্জ ট্যাগ সমর্থন করে এমন অন্যান্য স্থানে সন্নিবেশ করতে পারেন।.

বিন্যাস: {pb_aac:ID:KEY}

ID-এর জায়গায় সেই Address বা Single Line Text ফিল্ডের ফিল্ড ID বসান, যেটিতে Address Autocomplete চালু করা আছে (যে ফিল্ডে সাজেশনগুলো দেখা যায়)।.

উপলব্ধ কী (KEY):

চাবি	এর আউটপুট
`place_id`	গুগল প্লেস আইডি
`lat`	অক্ষাংশ
`lng`	দ্রাঘিমাংশ
`formatted`	ফরম্যাট করা ঠিকানা (গুগলের ফরম্যাট করা স্ট্রিং)
`google_maps_url`	প্লেস আইডি (অথবা প্লেস আইডি না থাকলে ল্যাট/লং) থেকে তৈরি একটি গুগল ম্যাপস সার্চ ইউআরএল

উদাহরণস্বরূপ (যদি আপনার অটোকমপ্লিট ফিল্ডটি ১২ নম্বর ফিল্ড হয়):

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

পিকার: ফর্ম এডিটরে, সক্রিয় ফিল্ডগুলোও মার্জ ট্যাগ পিকারের মধ্যে “ঠিকানা স্বয়ংসম্পূর্ণতা: …”-এর মতো লেবেলের অধীনে এই ট্যাগগুলো পায়।.

দ্রষ্টব্য: শুধুমাত্র সেইসব এন্ট্রির ক্ষেত্রেই ভ্যালু বিদ্যমান থাকে যেখানে কোনো সাজেশন নির্বাচন করা হয়েছে এবং মেটাডেটা সেভ করা হয়েছে; অন্যথায় ট্যাগটি খালি থাকে (ডিজাইন অনুযায়ী)।.

সাধারণত জিজ্ঞাসিত প্রশ্নাবলি

গুগল প্লেসেস এপিআই কি বিনামূল্যে পাওয়া যায়?

গুগল স্বয়ংক্রিয়ভাবে আপনার অ্যাকাউন্টে প্রতি মাসে $200 ক্রেডিট যোগ করে, যা থেকে আপনার প্লেসেস এপিআই (Places API) ব্যবহারের বিল পরিশোধ করা হয়। বেশিরভাগ সাইটের জন্য, এটি সমস্ত খরচ বহন করে — বর্তমান হার অনুযায়ী, প্রতি মাসে প্রায় ১০,০০০ অটোকমপ্লিট সেশন এই ক্রেডিটের আওতায় পড়ে।.

তবে, দাম পরিবর্তন হতে পারে, তাই যাচাই করে নিন। গুগল ম্যাপস প্ল্যাটফর্মের মূল্য তালিকা সর্বশেষ সংখ্যার জন্য।.

আমি কি এটি “Single Line Text” ফিল্ডের সাথে ব্যবহার করতে পারি?

হ্যাঁ! সাধারণ ঠিকানা ফিল্ডের পাশাপাশি, আপনি যেকোনো সিঙ্গেল লাইন টেক্সট ফিল্ডেও অটোকমপ্লিট চালু করতে পারেন। যেসব ফর্মে শুধু একটি ঠিকানা ইনপুট করার প্রয়োজন হয়, সেগুলোর জন্য এটি আদর্শ।.

এটি কি আন্তর্জাতিক ঠিকানার জন্য কাজ করে?

অবশ্যই। প্লাগইনটি গুগলের গ্লোবাল অ্যাড্রেস ডেটা সমর্থন করে।.

সেটআপ কি জটিল?

মোটেই না। শুধু প্লাগইন সেটিংসে আপনার গুগল এপিআই কী (Google API key) যোগ করুন, আপনার নির্বাচিত ফিল্ডগুলিতে অটোকমপ্লিট (autocomplete) চালু করুন, এবং আপনার কাজ শেষ। এটা এতটাই সহজ।.

আমি কি ফলাফল নির্দিষ্ট দেশে সীমাবদ্ধ করতে পারি?

হ্যাঁ। ফিল্ড সেটিংসে, ISO 3166-1 alpha-2 কান্ট্রি কোডগুলির একটি কমা-দ্বারা-পৃথকীকৃত তালিকা প্রদান করুন (যেমন, US,CA,GB).

গুগল ক্লাউডে আমি কোন প্লেসেস এপিআই (Places API) সক্রিয় করব?

যেহেতু পুরোনো “Places API” এবং “Maps JavaScript API” বন্ধ করে দেওয়া হবে, তাই “Places API (New)” এবং “Maps JavaScript API” সক্রিয় করুন।.

আমি কি নোটিফিকেশন বা ইন্টিগ্রেশনে অ্যাড্রেস মেটাডেটা ব্যবহার করতে পারি?

হ্যাঁ। অ্যাড্রেস অটোকমপ্লিট প্লেস আইডি, অক্ষাংশ, দ্রাঘিমাংশ, ফরম্যাট করা ঠিকানা এবং একটি গুগল ম্যাপস ইউআরএল-এর জন্য মার্জ ট্যাগ যোগ করে। যেকোনো নোটিফিকেশন, কনফার্মেশন বা ফিড ম্যাপিং-এ গ্র্যাভিটি ফর্মস মার্জ-ট্যাগ পিকারটি ব্যবহার করুন।.

ডেভেলপাররা কি গুগলের ফলাফল নিজেদের পছন্দ মতো পরিবর্তন করতে পারে?

হ্যাঁ। ব্যবহার করুন pb_aac_request অনুরোধটি সামঞ্জস্য করার জন্য জাভাস্ক্রিপ্ট ফিল্টার — যেমন, কোনো একটি অঞ্চলের দিকে ফলাফলকে পক্ষপাতদুষ্ট করা, একটি বাউন্ডিং বক্স যোগ করা, অথবা ব্যবসা প্রতিষ্ঠানগুলোকে অন্তর্ভুক্ত করার জন্য এর পরিধি প্রসারিত করা।.

আমি কি কোনো ফিল্ডকে জিপ / পোস্টাল কোড অনুসন্ধানের জন্য ব্যবহার করতে পারি?

হ্যাঁ। একটি সিঙ্গেল লাইন টেক্সট ফিল্ডে, অ্যাড্রেস অটোকমপ্লিট চালু করুন এবং তারপর পোস্টাল কোড লুকআপ চালু করুন। ফিল্ডটি জিপ/পোস্টাল কোডের পরামর্শ দেখায়, এবং সেগুলোর মধ্যে একটি নির্বাচন করলে আপনার নির্বাচিত শহর এবং রাজ্য/অঞ্চল ফিল্ডগুলো (লুকানোগুলো সহ) পূরণ হয়ে যায়। “আপনার এলাকা যাচাই করুন” ধরনের ফর্ম এবং CRM রাউটিংয়ের জন্য এটি খুবই উপযোগী।.