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