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