Geocoding API एक ऐसी सेवा है जो पतों की जियोकोडिंग और रिवर्स जियोकोडिंग की सुविधा उपलब्ध कराती है.
जियोकोडिंग, पतों (जैसे, सड़क का पता) को भौगोलिक निर्देशांकों (जैसे, अक्षांश और देशांतर) में बदलने की प्रोसेस है. इसका इस्तेमाल, मैप पर मार्कर डालने या मैप की पोज़िशन तय करने के लिए किया जा सकता है.
रिवर्स जियोकोडिंग, भौगोलिक निर्देशांकों को ऐसे पते में बदलने की प्रोसेस है जिसे इंसान पढ़ सके.
किसी दिए गए जगह के आईडी का पता लगाने के लिए, Geocoding API का इस्तेमाल भी किया जा सकता है.
अनुरोध और रिस्पॉन्स का सैंपल
जियोकोडिंग एपीआई को HTTP इंटरफ़ेस की मदद से ऐक्सेस किया जाता है. यहां दिए गए उदाहरणों में, जियोकोडिंग और रिवर्स जियोकोडिंग अनुरोधों के बारे में बताया गया है.
जियोकोडिंग का अनुरोध और रिस्पॉन्स (अक्षांश/देशांतर लुकअप)
इस उदाहरण में, "1600 Amphitheatre Parkway, Mountain View, CA" के अक्षांश और देशांतर का अनुरोध किया गया है. साथ ही, यह भी बताया गया है कि आउटपुट JSON फ़ॉर्मैट में होना चाहिए.
https://maps.googleapis.com/maps/api/geocode/json?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA&key=YOUR_API_KEY
अपने वेब ब्राउज़र में यूआरएल डालकर, इसकी जांच की जा सकती है. हालांकि, YOUR_API_KEY
को अपनी असली एपीआई कुंजी से बदलना न भूलें.
जवाब में पते का अक्षांश और देशांतर शामिल होता है.
जियोकोडिंग अनुरोध के यूआरएल बनाने और उपलब्ध पैरामीटर के बारे में ज़्यादा जानकारी पाने के लिए, डेवलपर गाइड देखें. साथ ही, रिस्पॉन्स को समझने के बारे में भी जानें.
यहां JSON में, जगह की जानकारी देने वाले रिस्पॉन्स का एक सैंपल दिया गया है:
{ "results" : [ { "address_components" : [ { "long_name" : "1600", "short_name" : "1600", "types" : [ "street_number" ] }, { "long_name" : "Amphitheatre Parkway", "short_name" : "Amphitheatre Pkwy", "types" : [ "route" ] }, { "long_name" : "Mountain View", "short_name" : "Mountain View", "types" : [ "locality", "political" ] }, { "long_name" : "Santa Clara County", "short_name" : "Santa Clara County", "types" : [ "administrative_area_level_2", "political" ] }, { "long_name" : "California", "short_name" : "CA", "types" : [ "administrative_area_level_1", "political" ] }, { "long_name" : "United States", "short_name" : "US", "types" : [ "country", "political" ] }, { "long_name" : "94043", "short_name" : "94043", "types" : [ "postal_code" ] } ], "formatted_address" : "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA", "geometry" : { "location" : { "lat" : 37.4267861, "lng" : -122.0806032 }, "location_type" : "ROOFTOP", "viewport" : { "northeast" : { "lat" : 37.4281350802915, "lng" : -122.0792542197085 }, "southwest" : { "lat" : 37.4254371197085, "lng" : -122.0819521802915 } } }, "place_id" : "ChIJtYuu0V25j4ARwu5e4wwRYgE", "plus_code" : { "compound_code" : "CWC8+R3 Mountain View, California, United States", "global_code" : "849VCWC8+R3" }, "types" : [ "street_address" ] } ], "status" : "OK" }
रिवर्स जियोकोडिंग का अनुरोध और रिस्पॉन्स (पता लुकअप)
इस उदाहरण में, अमेरिका के न्यूयॉर्क के ब्रुकलिन में दिए गए अक्षांश/देशांतर के हिसाब से पते का अनुरोध किया गया है. इससे पता चलता है कि आउटपुट, JSON फ़ॉर्मैट में होना चाहिए.
https://maps.googleapis.com/maps/api/geocode/json?latlng=40.714224,-73.961452&key=YOUR_API_KEY
अपने वेब ब्राउज़र में यूआरएल डालकर, इसकी जांच की जा सकती है. इसके लिए, अपनी असली एपीआई पासकोड से 'YOUR_API_KEY' को बदलना न भूलें. जवाब में, अक्षांश और देशांतर वाली जगह का ऐसा पता शामिल होता है जिसे कोई भी व्यक्ति आसानी से पढ़ सकता है.
डेवलपर गाइड देखें. इसमें, रिवर्स जियोकोडिंग अनुरोध के यूआरएल बनाने, उपलब्ध पैरामीटर, और रिस्पॉन्स को समझने के बारे में ज़्यादा जानकारी दी गई है.
यहां रिवर्स जियोकोडिंग के रिस्पॉन्स का JSON में एक सैंपल दिया गया है:
{ "plus_code" : { "compound_code" : "P27Q+MC New York, NY, USA", "global_code" : "87G8P27Q+MC" }, "results" : [ { "address_components" : [ { "long_name" : "279", "short_name" : "279", "types" : [ "street_number" ] }, { "long_name" : "Bedford Avenue", "short_name" : "Bedford Ave", "types" : [ "route" ] }, { "long_name" : "Williamsburg", "short_name" : "Williamsburg", "types" : [ "neighborhood", "political" ] }, { "long_name" : "Brooklyn", "short_name" : "Brooklyn", "types" : [ "political", "sublocality", "sublocality_level_1" ] }, { "long_name" : "Kings County", "short_name" : "Kings County", "types" : [ "administrative_area_level_2", "political" ] }, { "long_name" : "New York", "short_name" : "NY", "types" : [ "administrative_area_level_1", "political" ] }, { "long_name" : "United States", "short_name" : "US", "types" : [ "country", "political" ] }, { "long_name" : "11211", "short_name" : "11211", "types" : [ "postal_code" ] } ], "formatted_address" : "279 Bedford Ave, Brooklyn, NY 11211, USA", "geometry" : { "location" : { "lat" : 40.7142484, "lng" : -73.9614103 }, "location_type" : "ROOFTOP", "viewport" : { "northeast" : { "lat" : 40.71559738029149, "lng" : -73.9600613197085 }, "southwest" : { "lat" : 40.71289941970849, "lng" : -73.96275928029151 } } }, "place_id" : "ChIJT2x8Q2BZwokRpBu2jUzX3dE", "plus_code" : { "compound_code" : "P27Q+MC Brooklyn, New York, United States", "global_code" : "87G8P27Q+MC" }, "types" : [ "bakery", "cafe", "establishment", "food", "point_of_interest", "store" ] }, ... Additional results truncated in this example[] ... ], "status" : "OK" }
हमारी क्लाइंट लाइब्रेरी की मदद से कोडिंग करना
क्लाइंट लाइब्रेरी, Google Maps वेब सेवा एपीआई के साथ डेवलप करना आसान बनाती हैं. ऐसा, सामान्य टास्क को आसान और नेटिव तरीके से लागू करके किया जाता है. जैसे, पुष्टि करना, अनुरोध को कम करना, और अपने-आप फिर से कोशिश करना. जियोकोडिंग API, Google Maps Services के लिए Java क्लाइंट, Python क्लाइंट, Go क्लाइंट, और Node.js क्लाइंट में उपलब्ध है.
पुष्टि करने की सुविधा, कोटा, कीमत, और नीतियां
पुष्टि करना
Geocoding API का इस्तेमाल करने के लिए, आपको सबसे पहले एपीआई को चालू करना होगा और पुष्टि करने के लिए सही क्रेडेंशियल पाना होगा. ज़्यादा जानकारी के लिए, Google Maps Platform का इस्तेमाल शुरू करना लेख पढ़ें.
कोटा और कीमत
Geocoding API के लिए सेट किए गए कोटे और कीमत की जानकारी के लिए, इस्तेमाल और बिलिंग पेज पर जाएं.
नीतियां
जियोकोडिंग एपीआई का इस्तेमाल, एपीआई की नीतियों के मुताबिक होना चाहिए.
ज़्यादा जानें
Geocoding API की मदद से और भी काम किए जा सकते हैं. ज़्यादा डेमो, उदाहरण, उपलब्ध पैरामीटर, स्टेटस कोड, गड़बड़ी के मैसेज वगैरह के बारे में जानने के लिए, Geocoding API डेवलपर गाइड देखें.
Geocoding API डेवलपर गाइड में, Geocoding API वेब सेवा के बारे में बताया गया है. यह उन वेबसाइट और मोबाइल डेवलपर के लिए है जो Google Maps Platform के किसी एपीआई से मिले मैप में, जियोकोडिंग डेटा का इस्तेमाल करना चाहते हैं.