Geocoding API एक ऐसी सेवा है जो किसी जगह को पते, अक्षांश और देशांतर निर्देशांक या जगह के आईडी के तौर पर स्वीकार करती है. यह पते को अक्षांश और देशांतर निर्देशांकों और जगह के आईडी में बदलता है. इसके अलावा, यह अक्षांश और देशांतर निर्देशांकों या जगह के आईडी को पते में बदलता है.
Geocoding API का इस्तेमाल करके क्या-क्या किया जा सकता है
जियोकोडिंग एपीआई का इस्तेमाल करके, एक या उससे ज़्यादा पतों या जगहों के लिए जियोकोडिंग डेटा पाया जा सकता है. इसमें यह डेटा शामिल है:
Geocoding API v4 की इस रिलीज़ में, ये एंडपॉइंट शामिल हैं:
- (प्रीव्यू) किसी पते को जियोकोड करना — पतों के लिए भौगोलिक निर्देशांक. इसे फ़ॉरवर्ड जियोकोडिंग भी कहा जाता है.
- (झलक) किसी जगह का जियोकोड करना — अक्षांश और देशांतर निर्देशांकों के सेट के लिए पते. इसे रिवर्स जियोकोडिंग भी कहा जाता है.
- (प्रीव्यू) जगह की जियोकोडिंग — किसी जगह के आईडी से पता वापस पाएं.
- (प्रीव्यू) मंज़िलें खोजें — किसी पते, जगह के आईडी या जगह के हिसाब से कोई मंज़िल खोजें.
आपके पास यह कंट्रोल करने का विकल्प होता है कि नतीजे कहां दिखें. साथ ही, नतीजों को किसी खास इलाके, काउंटी या पिन कोड तक सीमित किया जा सकता है.
Geocoding API कैसे काम करता है
Geocoding API, जियोकोडिंग और रिवर्स जियोकोडिंग, दोनों काम करता है:
- जियोकोडिंग: यह "1600 Amphitheatre Parkway, Mountain View, CA" जैसे पतों को अक्षांश और देशांतर के निर्देशांकों या Place ID में बदलता है. इन निर्देशांकों का इस्तेमाल, मैप पर मार्कर लगाने के लिए किया जा सकता है. इसके अलावा, इनका इस्तेमाल व्यू फ़्रेम में मैप को बीच में लाने या उसकी पोज़िशन बदलने के लिए भी किया जा सकता है.
- रिवर्स जियोकोडिंग: यह अक्षांश और देशांतर के निर्देशांकों या प्लेस आईडी को ऐसे पते में बदलता है जिसे आसानी से पढ़ा जा सकता है. पतों का इस्तेमाल कई तरह के कामों के लिए किया जा सकता है. जैसे, डिलीवरी या पिकअप.
यहां दी गई टेबल में, Geocoding API के ज़रिए उपलब्ध संसाधनों की खास जानकारी दी गई है. साथ ही, यह भी बताया गया है कि हर एंडपॉइंट कौनसा डेटा दिखाता है.
| डेटा संसाधन | डेटा वापस लाया गया | जवाब का फ़ॉर्मैट |
|---|---|---|
| जियोकोडिंग | यह फ़ंक्शन, पते, पते के कॉम्पोनेंट, और पते के टाइप की जानकारी देता है. जियोकोड रिस्पॉन्स का दस्तावेज़ देखें. |
|
| रिवर्स जियोकोडिंग | यह फ़ंक्शन, पते, पते के कॉम्पोनेंट, और पते के टाइप की जानकारी देता है. रिवर्स जियोकोडिंग रिस्पॉन्स का दस्तावेज़ देखें. | |
| जगह की जियोकोडिंग | यह फ़ंक्शन, पते, पते के कॉम्पोनेंट, और पते के टाइप की जानकारी देता है. जगह की जियोकोडिंग का रिस्पॉन्स से जुड़ा दस्तावेज़ देखें. | |
| डेस्टिनेशन के लिए खोज | यह फ़ंक्शन, अलग-अलग इनपुट शर्तों के आधार पर, अलग-अलग डेस्टिनेशन के बारे में ज़्यादा जानकारी देता है. जैसे, पता, जगह का आईडी या अक्षांश और देशांतर के निर्देशांक. डेस्टिनेशन खोजने से जुड़ा दस्तावेज़ देखें. |
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 के सामान्य इस्तेमाल के उदाहरणों के साथ काम करता है. जैसे, वेब सर्वर के लिए OAuth 2.0.
फ़ील्ड मास्क की सुविधा जोड़ी गई
फ़ील्ड मास्क का इस्तेमाल करके यह तय करें कि जवाब में कौनसी जानकारी दिखनी चाहिए. किसी पते को जियोकोड करें, किसी जगह को जियोकोड करें, और जगह को जियोकोड करें एंडपॉइंट के लिए, जवाब ऑब्जेक्ट में मौजूद सभी फ़ील्ड डिफ़ॉल्ट रूप से दिखाए जाते हैं. Search for destinations एंडपॉइंट के लिए, आपको एपीआई अनुरोध में फ़ील्ड मास्क तय करना होगा.
झलक के तौर पर उपलब्ध होने के दौरान, इसका इस्तेमाल करने के लिए कोई शुल्क नहीं देना होगा
Geocoding API v4, प्री-जीए प्रीव्यू स्टेज में है. साथ ही, प्रीव्यू के दौरान एपीआई इस्तेमाल करने के लिए कोई शुल्क नहीं लिया जाता. एपीआई कॉल, Cloud Console के बिलिंग पेज पर दिखेंगे. हालांकि, इसके लिए कोई शुल्क नहीं लिया जाएगा.
एपीआई की सुरक्षा
Geocoding API v4 को सर्वर-टू-सर्वर एपीआई के तौर पर डिज़ाइन किया गया है. ब्राउज़र से सीधे क्लाइंट-साइड कॉल करने पर, एपीआई कुंजियों के चोरी होने और उनके गलत इस्तेमाल का खतरा बढ़ जाता है. ऐसा इसलिए होता है, क्योंकि एचटीटीपी रेफ़रर से जुड़ी पाबंदियां, वेब सेवा के एंडपॉइंट के लिए सुरक्षा के तौर पर काफ़ी नहीं होती हैं.
हमारा सुझाव है कि आप अपने बैकएंड सर्वर से Geocoding API v4 को कॉल करें. क्लाइंट-साइड की ज़रूरतों के लिए, सुरक्षित तरीके से लागू करने के पैटर्न और विकल्पों के बारे में ज़्यादा जानने के लिए, सुरक्षा से जुड़ी बातों का ध्यान रखना लेख पढ़ें.
सुझाव/राय दें या शिकायत करें
यह सुविधा, फ़िलहाल सिर्फ़ झलक के तौर पर उपलब्ध है. हमें geocoding-feedback-channel@google.com पर सुझाव/राय/शिकायत भेजें.