সমৃদ্ধ লেনদেন বাস্তবায়ন নির্দেশিকা

ওভারভিউ

ওয়েব আইওএস এপিআই

Google মানচিত্র প্ল্যাটফর্ম ওয়েব (JS, TS), Android, এবং iOS-এর জন্য উপলব্ধ, এবং স্থান, দিকনির্দেশ এবং দূরত্ব সম্পর্কে তথ্য পাওয়ার জন্য ওয়েব পরিষেবা APIগুলিও অফার করে৷ এই গাইডের নমুনাগুলি একটি প্ল্যাটফর্মের জন্য লেখা হয়েছে, তবে অন্যান্য প্ল্যাটফর্মে বাস্তবায়নের জন্য ডকুমেন্টেশন লিঙ্কগুলি প্রদান করা হয়েছে।

"Acme Houseware" এর মতো বণিক নামের পরিবর্তে "ACMEHCORP" এর মতো সংক্ষিপ্ত রূপ ব্যবহার করে ব্যবহারকারীদের জন্য লেনদেনের বিবৃতিগুলি বোঝা প্রায়শই কঠিন হয়, যা গ্রাহক সহায়তা কল এবং ব্যয়বহুল বিরোধের কারণ হতে পারে৷ সমৃদ্ধ লেনদেনগুলি এই লেনদেনগুলিকে সহজ করে তোলে এবং একজন বণিকের পুরো নাম এবং ব্যবসার বিভাগ, স্টোরফ্রন্টের একটি ফটো, মানচিত্রের ঠিকানা এবং অবস্থান, সম্পূর্ণ যোগাযোগের তথ্য এবং আরও অনেক কিছু প্রদান করে তাদের স্বজ্ঞাত করে তোলে৷ এটি ব্যবহারকারীর সন্তুষ্টি এবং স্বচ্ছতা বাড়াতে সাহায্য করে এবং গ্রাহক সহায়তা কলগুলিও কমাতে পারে, এনপিএস বাড়াতে পারে এবং অ্যাপ-এর মধ্যে বেশি সময় ব্যয় করতে পারে।

সমৃদ্ধ লেনদেন—এই বিষয়ে আমরা যে বাস্তবায়ন নির্দেশিকা এবং কাস্টমাইজেশন টিপস প্রদান করি—সেটিই আমরা Google মানচিত্র প্ল্যাটফর্ম API-এর সর্বোত্তম সংমিশ্রণ হিসাবে সুপারিশ করি যাতে ব্যবহারকারীর লেনদেনের ইতিহাসের দুর্দান্ত অভিজ্ঞতা তৈরি হয়৷ এই বাস্তবায়ন নির্দেশিকা আপনাকে দেখাবে কিভাবে একটি নির্দিষ্ট বণিকের সাথে একটি অবস্থান মেলাতে হয় এবং তাদের বিস্তারিত তথ্য দেখায়৷

সমৃদ্ধ লেনদেনের নমুনা পর্দা
সমৃদ্ধ লেনদেনের নমুনা স্ক্রীন (বড় করতে ক্লিক করুন)

এপিআই সক্ষম করুন

সমৃদ্ধ লেনদেন বাস্তবায়ন করতে, আপনাকে অবশ্যই Google ক্লাউড কনসোলে নিম্নলিখিত APIগুলি সক্রিয় করতে হবে৷ আপনার নির্বাচিত প্রকল্পের জন্য প্রতিটি API সক্ষম করতে নিম্নলিখিত হাইপারলিঙ্কগুলি আপনাকে Google ক্লাউড কনসোলে পাঠায়:

সেটআপ সম্পর্কে আরও তথ্যের জন্য, Google মানচিত্র প্ল্যাটফর্মের সাথে শুরু করা দেখুন।

বাস্তবায়ন গাইড বিভাগ

এখানে কভার করা বাস্তবায়ন এবং কাস্টমাইজেশন নিম্নরূপ:

  • চেক মার্ক আইকন একটি মূল বাস্তবায়ন পদক্ষেপ।
  • তারা আইকন একটি ঐচ্ছিক কিন্তু সমাধান উন্নত করার জন্য সুপারিশকৃত কাস্টমাইজেশন।
Google মানচিত্র প্ল্যাটফর্মের সাথে বণিকদের মেলান Google মানচিত্র প্ল্যাটফর্মে একটি স্থানের সাথে লেনদেনের ইতিহাসে একজন ব্যবসায়ীকে সংযুক্ত করা।
বণিক বিবরণ প্রদর্শন করুন ডেটা সমৃদ্ধ লেনদেন দেখান যা বণিক সম্পর্কে সহায়ক তথ্য দেখায়, যাতে ব্যবহারকারীরা দ্রুত লেনদেন চিনতে পারে৷
বণিক অবস্থানের একটি মানচিত্র যোগ করুন বণিক অবস্থানের একটি মানচিত্র যোগ করুন।

Google মানচিত্র প্ল্যাটফর্মের সাথে বণিকদের মেলান

এই উদাহরণটি ব্যবহার করে: স্থান API

নিম্নলিখিত চিত্রটি দেখায় যে কীভাবে আপনার অ্যাপ্লিকেশন বণিক লেনদেনের সাথে মেলে যাতে বণিকদের বিদ্যমান ডাটাবেস থেকে স্থানের বিবরণ ব্যবহার করে বা একটি স্থান অনুসন্ধান অনুরোধের মাধ্যমে ফলাফল ফেরত দেওয়া যায়:

বণিক মিলে ফ্লো ম্যাট্রিক্স
মার্চেন্ট ম্যাচিং ফ্লো ম্যাট্রিক্স (বড় করতে ক্লিক করুন)

Google মানচিত্র প্ল্যাটফর্ম স্থান আইডি পান

ব্যবসার নাম এবং ঠিকানার মতো মৌলিক তথ্য সহ আপনার কাছে ব্যবসায়ীদের একটি ডাটাবেস থাকতে পারে। Google মানচিত্র প্ল্যাটফর্মের সেই জায়গা সম্পর্কে যে তথ্য রয়েছে, যোগাযোগের তথ্য এবং ব্যবহারকারীর অবদানের তথ্য সহ, আপনার Google মানচিত্র প্ল্যাটফর্মের স্থান আইডি প্রয়োজন যা আপনার ডাটাবেসের প্রতিটি বণিকের সাথে সম্পর্কিত।

একটি ব্যবসার জন্য জায়গার আইডি পেতে, Places API-এ /findplacefromtext এন্ডপয়েন্টে একটি অনুরোধ করুন এবং শুধুমাত্র place_id ফিল্ডকে অনুরোধ করুন বিনা খরচে স্থান খুঁজুন - শুধুমাত্র আইডি কল হিসাবে অনুরোধটি বিল করার জন্য। যদি বণিকের একাধিক অবস্থান থাকে, তাহলে শহর বা রাস্তার নামের সাথে বণিকের নাম ব্যবহার করুন৷ কলের মাধ্যমে প্রত্যাবর্তিত ডেটার গুণমান পরিবর্তিত হয়, তাই আপনাকে যাচাই করতে হবে যে ফলাফলগুলি আসলেই বণিকের সাথে মেলে কিনা৷

এখানে বণিকের নাম এবং শহর ব্যবহার করে Google তাইপে অফিসের জন্য স্থান আইডি অনুরোধ করার একটি উদাহরণ রয়েছে:

```html
https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=google%20taipei&inputtype=textquery&fields=place_id&key=YOUR_API_KEY&solution_channel=GMP_guides_enrichedtransactions_v1_a
```

API অনুরোধে ইনপুট প্যারামিটারটি URL এনকোড করতে ভুলবেন না।

স্টোর প্লেস আইডি

ভবিষ্যতের অনুরোধের জন্য বণিক সম্পর্কে Google মানচিত্র প্ল্যাটফর্ম থেকে তথ্য সঞ্চয় করতে, আপনি বণিকের রেকর্ডের বৈশিষ্ট্য হিসাবে আপনার ডাটাবেসে অনির্দিষ্টকালের জন্য এই স্থান আইডি সংরক্ষণ করতে পারেন৷ আপনাকে প্রতি বণিকের জন্য শুধুমাত্র একবার স্থান খোঁজার অনুরোধ করতে হবে। এছাড়াও আপনি যখনই একজন ব্যবহারকারী লেনদেনের বিশদ বিবরণের অনুরোধ করেন তখন আপনি জায়গার আইডি অনুসন্ধান করতে পারেন।

আপনার কাছে সর্বদা সবচেয়ে সঠিক তথ্য আছে তা নিশ্চিত করতে, প্রতি 12 মাস অন্তর স্থান আইডি রিফ্রেশ করুন place_id প্যারামিটার সহ একটি স্থানের বিবরণ অনুরোধ ব্যবহার করে।

আপনি যে স্থানের বিশদগুলি প্রদর্শন করেছেন তা যদি বণিকের সাথে মেলে না যেখানে তারা লেনদেন পরিচালনা করেছে, আমরা আপনাকে পরামর্শ দিই যে আপনি ব্যবহারকারীদের মার্চেন্ট ম্যাচের গুণমান সম্পর্কে প্রতিক্রিয়া জানাতে অনুমতি দিন৷

বণিক বিবরণ প্রদর্শন করুন

এই উদাহরণটি ব্যবহার করে: স্থান API এছাড়াও উপলব্ধ: Android এর জন্য স্থান SDK | আইওএসের জন্য SDK রাখে | স্থান লাইব্রেরি, মানচিত্র জাভাস্ক্রিপ্ট API

আপনি স্থানের বিবরণ শেয়ার করতে পারেন যা ব্যবহারকারীরা আপনার অবস্থানগুলির একটিতে যাওয়ার পরে জানতে হবে৷ যোগাযোগের তথ্য, কাজের সময়, ব্যবহারকারীর রেটিং এবং ব্যবহারকারীর ফটোর মতো সমৃদ্ধ স্থানের বিবরণ সহ, আপনার অ্যাপ ব্যবহারকারীদের তাদের সম্পূর্ণ লেনদেনের কথা মনে করিয়ে দিতে পারে। Place Details পেতে Places API- এ একটি কল করার পর, আপনি একটি তথ্য উইন্ডো, একটি ওয়েব সাইডবারে, অথবা আমাদের পরিষেবার শর্তাবলীর সীমার মধ্যে আপনি যে কোনো উপায়ে প্রতিক্রিয়া ফিল্টার এবং রেন্ডার করতে পারেন৷

নমুনা বণিক বিবরণ স্ক্রীন
নমুনা বণিক বিবরণ স্ক্রীন (বড় করতে ক্লিক করুন)

স্থানের বিশদ বিবরণের জন্য অনুরোধ করতে, আপনার প্রতিটি অবস্থানের স্থানের আইডি প্রয়োজন। আপনার অবস্থানের স্থান আইডি পুনরুদ্ধার করতে স্থান আইডি প্রাপ্ত করা দেখুন।

নিম্নলিখিত স্থানের বিবরণ অনুরোধ Google তাইপেই 101 স্থান আইডির জন্য একটি json আউটপুটে ঠিকানা, স্থানাঙ্ক, ওয়েবসাইট, ফোন নম্বর, রেটিং এবং ঘন্টা প্রদান করে:

```html
https://maps.googleapis.com/maps/api/place/details/json?placeid=ChIJraeA2rarQjQRyAqIxkx2vN8&fields=name%2Cformatted_address%2Cwebsite%2Cformatted_phone_number%2Cgeometry/location%2Cicon%2Copening_hours%2Crating&key=YOUR_API_KEY&solution_channel=GMP_guides_enrichedtransactions_v1_a
```

বণিক অবস্থানের একটি মানচিত্র যোগ করুন

এই উদাহরণটি ব্যবহার করে: জিওকোডিং API | মানচিত্র স্ট্যাটিক API এছাড়াও উপলব্ধ: Android | iOS

ব্যবসায়ীর অবস্থান নির্ধারণ করুন

মানচিত্র স্ট্যাটিক API একটি ঠিকানা গ্রহণ করে বা একটি মার্কার স্থাপন করার জন্য স্থানাঙ্ক গ্রহণ করে। যদি আপনার বণিক রেকর্ডে ইতিমধ্যেই একটি ঠিকানা থাকে, তাহলে আপনি পরবর্তী বিভাগে যেতে পারেন, তবে আমরা মানচিত্র নির্ভুলতার জন্য ঠিকানাগুলির উপর স্থানাঙ্ক ব্যবহার করার পরামর্শ দিই।

যদি আপনার বণিক ডাটাবেসের রাস্তার ঠিকানা থাকে কিন্তু ভৌগলিক স্থানাঙ্ক না থাকে এবং আপনি ইতিমধ্যেই স্থানের বিবরণের জন্য অনুরোধ না করেন, তাহলে আপনি জিওকোডিং API ব্যবহার করতে পারেন রাস্তার ঠিকানাগুলিকে সার্ভারের পাশে অক্ষাংশ/দ্রাঘিমাংশ স্থানাঙ্কে রূপান্তর করতে, আপনার ডাটাবেসে স্থানাঙ্ক সঞ্চয় করতে এবং প্রতি 30 দিনে অন্তত একবার স্থানাঙ্ক রিফ্রেশ করতে পারেন।

গুগল তাইপেই অফিস প্লেস আইডির অক্ষাংশ এবং দ্রাঘিমাংশ পেতে জিওকোডিং API ব্যবহার করার একটি উদাহরণ এখানে দেওয়া হল:

```html
https://maps.googleapis.com/maps/api/geocode/json?place_id=ChIJraeA2rarQjQRyAqIxkx2vN8&key=YOUR_API_KEY&solution_channel=GMP_guides_enrichedtransactions_v1_a
```

একটি মানচিত্রে বণিক অবস্থানের জন্য একটি মার্কার যোগ করুন৷

যেহেতু আপনার ব্যবহারকারীরা ব্রাউজ বা নেভিগেট করার পরিবর্তে লেনদেন নিশ্চিত করতে মানচিত্র দেখতে পাবে, তাই আপনি একটি মানচিত্র তৈরি করতে চান যাতে সীমিত ইন্টারঅ্যাক্টিভিটি রয়েছে।

ডেস্কটপ এবং মোবাইল ওয়েবের জন্য, মার্চেন্টের অক্ষাংশ/দ্রাঘিমাংশ বা ঠিকানায় একটি একক মার্কার সহ একটি মানচিত্র স্ট্যাটিক API URL তৈরি করুন৷ আপনি একটি ওয়েব পরিষেবা কল ব্যবহার করে মানচিত্র স্ট্যাটিক API ব্যবহার করতে পারেন, যা আপনার নির্দিষ্ট করা প্যারামিটার প্রদত্ত একটি মানচিত্রের একটি চিত্র সংস্করণ তৈরি করবে। মোবাইলের জন্য, পরবর্তীতে এড়িয়ে যান আপনার মোবাইল অ্যাপ্লিকেশন বিভাগে একটি মানচিত্র যুক্ত করুন

নিম্নলিখিত কলটি ডিফল্ট জুম স্তরে Google তাইপে অফিসে একটি মার্কারকে কেন্দ্র করে 640x480px আকারের একটি রোডম্যাপ দেখায়৷ এটি একটি লাল বিতরণ অবস্থান চিহ্নিতকারী এবং একটি ক্লাউড-ভিত্তিক মানচিত্র শৈলীও নির্দিষ্ট করে:

```html
https://maps.googleapis.com/maps/api/staticmap?size=640x480&markers=color:red%7C25.033976%2C121.5645389&map_id=b224095f76859890&key=YOUR_API_KEY&signature=BASE64_SIGNATURE&solution_channel=GMP_guides_enrichedtransactions_v1_a
```

এই কলটি নিম্নলিখিত বিভাগে বিভক্ত:

API URL https://maps.googleapis.com/maps/api/staticmap?
ছবির আকার আকার = 640x480
বণিক অবস্থান চিহ্নিতকারী ( ইউআরএল এনকোডিং ব্যবহার করে) চিহ্নিতকারী=রঙ:লাল%7C25.033976%2C121.5645389
ক্লাউড-ভিত্তিক মানচিত্রের শৈলী map_id=b224095f76859890
API কী key= আপনার_API_KEY
ডিজিটাল স্বাক্ষর (কিভাবে ডিজিটালভাবে আপনার অনুরোধে স্বাক্ষর করবেন তা জানুন) স্বাক্ষর= BASE64_SIGNATURE
সমাধান চ্যানেল প্যারামিটার ( প্যারামিটার ডকুমেন্টেশন দেখুন) solution_channel=GMP_guides_enrichedtransactions_v1_a

এই ফলাফলটি নীচে দেখানো চিত্রে পরিণত হয়:

গুগল তাইপে অফিসের স্ট্যাটিক ম্যাপের ছবি

আপনি মার্কার অবস্থান হিসাবে একটি ঠিকানা ব্যবহার করতে পারেন:

```html
https://maps.googleapis.com/maps/api/staticmap?size=640x480&markers=color:green%7CTaipei%20101%20Tower%2CNo.%207信義路五段信義區台北市%20Taiwan%20110&map_id=b224095f76859890&key=YOUR_API_KEY&signature=BASE64_SIGNATURE&solution_channel=GMP_guides_enrichedtransactions_v1_a
```

অতিরিক্ত প্যারামিটার বিকল্পের জন্য, মানচিত্র স্ট্যাটিক API ডকুমেন্টেশন দেখুন।

আপনার মোবাইল অ্যাপ্লিকেশনে একটি মানচিত্র যোগ করুন

আপনি যদি Android এর জন্য Maps SDK বা iOS এর জন্য Maps SDK ব্যবহার করেন, তাহলে আপনি স্থানের বিবরণে তথ্য থেকে স্থানাঙ্ক ব্যবহার করে একটি মার্কার স্থাপন করতে পারেন।

যেহেতু আপনার ব্যবহারকারীরা ব্রাউজ বা নেভিগেট করার পরিবর্তে লেনদেন নিশ্চিত করতে মানচিত্র দেখতে পাবে, তাই সীমিত ইন্টারঅ্যাক্টিভিটি সহ একটি মানচিত্র চয়ন করুন: