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

ওভারভিউ

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

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 তাইপে অফিসের জন্য স্থান আইডি অনুরোধ করার একটি উদাহরণ রয়েছে:

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 আউটপুটে ঠিকানা, স্থানাঙ্ক, ওয়েবসাইট, ফোন নম্বর, রেটিং এবং ঘন্টা প্রদান করে:

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 ব্যবহার করার একটি উদাহরণ এখানে দেওয়া হল:

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 আকারের একটি রোডম্যাপ দেখায়৷ এটি একটি লাল বিতরণ অবস্থান চিহ্নিতকারী এবং একটি ক্লাউড-ভিত্তিক মানচিত্র শৈলীও নির্দিষ্ট করে:

    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

এটি নীচে দেখানো চিত্র হয়ে ওঠে:

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

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

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 ব্যবহার করেন, তাহলে আপনি স্থানের বিবরণে তথ্য থেকে স্থানাঙ্ক ব্যবহার করে একটি মার্কার স্থাপন করতে পারেন।

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