बेहतर लेन-देन को लागू करने के बारे में जानकारी देने वाली गाइड

संग्रह की मदद से व्यवस्थित रहें अपनी प्राथमिकताओं के आधार पर, कॉन्टेंट को सेव करें और कैटगरी में बांटें.

खास जानकारी

वेब iOS एपीआई

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

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

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

बेहतर तरीके से किए गए लेन-देन के नमूने की स्क्रीन
बेहतर लेन-देन के नमूने की स्क्रीन (बड़ा करने के लिए क्लिक करें)

एपीआई चालू किए जा रहे हैं

बेहतर लेन-देन को लागू करने के लिए, आपको 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 आईडी की ज़रूरत होगी.

किसी कारोबार के लिए प्लेस आईडी पाने के लिए, 'जगहें' एपीआई में /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

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

जगह के आईडी सेव किए जा रहे हैं

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

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

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

व्यापारी/कंपनी की जानकारी दिख रही है

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

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

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

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

जगह की जानकारी के इस अनुरोध में, Google Taipei 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

व्यापारी/कंपनी की जगह का मैप जोड़ना

इस उदाहरण में, जियोकोडिंग एपीआई | Maps स्टैटिक एपीआई का इस्तेमाल किया गया है ये सुविधाएं भी उपलब्ध हैं: Android | iOS

व्यापारी/कंपनी की जगह का पता लगाना

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

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

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

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 ताइपे के ऑफ़िस में, डिफ़ॉल्ट ज़ूम लेवल पर एक मार्कर के बीच में दिखता है. यह रेड डिलीवरी लोकेशन मार्कर और क्लाउड-आधारित मैप स्टाइल भी बताता है:

    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?
इमेज का साइज़ साइज़=640x480
व्यापारी की जगह की जानकारी देने वाले मार्कर (यूआरएल एन्कोडिंग का इस्तेमाल करके) मार्कर=color:red%7C25.033976%2C121.5645389
क्लाउड पर आधारित मैप की शैली map_id=b224095f76859890
एपीआई कुंजी कुंजी=YOUR_API_KEY
डिजिटल हस्ताक्षर (अपने अनुरोध पर डिजिटल तरीके से हस्ताक्षर करने का तरीका जानें) हस्ताक्षर=BASE64_SIGNATURE
समाधान चैनल पैरामीटर (पैरामीटर दस्तावेज़ देखें) समाधान_चैनल=GMP_guides_enrichedtransactions_v1_a

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

Google Taipei Office की स्टैटिक मैप इमेज

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

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 में स्टैटिक एपीआई के दस्तावेज़ देखें.

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

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

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