Geocoding API एक ऐसी सेवा है जो पतों की जियोकोडिंग और रिवर्स जियोकोडिंग की सुविधा देती है.
जियोकोडिंग, पतों (जैसे कि मोहल्ले का पता) को भौगोलिक निर्देशांकों (जैसे कि अक्षांश और देशांतर) में बदलने की प्रोसेस है. इसका इस्तेमाल, मैप पर मार्कर लगाने या मैप को सेट करने के लिए किया जा सकता है.
रिवर्स जियोकोडिंग, भौगोलिक निर्देशांकों को ऐसे पते में बदलने की प्रोसेस है जिसे पढ़ा जा सकता है.
किसी दिए गए जगह के आईडी का पता ढूंढने के लिए, Geocoding API का भी इस्तेमाल किया जा सकता है.
अनुरोध और जवाब का सैंपल
Geocoding API को एचटीटीपी इंटरफ़ेस के ज़रिए ऐक्सेस किया जाता है. यहां जियोकोडिंग और रिवर्स जियोकोडिंग के अनुरोधों के उदाहरण दिए गए हैं.
जियोकोडिंग का अनुरोध और जवाब (अक्षांश/देशांतर लुकअप)
यहां दिए गए उदाहरण में, "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 की वेब सेवा वाले एपीआई का इस्तेमाल करके डेवलपमेंट किया जा सकता है. ऐसा इसलिए, क्योंकि इनमें सामान्य कामों को लागू करने की सुविधा पहले से मौजूद होती है. जैसे, पुष्टि करना, अनुरोधों को सीमित करना, और अपने-आप फिर से कोशिश करना. Geocoding API, Google Maps की सेवाओं के लिए Java Client, Python Client, Go Client, और Node.js Client में उपलब्ध है.
पुष्टि करना, कोटा, कीमत, और नीतियां
पुष्टि करना
Geocoding API का इस्तेमाल करने के लिए, आपको सबसे पहले एपीआई चालू करना होगा. साथ ही, पुष्टि करने के लिए सही क्रेडेंशियल पाने होंगे. ज़्यादा जानकारी के लिए, Google Maps Platform का इस्तेमाल शुरू करना लेख पढ़ें.
कोटा और कीमत
Geocoding API के लिए तय किए गए कोटे और कीमत के बारे में जानने के लिए, इस्तेमाल और बिलिंग पेज देखें.
नीतियां
Geocoding API का इस्तेमाल, एपीआई की नीतियों के मुताबिक होना चाहिए.
ज़्यादा जानें
Geocoding API की मदद से और भी बहुत कुछ किया जा सकता है. ज़्यादा डेमो, उदाहरण, उपलब्ध पैरामीटर, स्टेटस कोड, गड़बड़ी के मैसेज, और अन्य जानकारी के लिए, Geocoding API डेवलपर गाइड देखें.
Geocoding API की डेवलपर गाइड में, Geocoding API की वेब सेवा के बारे में बताया गया है. यह वेबसाइट और मोबाइल डेवलपर के लिए है. ये डेवलपर, Google Maps Platform API में से किसी एक के ज़रिए उपलब्ध कराए गए मैप में जियोकोडिंग डेटा का इस्तेमाल करना चाहते हैं.