खास जानकारी
Google Maps Platform, वेब (JS, TS), Android, और iOS के लिए उपलब्ध है. यह जगहों, रास्तों, और दूरी के बारे में जानकारी पाने के लिए, वेब सेवाओं के एपीआई भी उपलब्ध कराता है. इस गाइड में दिए गए सैंपल एक प्लैटफ़ॉर्म के लिए हैं. हालांकि, दस्तावेज़ के लिंक भी दिए गए हैं, ताकि इन्हें अन्य प्लैटफ़ॉर्म पर लागू किया जा सके.
उपयोगकर्ताओं के लिए लेन-देन के स्टेटमेंट को समझना अक्सर मुश्किल होता है. कारोबारी या कंपनी के नाम जैसे कि “Acme Houseware” जैसे छोटे नामों का इस्तेमाल करें. इससे ग्राहक सहायता के लिए कॉल बढ़ सकती है और विवाद बढ़ सकते हैं. बेहतर लेन-देन की मदद से, इन लेन-देन को आसान बनाया जा सकता है और कारोबारी या कंपनी का पूरा नाम और कारोबार की कैटगरी, स्टोर के सामने के हिस्से की फ़ोटो, मैप पर उसके पते और जगह की जानकारी, और संपर्क की पूरी जानकारी वगैरह देकर, इन लेन-देन को आसान बनाया जा सकता है. इससे उपयोगकर्ता को ज़्यादा संतुष्टि और पारदर्शिता मिलती है. साथ ही, ग्राहक सहायता कॉल की संख्या कम हो सकती है, एनपीएस बढ़ सकता है, और ऐप्लिकेशन इस्तेमाल करने में ज़्यादा समय लग सकता है.
बेहतर लेन-देन—इस विषय में, लागू करने की गाइड और कस्टमाइज़ेशन के बारे में सलाह दी जाती है. हम आपको लेन-देन के इतिहास का बेहतरीन अनुभव देने के लिए, Google Maps Platform API के बेहतर कॉम्बिनेशन के तौर पर सुझाव देते हैं. इस गाइड में बताए गए तरीके से, किसी कारोबारी या कंपनी की जगह की जानकारी को मैच करने और उसकी पूरी जानकारी देखने का तरीका बताया गया है.
एपीआई चालू करना
बेहतर लेन-देन की सुविधा लागू करने के लिए, आपको Google Cloud Console में इन एपीआई को चालू करना होगा. आपके चुने गए प्रोजेक्ट के लिए हर एपीआई को चालू करने के लिए, नीचे दिए गए हाइपरलिंक आपको Google Cloud Console पर भेजते हैं:
- Places API.
- जियोकोडिंग एपीआई.
- Maps Metrics API, Android के लिए Maps SDK टूल या iOS के लिए Maps SDK टूल.
लागू करने से जुड़ी गाइड के सेक्शन
नीचे इस विषय में लागू किए जाने वाले वे तरीके और कस्टमाइज़ेशन दिए गए हैं जिन पर हम चर्चा करेंगे.
- सही का निशान आइकॉन, इसे लागू करने का मुख्य चरण है.
- स्टार आइकॉन का इस्तेमाल करना ज़रूरी नहीं है. हालांकि, इसे बेहतर बनाने के लिए, इसे बदलाव करने का सुझाव दिया जाता है.
Google Maps Platform की मदद से व्यापारी/कंपनी/कारोबारी का डेटा मैच करना | लेन-देन के इतिहास में व्यापारी/कंपनी को Google Maps Platform में किसी जगह से जोड़ना. | |
कारोबारी या कंपनी की जानकारी दिखाना | ज़्यादा डेटा वाले ऐसे लेन-देन दिखाएं जिनमें व्यापारी/कंपनी/कारोबारी के बारे में ज़रूरी जानकारी दिखती हो, ताकि उपयोगकर्ता तुरंत लेन-देन की पहचान कर सकें. | |
व्यापारी/कंपनी की जगह का मैप जोड़ना | कारोबारी या कंपनी की जगह का मैप जोड़ें. |
Google Maps Platform से मिलते-जुलते व्यापारी/कंपनी/कारोबारी
इस उदाहरण में इनका इस्तेमाल किया गया है: जगहें एपीआई |
नीचे दिया गया डायग्राम दिखाता है कि कैसे आपका ऐप्लिकेशन, व्यापारियों/कंपनियों के किसी मौजूदा डेटाबेस से या जगह की जानकारी के अनुरोध के ज़रिए, जगह की जानकारी का इस्तेमाल करके नतीजे देने के लिए व्यापारी/कंपनी के लेन-देन से मेल खाता है:
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 महीने में जगह के आईडी रीफ़्रेश करें.
अगर व्यापारी/कंपनी/कारोबारी ने जगह की जो जानकारी दिखाई है, वह उस जगह से मेल नहीं खाती है जहां उन्होंने लेन-देन किया था, तो हमारा सुझाव है कि आप उपयोगकर्ताओं को व्यापारी मिलान की क्वालिटी के बारे में सुझाव देने दें.
कारोबारी या कंपनी की जानकारी दिखाई जा रही है
इस उदाहरण में इनका इस्तेमाल किया गया है: जगहें एपीआई | यह भी उपलब्ध है: Android के लिए Places SDK टूल | iOS के लिए Places SDK टूल | Place Library, Maps JavaScript 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
कारोबारी या कंपनी की जगह का मैप जोड़ना
इस उदाहरण में इनका इस्तेमाल किया गया है: जियोकोडिंग एपीआई | मैप स्टैटिक एपीआई | ये भी उपलब्ध हैं: Android | iOS |
कारोबारी की जगह की जानकारी का पता लगाया जा रहा है
Maps स्टैटिक एपीआई मार्कर लगाने के लिए पते या निर्देशांक स्वीकार करता है. अगर आपके कारोबारी या कंपनी के रिकॉर्ड में पहले से ही कोई पता मौजूद है, तो सीधे अगले सेक्शन पर जाया जा सकता है. हालांकि, हमारा सुझाव है कि मैप की सटीक जानकारी पाने के लिए, आप पतों के बजाय निर्देशांक इस्तेमाल करें.
अगर आपके व्यापारी डेटाबेस में सड़कों के पते हैं, लेकिन भौगोलिक निर्देशांक नहीं हैं और आपने जगह की जानकारी का अनुरोध पहले से नहीं किया है, तो आप सड़क के पतों को सर्वर साइड पर अक्षांश/देशांतर निर्देशांक में बदलने, अपने डेटाबेस में निर्देशांक सेव करने, और कम से कम हर 30 दिन में एक बार निर्देशांक रीफ़्रेश करने के लिए Geocoding API का इस्तेमाल कर सकते हैं.
Google ताइपेई के ऑफ़िस का जगह आईडी का अक्षांश और देशांतर पाने के लिए, Geocoding API का इस्तेमाल करने का एक उदाहरण यहां दिया गया है:
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 |
कारोबारी या कंपनी के लोकेशन मार्कर (यूआरएल एन्कोडिंग का इस्तेमाल करना) | मार्कर=रंग:red%7C25.033976%2C121.5645389 |
क्लाउड-आधारित मैप की स्टाइल | map_id=b224095f76859890 |
एपीआई पासकोड | key=YOUR_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
पैरामीटर के अन्य विकल्पों के बारे में जानने के लिए, Maps का स्टैटिक एपीआई दस्तावेज़ देखें.
अपने मोबाइल ऐप्लिकेशन पर मैप जोड़ना
अगर Android के लिए Maps SDK या iOS के लिए Maps SDK का इस्तेमाल किया जा रहा है, तो जगह की जानकारी में दी गई जानकारी के निर्देशांक इस्तेमाल करके मार्कर लगाया जा सकता है.
आपके उपयोगकर्ताओं को ब्राउज़ या नेविगेट करने के बजाय लेन-देन की पुष्टि करने के लिए मैप दिखाई देगा, इसलिए सीमित इंटरैक्टिविटी वाला मैप चुनें:
- Android ऐप्लिकेशन के लिए, मार्कर ट्यूटोरियल के साथ मैप जोड़ना देखें और सीमित इंटरैक्टिविटी देने के लिए, लाइट मोड चालू करें.
- iOS ऐप्लिकेशन के लिए, मार्कर ट्यूटोरियल के साथ मैप जोड़ना देखें और
GMSUiSettings
फ़्लैग के साथ कंट्रोल और जेस्चर बंद करें.