शुरू करें

जियोकोडिंग एपीआई एक ऐसी सेवा है, जो पतों की जियोकोडिंग और रिवर्स जियोकोडिंग है.

जियोकोडिंग, पतों (जैसे, मोहल्ले का पता) को भौगोलिक निर्देशांक (जैसे कि अक्षांश और देशांतर) में बदलने की प्रक्रिया है. इसका इस्तेमाल करके, मैप पर मार्कर लगाए जा सकते हैं या मैप को सही जगह पर रखा जा सकता है.

रिवर्स जियोकोडिंग भौगोलिक निर्देशांकों को ऐसे पते में बदलने की प्रक्रिया है, जिसे इंसान पढ़ सकें.

किसी जगह के आईडी का पता ढूंढने के लिए, जियोकोडिंग एपीआई का भी इस्तेमाल किया जा सकता है.

अनुरोध और जवाब का नमूना

जियोकोडिंग एपीआई को एचटीटीपी इंटरफ़ेस के ज़रिए ऐक्सेस करें. जियोकोडिंग और रिवर्स जियोकोडिंग अनुरोधों के उदाहरण नीचे दिए गए हैं.

जियोकोडिंग अनुरोध और जवाब (अक्षांश/देशांतर लुकअप)

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

पुष्टि करना, कोटा, कीमत, और नीतियां

पुष्टि करना

जियोकोडिंग एपीआई का इस्तेमाल करने के लिए, आपको पहले एपीआई चालू करना होगा और पुष्टि करने के लिए सही क्रेडेंशियल हासिल करने होंगे. ज़्यादा जानकारी के लिए, Google Maps Platform का इस्तेमाल शुरू करना देखें.

कोटा और कीमत

जियोकोडिंग एपीआई के कोटा और कीमत तय करने के बारे में जानकारी के लिए, इस्तेमाल और बिलिंग पेज देखें.

नीतियां

जियोकोडिंग एपीआई का इस्तेमाल, एपीआई की नीतियों के मुताबिक होना चाहिए.

ज़्यादा जानें

जियोकोडिंग एपीआई के साथ और भी बहुत कुछ किया जा सकता है. अन्य डेमो, उदाहरणों, उपलब्ध पैरामीटर, स्टेटस कोड और गड़बड़ी के मैसेज, और अन्य जानकारी के लिए, जियोकोडिंग एपीआई की डेवलपर गाइड देखें.

जियोकोडिंग एपीआई की डेवलपर गाइड, जियोकोडिंग एपीआई की वेब सेवा के बारे में बताती है. यह उन वेबसाइट और मोबाइल डेवलपर के लिए है जो Google Maps Platform API में से किसी एक से मिले मैप में, जियोकोडिंग डेटा का इस्तेमाल करना चाहते हैं.