Geocoding API एक ऐसी सेवा है जो किसी जगह की जानकारी को पते, अक्षांश और देशांतर के निर्देशांक या जगह के आईडी के तौर पर स्वीकार करती है. यह पते को अक्षांश और देशांतर निर्देशांक और जगह के आईडी में बदलता है. इसके अलावा, यह अक्षांश और देशांतर निर्देशांक या जगह के आईडी को पते में बदलता है.
Geocoding API की मदद से क्या-क्या किया जा सकता है
Geocoding API का इस्तेमाल करके, एक या उससे ज़्यादा पतों या जगहों के लिए जियोकोडिंग डेटा पाया जा सकता है. इसमें ये शामिल हैं:
Geocoding API v4 की इस रिलीज़ में, ये एंडपॉइंट शामिल हैं:
- किसी पते को जियोकोड करना — पतों के लिए भौगोलिक निर्देशांक. इसे फ़ॉरवर्ड जियोकोडिंग भी कहा जाता है.
- किसी जगह को जियोकोड करना — अक्षांश और देशांतर निर्देशांकों के सेट के पते. इसे रिवर्स जियोकोडिंग भी कहा जाता है.
- जगह की जियोकोडिंग — जगह के आईडी से पता हासिल करें.
- मंज़िलें खोजना — पते, जगह के आईडी या जगह की जानकारी के हिसाब से मंज़िल खोजें.
यह कंट्रोल किया जा सकता है कि नतीजे कहां दिखें. साथ ही, नतीजों को किसी खास इलाके, देश या पिन कोड तक सीमित किया जा सकता है.
डेमो आज़माएं
Geocoding API कैसे काम करता है
Geocoding API, जियोकोडिंग और रिवर्स जियोकोडिंग, दोनों करता है:
- जियोकोडिंग: यह "1600 Amphitheatre Parkway, Mountain View, CA" जैसे पतों को अक्षांश और देशांतर निर्देशांक या जगह के आईडी में बदलता है. इन निर्देशांकों का इस्तेमाल करके, मैप पर मार्कर लगाए जा सकते हैं. इसके अलावा, मैप को व्यू फ़्रेम के बीच में या उसकी जगह को बदला जा सकता है.
- रिवर्स जियोकोडिंग: यह अक्षांश और देशांतर निर्देशांक या जगह के आईडी को किसी व्यक्ति के लिए आसानी से पढ़े जा सकने वाले पते में बदलता है. पतों का इस्तेमाल कई कामों के लिए किया जा सकता है. जैसे, डिलीवरी या पिकअप के लिए.
नीचे दी गई टेबल में, Geocoding API के ज़रिए उपलब्ध संसाधनों की खास जानकारी दी गई है. साथ ही, हर तरीके से मिलने वाले डेटा की जानकारी भी दी गई है.
| डेटा के संसाधन | डेटा के आधार पर मिली जानकारी | जवाब का फ़ॉर्मैट |
|---|---|---|
| जियोकोडिंग | यह पता, पते के कॉम्पोनेंट, और पते के टाइप दिखाता है. Geocode रिस्पॉन्स दस्तावेज़ देखें. |
|
| रिवर्स जियोकोडिंग | यह पता, पते के कॉम्पोनेंट, और पते के टाइप दिखाता है. रिवर्स जियोकोडिंग रिस्पॉन्स से जुड़ा दस्तावेज़ देखें. | |
| जगह की जियोकोडिंग | यह पता, पते के कॉम्पोनेंट, और पते के टाइप दिखाता है. जगह की जियोकोडिंग के रिस्पॉन्स का दस्तावेज़ देखें. | |
| डेस्टिनेशन सर्च | यह अलग-अलग इनपुट के आधार पर, कई डेस्टिनेशन की जानकारी दिखाता है. जैसे, पता, जगह का आईडी या अक्षांश और देशांतर के निर्देशांक. डेस्टिनेशन सर्च दस्तावेज़ देखें. |
लॉन्च स्टेज चैनल
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 को कॉल करें. सुरक्षित तरीके से लागू करने के पैटर्न और क्लाइंट-साइड की ज़रूरतों के विकल्पों के बारे में ज़्यादा जानने के लिए, सुरक्षा से जुड़ी ज़रूरी बातें देखें.