बेहतर ट्रांज़ैक्शन लागू करने की गाइड

खास जानकारी

वेब iOS एपीआई

Google Maps Platform, वेब (JS, TS), Android, और iOS के लिए उपलब्ध है. साथ ही, यह जगहों, निर्देशों, और दूरियों के बारे में जानकारी पाने के लिए, वेब सेवाओं के एपीआई भी उपलब्ध कराता है. इस गाइड में दिए गए सैंपल, एक प्लैटफ़ॉर्म के लिए लिखे गए हैं. हालांकि, अन्य प्लैटफ़ॉर्म पर लागू करने के लिए दस्तावेज़ के लिंक दिए गए हैं.

उपयोगकर्ताओं के लिए, लेन-देन की जानकारी वाले स्टेटमेंट को समझना अक्सर मुश्किल होता है. ऐसा इसलिए होता है, क्योंकि "Acme Houseware" जैसे व्यापारी/कंपनी के नाम के बजाय, "ACMEHCORP" जैसे छोटे नाम इस्तेमाल किए जाते हैं. इससे, ग्राहक सहायता टीम को ज़्यादा कॉल मिलते हैं और विवादों को सुलझाने में ज़्यादा खर्च होता है. बेहतर लेन-देन की सुविधा, इन लेन-देन को आसान बनाती है और उन्हें सहज बनाती है. इसके लिए, यह सुविधा व्यापारी/कंपनी का पूरा नाम और कारोबार की कैटगरी, स्टोरफ़्रंट की फ़ोटो, मैप पर उसका पता और जगह, पूरी संपर्क जानकारी वगैरह देती है. इससे, उपयोगकर्ता की संतुष्टि और पारदर्शिता बढ़ती है. साथ ही, इससे ग्राहक सहायता टीम को मिलने वाले कॉल की संख्या कम हो सकती है, एनपीएस बढ़ सकता है, और ऐप्लिकेशन में ज़्यादा समय बिताया जा सकता है.

बेहतर लेन-देन की जानकारी—इस विषय में, हम लागू करने के लिए गाइड और पसंद के मुताबिक बनाने के सुझाव देते हैं. हमारा सुझाव है कि लेन-देन के इतिहास के बेहतर उपयोगकर्ता अनुभव बनाने के लिए, Google Maps Platform के एपीआई का इस्तेमाल करें. लागू करने से जुड़ी इस गाइड में, किसी जगह को किसी खास व्यापारी/कंपनी से मैच करने और उसकी पूरी जानकारी दिखाने का तरीका बताया गया है.

बेहतर लेन-देन की जानकारी वाली सैंपल स्क्रीन
ज़्यादा जानकारी वाले लेन-देन की सैंपल स्क्रीन (बड़ा करने के लिए क्लिक करें)

एपीआई चालू करें

बेहतर जानकारी वाले लेन-देन की सुविधा लागू करने के लिए, आपको Google Cloud Console में ये एपीआई चालू करने होंगे. चुने गए प्रोजेक्ट के लिए हर एपीआई को चालू करने के लिए, यहां दिए गए हाइपरलिंक आपको Google Cloud Console पर ले जाते हैं:

सेटअप के बारे में ज़्यादा जानने के लिए, Google Maps Platform का इस्तेमाल शुरू करना लेख पढ़ें.

लागू करने की गाइड के सेक्शन

यहां लागू करने और पसंद के मुताबिक बनाने के बारे में बताया गया है:

  • सही के निशान का आइकॉन, लागू करने का मुख्य चरण है.
  • स्टार आइकॉन का इस्तेमाल करना ज़रूरी नहीं है. हालांकि, समाधान को बेहतर बनाने के लिए, इसे पसंद के मुताबिक बनाने का सुझाव दिया जाता है.
Google Maps Platform की मदद से कारोबारियों या कंपनियों को मैच करना लेन-देन के इतिहास में मौजूद किसी कारोबारी या कंपनी को, Google Maps Platform में मौजूद किसी जगह से जोड़ना.
कारोबारी या कंपनी की जानकारी दिखाना ज़्यादा डेटा वाले लेन-देन दिखाएं, जिनमें कारोबारी या कंपनी के बारे में काम की जानकारी हो. इससे उपयोगकर्ता, लेन-देन को तुरंत पहचान पाएंगे.
कारोबारी की जगह का मैप जोड़ना कारोबारी या कंपनी की जगह का मैप जोड़ें.

Google Maps Platform की मदद से कारोबारियों या कंपनियों को मैच करना

इस उदाहरण में इनका इस्तेमाल किया गया है: Places API

नीचे दिए गए डायग्राम में दिखाया गया है कि आपका ऐप्लिकेशन, कारोबारी या कंपनी के मौजूदा डेटाबेस से जगह की जानकारी का इस्तेमाल करके या जगह खोजने के अनुरोध के ज़रिए, कारोबारी या कंपनी के लेन-देन से मैच कैसे करता है, ताकि नतीजा दिखाया जा सके:

कारोबारी या कंपनी की जानकारी मैच करने का फ़्लो मैट्रिक्स
कारोबारी से मैच करने वाले फ़्लो मैट्रिक (बड़ा करने के लिए क्लिक करें)

Google Maps Platform के प्लेस आईडी पाना

आपके पास व्यापारियों/कंपनियों/कारोबारियों का डेटाबेस हो सकता है. इसमें कारोबार का नाम और पता जैसी बुनियादी जानकारी शामिल हो सकती है. Google Maps Platform पर उस जगह के बारे में जानकारी पाने के लिए, आपको Google Maps Platform का प्लेस आईडी चाहिए. इसमें संपर्क जानकारी और उपयोगकर्ता की दी गई जानकारी शामिल है. यह आईडी, आपके डेटाबेस में मौजूद हर कारोबारी या कंपनी से जुड़ा होता है.

किसी कारोबार का प्लेस आईडी पाने के लिए, 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
```

एपीआई अनुरोध में, इनपुट पैरामीटर को यूआरएल कोड में बदलना न भूलें.

स्टोर की जगह के आईडी

आने वाले समय में किए जाने वाले अनुरोधों के लिए, Google Maps Platform से व्यापारी/कंपनी/कारोबारी की जानकारी सेव करने के लिए, अपने डेटाबेस में इस प्लेस आईडी को व्यापारी/कंपनी/कारोबारी के रिकॉर्ड के एट्रिब्यूट के तौर पर हमेशा के लिए सेव किया जा सकता है. आपको हर कारोबारी के लिए, जगह ढूंढने का अनुरोध सिर्फ़ एक बार करना होगा. जब भी कोई उपयोगकर्ता लेन-देन की जानकारी का अनुरोध करता है, तब भी प्लेस आईडी को खोजा जा सकता है.

यह पक्का करने के लिए कि आपको हमेशा सबसे सटीक जानकारी मिले, place_id पैरामीटर के साथ जगह की जानकारी का अनुरोध करके, हर 12 महीने में जगह के आईडी रीफ़्रेश करें.

अगर आपने जगह की जानकारी में जो जानकारी दिखाई है वह उस कारोबारी या कंपनी से मेल नहीं खाती जहां उपयोगकर्ता ने लेन-देन किया है, तो हमारा सुझाव है कि आप उपयोगकर्ताओं को कारोबारी या कंपनी से मैच करने की क्वालिटी के बारे में सुझाव/राय देने की अनुमति दें.

कारोबारी या कंपनी की जानकारी दिखाना

इस उदाहरण में इनका इस्तेमाल किया गया है: Places API यह भी उपलब्ध है: Android के लिए Places SDK टूल | iOS के लिए Places SDK टूल | Places Library, Maps JavaScript API

आपके पास, अपनी किसी जगह पर आने के बाद उपयोगकर्ताओं को बताने के लिए, जगह की जानकारी शेयर करने का विकल्प होता है. जगह की ज़्यादा जानकारी, जैसे कि संपर्क जानकारी, कारोबार के खुले होने का समय, उपयोगकर्ता की रेटिंग, और उपयोगकर्ता की फ़ोटो की मदद से, आपका ऐप्लिकेशन उपयोगकर्ताओं को उनके पूरे किए गए लेन-देन की याद दिला सकता है. जगह की जानकारी पाने के लिए Places API को कॉल करने के बाद, रिस्पॉन्स को जानकारी वाली विंडो, वेब साइडबार या अपनी सेवा की शर्तों के मुताबिक किसी भी तरीके से फ़िल्टर और रेंडर किया जा सकता है.

कारोबारी या कंपनी की जानकारी वाली स्क्रीन का सैंपल
कारोबारी/कंपनी की जानकारी वाली सैंपल स्क्रीन (बड़ा करने के लिए क्लिक करें)

जगह की जानकारी का अनुरोध करने के लिए, आपको अपनी हर जगह का प्लेस आईडी चाहिए होगा. अपनी जगह का प्लेस आईडी पाने के लिए, प्लेस आईडी पाना देखें.

जगह की जानकारी के लिए किया गया यह अनुरोध, Google Taipei 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
```

कारोबारी की जगह का मैप जोड़ना

इस उदाहरण में इनका इस्तेमाल किया गया है: Geocoding API | Maps Static API यह सुविधा इन पर भी उपलब्ध है: Android | iOS

कारोबारी या कंपनी की जगह की जानकारी

Maps Static API, मार्कर डालने के लिए पता या निर्देशांक स्वीकार करता है. अगर आपके कारोबारी रिकॉर्ड में पहले से ही कोई पता मौजूद है, तो अगले सेक्शन पर जाएं. हालांकि, हमारा सुझाव है कि मैप पर जगह की सटीक जानकारी देने के लिए, पते के बजाय निर्देशांक का इस्तेमाल करें.

अगर आपके व्यापारी/कंपनी/कारोबारी के डेटाबेस में सड़क के पते हैं, लेकिन भौगोलिक निर्देशांक नहीं हैं और आपने पहले से जगह की जानकारी का अनुरोध नहीं किया है, तो सड़क के पतों को सर्वर साइड पर अक्षांश/देशांतर निर्देशांक में बदलने के लिए, Geocoding API का इस्तेमाल किया जा सकता है. साथ ही, निर्देशांक को अपने डेटाबेस में सेव किया जा सकता है और कम से कम हर 30 दिन में एक बार निर्देशांक रीफ़्रेश किए जा सकते हैं.

यहां Google के ताइपे़ ऑफ़िस के प्लेस आईडी का अक्षांश और देशांतर पाने के लिए, Geocoding API का इस्तेमाल करने का उदाहरण दिया गया है:

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

मैप पर व्यापारी/कंपनी/कारोबारी की जगह के लिए मार्कर जोड़ना

आपके उपयोगकर्ता, लेन-देन की पुष्टि करने के लिए मैप को ब्राउज़ या नेविगेट करने के बजाय देखेंगे. इसलिए, आपको ऐसा मैप बनाना होगा जिसमें इंटरैक्टिविटी सीमित हो.

डेस्कटॉप और मोबाइल वेब के लिए, कारोबारी/कंपनी/कारोबारी की जगह के अक्षांश/देशांतर या पते पर, एक मार्कर वाला Maps स्टैटिक एपीआई यूआरएल बनाएं. वेब सेवा कॉल का इस्तेमाल करके, Maps के स्टैटिक एपीआई का इस्तेमाल किया जा सकता है. इससे, आपके दिए गए पैरामीटर के हिसाब से मैप का इमेज वर्शन बन जाएगा. मोबाइल के लिए, अगले अपने मोबाइल ऐप्लिकेशन सेक्शन में मैप जोड़ें पर जाएं.

इस कॉल में, 640x480 पिक्सल का रोडमैप दिखाया गया है. यह रोडमैप, Google के ताइपे़ ऑफ़िस के मार्कर पर केंद्रित है. साथ ही, इसमें ज़ूम लेवल डिफ़ॉल्ट पर सेट है. इसमें डिलीवरी की जगह का लाल मार्कर और क्लाउड पर मैप की स्टाइल की जानकारी भी दी गई है:

```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
```

इस कॉल को इन सेक्शन में बांटा गया है:

एपीआई यूआरएल 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

इस नतीजे से, नीचे दिखाई गई इमेज बनती है:

Google के ताइपेई ऑफ़िस के मैप की स्टैटिक इमेज

मार्कर की जगह के तौर पर पते का इस्तेमाल भी किया जा सकता है:

```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
```

पैरामीटर के अन्य विकल्पों के लिए, Maps Static API का दस्तावेज़ देखें.

अपने मोबाइल ऐप्लिकेशन पर मैप जोड़ना

अगर Android के लिए Maps SDK टूल या iOS के लिए Maps SDK टूल का इस्तेमाल किया जा रहा है, तो जगह की जानकारी में दी गई जानकारी के निर्देशांक का इस्तेमाल करके मार्कर लगाया जा सकता है.

आपके उपयोगकर्ता, ब्राउज़ करने या नेविगेट करने के बजाय, लेन-देन की पुष्टि करने के लिए मैप देखेंगे. इसलिए, सीमित इंटरैक्टिविटी वाला मैप चुनें: