खास जानकारी
Google Maps Platform, वेब (JS, TS), Android, और iOS के लिए उपलब्ध है. साथ ही, यह जगहों, रास्तों, और दूरी के बारे में जानकारी पाने के लिए, वेब सर्विस एपीआई की सुविधा भी देता है. इस गाइड में दिए गए सैंपल एक प्लैटफ़ॉर्म के लिए लिखे गए हैं, लेकिन दस्तावेज़ों के लिंक दिए गए हैं, ताकि दूसरे प्लैटफ़ॉर्म पर लागू किया जा सके.
लेन-देन के ब्यौरे को समझना मुश्किल होता है. इसलिए, "Acme Houseware" जैसे व्यापारी/कंपनी के नाम के बजाय, "ACMEHCORP" जैसे छोटे नामों का इस्तेमाल करना. इससे, ग्राहकों को सहायता के लिए कॉल करने और महंगे विवादों की संभावना बढ़ सकती है. बेहतर लेन-देन से, इन लेन-देन को आसान बनाया जा सकता है. साथ ही, व्यापारी/कंपनी का पूरा नाम और कारोबार की कैटगरी, स्टोरफ़्रंट की फ़ोटो, मैप पर उसका पता और जगह, संपर्क की पूरी जानकारी वगैरह देकर, इन लेन-देन को आसान बनाया जा सकता है. इससे उपयोगकर्ताओं को संतुष्टि और पारदर्शिता बढ़ाने में मदद मिलती है. साथ ही, ग्राहक सहायता वाले कॉल कम हो सकते हैं, एनपीएस बढ़ सकता है, और ऐप्लिकेशन में ज़्यादा समय बिताया जा सकता है.
बेहतर लेन-देन—लागू करने की गाइड और कस्टमाइज़ेशन के सुझाव, जो हमने इस विषय में दिए हैं—हम Google Maps Platform API के बेहतरीन कॉम्बिनेशन के तौर पर इनका सुझाव देते हैं. इससे उपयोगकर्ताओं को लेन-देन का इतिहास बेहतर बनाने में मदद मिलेगी. लागू करने की इस गाइड में आपको किसी जगह का किसी खास व्यापारी/कंपनी से मिलान करने और उनकी पूरी जानकारी दिखाने का तरीका पता चलेगा.
एपीआई चालू करना
बेहतर ट्रांज़ैक्शन की सुविधा लागू करने के लिए, आपको Google Cloud Console में, इन एपीआई को चालू करना होगा. यहां दिए गए हाइपरलिंक, आपके चुने हुए प्रोजेक्ट के लिए हर एपीआई को चालू करने के लिए आपको Google Cloud Console पर भेजते हैं:
- जगहें एपीआई.
- जियोकोडिंग एपीआई.
- Maps स्टैटिक एपीआई, Android के लिए Maps SDK टूल या iOS के लिए Maps SDK टूल.
लागू करने से जुड़ी गाइड वाले सेक्शन
इस विषय में हम जिन तरीकों और कस्टमाइज़ेशन पर बात करेंगे उनके बारे में नीचे बताया गया है.
- सही के निशान वाला आइकॉन, इस सुविधा को लागू करने का एक मुख्य चरण है.
- स्टार आइकॉन को जोड़ना ज़रूरी नहीं है, लेकिन हमारा सुझाव है कि आप इसे अपनी पसंद के मुताबिक बनाना चाहें.
| व्यापारियों या कंपनियों को 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 ताइपेई ऑफ़िस के लिए जगह के आईडी के अनुरोध का उदाहरण दिया गया है:
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 टूल | जगहें लाइब्रेरी, Maps JavaScript API |
आपके पास, उस जगह की जानकारी शेयर करने का विकल्प है जो उपयोगकर्ताओं को आपके किसी भी जगह पर जाने के बाद पता होनी चाहिए. संपर्क जानकारी, काम के घंटे, उपयोगकर्ता रेटिंग, और उपयोगकर्ता की फ़ोटो जैसी जगह की पूरी जानकारी के साथ आपका ऐप्लिकेशन उपयोगकर्ताओं को उनके पूरे हो चुके लेन-देन की याद दिला सकता है. जगह की जानकारी पाने के लिए 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
व्यापारी/कंपनी की जगह का मैप जोड़ना
| इस उदाहरण में इनका इस्तेमाल किया गया है: जियोकोडिंग एपीआई | Maps स्टैटिक एपीआई | यह भी उपलब्ध है: Android | iOS |
व्यापारी/कंपनी की जगह की जानकारी का पता लगाना
Maps स्टैटिक API एक पता स्वीकार करता है या मार्कर लगाने के लिए कोऑर्डिनेट स्वीकार करता है. अगर आपके व्यापारी/कंपनी के रिकॉर्ड में पहले से ही कोई पता है, तो अगले सेक्शन पर जाना होगा. हालांकि, हमारा सुझाव है कि मैप की सटीक जानकारी के लिए, पतों के ऊपर कोऑर्डिनेट का इस्तेमाल करें.
अगर आपके मर्चेंट डेटाबेस में मोहल्ले के पते हैं, लेकिन भौगोलिक निर्देशांक नहीं हैं और आपने पहले से ही जगह की जानकारी का अनुरोध नहीं किया है, तो सर्वर साइड पर मोहल्ले के पतों को अक्षांश/देशांतर वाले कॉर्डिनेट में बदलने, अपने डेटाबेस में कोऑर्डिनेट स्टोर करने, और कोऑर्डिनेट को 30 दिन में कम से कम एक बार रीफ़्रेश करने के लिए, आप जियोकोडिंग एपीआई का इस्तेमाल कर सकते हैं.
यहां Google ताइपेइ ऑफ़िस प्लेस आईडी के अक्षांश और देशांतर पाने के लिए जियोकोडिंग एपीआई के इस्तेमाल का उदाहरण दिया गया है:
https://maps.googleapis.com/maps/api/geocode/json?place_id=ChIJraeA2rarQjQRyAqIxkx2vN8&key=YOUR_API_KEY&solution_channel=GMP_guides_enrichedtransactions_v1_a
मैप पर व्यापारी/कंपनी की जगह का मार्कर जोड़ना
आपके उपयोगकर्ताओं को ब्राउज़ करने या नेविगेट करने के बजाय, लेन-देन की पुष्टि करने के लिए मैप दिखेगा. इसलिए, आपको एक ऐसा मैप बनाना है जिसमें सीमित इंटरैक्टिविटी हो.
डेस्कटॉप और मोबाइल वेब के लिए, व्यापारी/कंपनी के अक्षांश/देशांतर या पते पर एक मार्कर के साथ Maps का स्टैटिक एपीआई यूआरएल बनाएं. Maps स्टैटिक API को वेब सर्विस कॉल की मदद से इस्तेमाल किया जा सकता है. इससे, आपके तय किए गए पैरामीटर के हिसाब से, मैप का इमेज वर्शन बन जाता है. मोबाइल के लिए, सीधे अपने मोबाइल ऐप्लिकेशन वाले सेक्शन में मैप जोड़ना पर जाएं.
नीचे दिया गया कॉल, एक रोडमैप दिखाता है. इसका साइज़ 640x480px है. इसे डिफ़ॉल्ट ज़ूम लेवल पर, 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 |
| क्लाउड-आधारित मैप स्टाइल | Maps_id=b224095f76859890 |
| एपीआई पासकोड | कुंजी=Your_API_KEY |
| डिजिटल हस्ताक्षर (अपने अनुरोध पर डिजिटल तरीके से हस्ताक्षर करने का तरीका जानें) | हस्ताक्षर=BASE64_SIGNATURE |
| सलूशन चैनल पैरामीटर (पैरामीटर का दस्तावेज़ देखें) | समाधान_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
पैरामीटर के अन्य विकल्पों के लिए, Maps स्टैटिक एपीआई का दस्तावेज़ देखें.
अपने मोबाइल ऐप्लिकेशन पर मैप जोड़ना
अगर Android के लिए Maps SDK टूल या iOS के लिए Maps SDK टूल का इस्तेमाल किया जा रहा है, तो जगह की जानकारी में दी गई जानकारी से मिले कॉर्डिनेट का इस्तेमाल करके एक मार्कर लगाया जा सकता है.
आपके उपयोगकर्ताओं को ब्राउज़ या नेविगेट करने के बजाय लेन-देन की पुष्टि करने के लिए मैप दिखेगा, इसलिए सीमित इंटरैक्टिविटी वाला मैप चुनें:
- Android ऐप्लिकेशन के लिए, मार्कर ट्यूटोरियल के साथ मैप जोड़ना देखें और सीमित इंटरैक्ट करने के लिए, लाइट मोड चालू करें.
- iOS ऐप्लिकेशन के लिए, मार्कर ट्यूटोरियल के साथ मैप जोड़ना देखें और
GMSUiSettingsफ़्लैग के साथ कंट्रोल और जेस्चर बंद करें.