Geocoding API एक ऐसी सेवा है जो किसी जगह की जानकारी को पते, अक्षांश और देशांतर के निर्देशांक या जगह के आईडी के तौर पर स्वीकार करती है. यह पते को अक्षांश और देशांतर निर्देशांक और जगह के आईडी में बदलता है. इसके अलावा, यह अक्षांश और देशांतर निर्देशांक या जगह के आईडी को पते में बदलता है.
Geocoding API v4, हाइपरलोकल डेस्टिनेशन और अराइवल इंटेलिजेंस और कोर कोऑर्डिनेट-टू-ऐड्रेस रिज़ॉल्यूशन, दोनों सुविधाएं देता है. चाहे आपको लास्ट-माइल डिलीवरी, राइडशेयर या रास्ते के दिशा-निर्देशों की सुविधा देनी हो या मोहल्ले के पतों को निर्देशांकों में बदलना हो, v4 आपके इस्तेमाल के उदाहरण के हिसाब से, खास एंडपॉइंट उपलब्ध कराता है.
क्या आपको नहीं पता कि आपके ऐप्लिकेशन के लिए कौनसा एंडपॉइंट सही है? जियोकोडिंग का तरीका चुनना देखें.
Geocoding API की मदद से क्या-क्या किया जा सकता है
Geocoding API v4 में ये सुविधाएं और एंडपॉइंट शामिल हैं:
- डेस्टिनेशन खोजें: किसी पते, जगह के आईडी या निर्देशांकों से, डेस्टिनेशन पर पहुंचने की हाइपरलोकल जानकारी पाएं. इसमें बिल्डिंग के एंट्री पॉइंट, रूट किए जा सकने वाले नेविगेशन पॉइंट टोकन, बिल्डिंग और ग्राउंड की आउटलाइन, सब-डेस्टिनेशन, और आस-पास की लोकप्रिय जगहों की जानकारी शामिल है.
- किसी पते को जियोकोड करना: मोहल्ले के पतों को भौगोलिक निर्देशांकों और जगह के आईडी में बदलें (फ़ॉरवर्ड जियोकोडिंग).
- किसी जगह को जियोकोड करना: अक्षांश और देशांतर निर्देशांकों को किसी व्यक्ति के लिए आसानी से पढ़े जा सकने वाले मोहल्ले के पतों या प्रशासनिक इलाकों में बदलें (रिवर्स जियोकोडिंग).
- किसी जगह को जियोकोड करना: Google Maps पर मौजूद किसी जगह के आईडी के लिए, फ़ॉर्मैट किए गए पते की जानकारी और निर्देशांक पाएं.
यह कंट्रोल किया जा सकता है कि नतीजे कहां दिखें. साथ ही, नतीजों को किसी खास इलाके, देश या पिन कोड तक सीमित किया जा सकता है.
डेमो आज़माएं
Geocoding API कैसे काम करता है
Geocoding API v4, बुनियादी जियोकोडिंग के साथ-साथ डेस्टिनेशन खोजने की सुविधा भी देता है:
- डेस्टिनेशन सर्च (
SearchDestinations): यह किसी पते, जगह के आईडी या निर्देशांक के जोड़े को बेहतरDestinationऑब्जेक्ट में बदलता है. इस तरीके का इस्तेमाल तब करें, जब किसी जगह पर पहुंचना ज़रूरी हो. जैसे, बिल्डिंग के पसंदीदा एंट्री पॉइंट की पहचान करना, नेविगेशन पॉइंट टोकन का इस्तेमाल करके ड्राइवर को पिकअप या ड्रॉपऑफ़ पॉइंट पर भेजना, मैप पर बिल्डिंग के फ़ुटप्रिंट रेंडर करना या कई बिल्डिंग वाले कॉम्प्लेक्स में नेविगेट करना. - बेसिक जियोकोडिंग: यह पतों, निर्देशांकों, और जगह के आईडी को एक-दूसरे में बदलता है:
- जियोकोडिंग: यह "1600 Amphitheatre Parkway, Mountain View, CA" जैसे मोहल्ले के पतों को अक्षांश और देशांतर निर्देशांक या जगह का आईडी में बदलता है. इससे मैप मार्कर लगाने या मैप व्यू फ़्रेम को बीच में लाने में मदद मिलती है.
- रिवर्स जियोकोडिंग: यह अक्षांश और देशांतर निर्देशांक या जगह के आईडी को, मोहल्ले के ऐसे पतों में बदलता है जिन्हें कोई भी व्यक्ति आसानी से पढ़ सकता है. इससे, उपयोगकर्ता की ओर से मैप पर ड्रॉप की गई पिन, जगह चुनने वाले टूल या यूज़र इंटरफ़ेस (यूआई) डिसप्ले को समझने में मदद मिलती है.
- जगह की जियोकोडिंग: इससे Google Maps पर मौजूद किसी जगह के आईडी के लिए, पते की जानकारी और निर्देशांक मिलते हैं.
नीचे दी गई टेबल में, Geocoding API v4 के ज़रिए उपलब्ध संसाधनों की खास जानकारी दी गई है. साथ ही, हर तरीके से मिलने वाले डेटा की जानकारी भी दी गई है:
| डेटा के संसाधन | डेटा के आधार पर मिली जानकारी | जवाब का फ़ॉर्मैट |
|---|---|---|
| डेस्टिनेशन खोजना ( POST /v4/geocode/destinations)
|
यह हाइपरलोकल अराइवल इंटेलिजेंस दिखाता है: बिल्डिंग और ग्राउंड पॉलीगॉन (displayPolygon), फ़िज़िकल entrances, रूट किए जा सकने वाले navigationPoints (टोकन के साथ), हैरारकी वाले containingPlaces और subDestinations, रिलेशनल landmarks, और मुख्य जगह की जानकारी. मंज़िलें खोजना देखें.
|
|
| किसी पते को जियोकोड करना ( GET /v4/geocode/address)
|
यह पता, पते के कॉम्पोनेंट, और पते के टाइप दिखाता है. जियोकोड रिस्पॉन्स देखें. | |
| किसी जगह को जियोकोड करना ( GET /v4/geocode/location)
|
यह पता, पते के कॉम्पोनेंट, और पते के टाइप दिखाता है. रिवर्स जियोकोडिंग रिस्पॉन्स देखें. | |
| किसी जगह को जियोकोड करना ( GET /v4/geocode/places)
|
यह पता, पते के कॉम्पोनेंट, और पते के टाइप दिखाता है. जगह की जियोकोडिंग का रिस्पॉन्स देखें. |
लॉन्च स्टेज चैनल
Geocoding API के वर्शन 4 में, GA, झलक, और एक्सपेरिमेंट के तौर पर उपलब्ध सुविधाओं के लिए अलग-अलग चैनल हैं. अगर आपको झलक या एक्सपेरिमेंट के तौर पर उपलब्ध सुविधाओं का इस्तेमाल करना है, तो अपने अनुरोध में सही चैनल की जानकारी दें. उदाहरण के लिए, एक्सपेरिमेंटल वर्शन में डेस्टिनेशन एंडपॉइंट की सुविधाओं को ऐक्सेस करने के लिए, इस एचटीटीपी अनुरोध का इस्तेमाल करें: https://geocode.googleapis.com/v4alpha/geocode/destinations.
| लॉन्च की जानकारी | चैनल का नाम |
|---|---|
| GA | /v4/ |
| झलक देखें | /v4beta/ |
| एक्सपेरिमेंट के तौर पर उपलब्ध | /v4alpha/ |
- सभी उपलब्ध REST संसाधनों की सूची और ब्यौरा देखने के लिए, REST रेफ़रंस देखें.
- हर चरण के बारे में ज़्यादा जानने के लिए, लॉन्च के चरण देखें.
Geocoding API v4 में उपलब्ध सुविधाएं
Geocoding API के वर्शन 4 में ये नई सुविधाएं मिलती हैं.
मंज़िल खोजने का तरीका
v4 में डेस्टिनेशन खोजने का तरीका पेश किया गया है. इसकी मदद से, अलग-अलग इनपुट के आधार पर, अलग-अलग डेस्टिनेशन के बारे में ज़्यादा जानकारी हासिल की जा सकती है. जैसे, पता, जगह का आईडी या अक्षांश और देशांतर के निर्देशांक. जवाब में एआई की मदद से तैयार की गई खास जानकारी और नेविगेशन पॉइंट टोकन शामिल होते हैं. इनमें कॉन्टेक्स्ट के हिसाब से जानकारी होती है. इसे सटीक रास्ते की जानकारी के लिए, Navigation SDK को भेजा जा सकता है.
Google Cloud के स्टैंडर्ड प्लैटफ़ॉर्म पर लागू किया गया
Geocoding API v4 को Google Cloud पर सेवा के इन्फ़्रास्ट्रक्चर पर लागू किया गया है. इस बदलाव से, आपको ज़्यादा सुरक्षित और भरोसेमंद प्लैटफ़ॉर्म मिलेगा. साथ ही, आपको OAuth जैसी बेहतर सुरक्षा सुविधाएं भी मिलेंगी. इस स्टैंडर्ड एपीआई डिज़ाइन से, सभी एपीआई में एक जैसा अनुभव मिलता है. इससे Geocoding API v4 की मदद से, डेवलपमेंट की प्रोसेस को बेहतर बनाने में मदद मिलती है.
OAuth की सुविधा जोड़ी गई
Geocoding API v4, पुष्टि करने के लिए OAuth 2.0 के इस्तेमाल के साथ काम करता है. Google, OAuth 2.0 के सामान्य मामलों के साथ काम करता है. जैसे, वेब सर्वर के लिए.
फ़ील्ड मास्क की सुविधा जोड़ी गई
फ़ील्ड मास्क का इस्तेमाल करके बताएं कि जवाब में कौनसी जानकारी दिखनी चाहिए. किसी पते को जियोकोड करना, किसी जगह को जियोकोड करना, और जगह की जियोकोडिंग के तरीकों के लिए, रिस्पॉन्स ऑब्जेक्ट के सभी फ़ील्ड डिफ़ॉल्ट रूप से दिखाए जाते हैं. डेस्टिनेशन खोजें तरीके के लिए, आपको एपीआई अनुरोध में फ़ील्ड मास्क की जानकारी देनी होगी.
एपीआई की सुरक्षा
Geocoding API v4 को सर्वर-टू-सर्वर एपीआई के तौर पर डिज़ाइन किया गया है. ब्राउज़र से डायरेक्ट क्लाइंट-साइड कॉल करने पर, एपीआई पासकोड के चोरी होने और उनके गलत इस्तेमाल का खतरा बढ़ जाता है. ऐसा इसलिए होता है, क्योंकि एचटीटीपी रेफ़रलकर्ता से जुड़ी पाबंदियां, वेब सेवा के एंडपॉइंट को सुरक्षित रखने के लिए काफ़ी नहीं होती हैं.
हमारा सुझाव है कि आप अपने बैकएंड सर्वर से Geocoding API v4 को कॉल करें. सुरक्षित तरीके से लागू करने के पैटर्न और क्लाइंट-साइड की ज़रूरतों के विकल्पों के बारे में ज़्यादा जानने के लिए, सुरक्षा से जुड़ी ज़रूरी बातें देखें.