रिवर्स जियोकोडिंग (पता लुकअप) अनुरोध और जवाब

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

रिवर्स जियोकोडिंग अनुरोध

ज़रूरी पैरामीटर

  • latlng — अक्षांश और देशांतर निर्देशांक उस जगह की जानकारी देते हैं जिसके लिए आपको सबसे नज़दीकी पता चाहिए और इंसान के पढ़ने लायक पता होना चाहिए.
  • key — आपके ऐप्लिकेशन की एपीआई कुंजी. यह कुंजी कोटा मैनेजमेंट के लिए, आपके ऐप्लिकेशन की पहचान करती है. कुंजी पाने का तरीका जानें.

ज़रूरी नहीं पैरामीटर

ये ऐसे वैकल्पिक पैरामीटर हैं जिन्हें रिवर्स जियोकोडिंग अनुरोध में शामिल किया जा सकता है:

  • language — वह भाषा जिसमें नतीजे दिखाने हैं.
    • इस्तेमाल की जा सकने वाली भाषाओं की सूची देखें. Google अक्सर इस्तेमाल की जाने वाली भाषाओं को अपडेट करता है. इसलिए, हो सकता है कि इस सूची में पूरी जानकारी शामिल न हो.
    • अगर language नहीं दिया जाता है, तो जियोकोडर Accept-Language हेडर में बताई गई पसंदीदा भाषा या उस डोमेन की स्थानीय भाषा का इस्तेमाल करने की कोशिश करता है जिससे अनुरोध भेजा गया है.
    • जियोकोडर मोहल्ले का ऐसा पता देने का सबसे अच्छा प्रयास करता है, जो उपयोगकर्ता और स्थानीय दोनों ही आसानी से पढ़ा जा सके. इस लक्ष्य को हासिल करने के लिए, यह मोहल्ले के पते को स्थानीय भाषा में दिखाता है. साथ ही, ज़रूरत पड़ने पर उपयोगकर्ता के लिए उसे पढ़ने लायक स्क्रिप्ट में ट्रांसलिट्रेट किया जाता है. साथ ही, यह भी ध्यान में रखता है कि कौनसी भाषा का इस्तेमाल करना है. अन्य सभी पते, पसंदीदा भाषा में दिखाए जाते हैं. पते के सभी कॉम्पोनेंट एक ही भाषा में दिखाए जाते हैं, जिसे पहले कॉम्पोनेंट से चुना जाता है.
    • अगर कोई नाम पसंदीदा भाषा में उपलब्ध नहीं है, तो जियोकोडर सबसे नज़दीकी मिलान का इस्तेमाल करता है.
  • region — क्षेत्र का कोड, जिसे ccTLD ("टॉप-लेवल डोमेन") दो-वर्ण की वैल्यू के तौर पर दिखाया जाता है. लागू होने वाले कानून के हिसाब से, पैरामीटर से नतीजों पर भी असर पड़ सकता है.
  • result_type — एक या ज़्यादा तरह के पतों का फ़िल्टर, जिसे पाइप (|) से अलग किया जाता है. अगर पैरामीटर में एक से ज़्यादा तरह के पते हैं, तो एपीआई उन सभी पतों को दिखाता है जो किसी भी तरह के पते से मेल खाते हैं. प्रोसेसिंग के बारे में एक जानकारी: result_type पैरामीटर, खोज को बताए गए पते के टाइप(टाइपों) तक restrict नहीं करता. इसके बजाय, result_type खोज के बाद वाले फ़िल्टर की तरह काम करता है: एपीआई, बताए गए latlng के लिए सभी नतीजे फ़ेच करता है. इसके बाद, उन नतीजों को खारिज कर देता है जो बताए गए पते के टाइप से मेल नहीं खाते. इन वैल्यू का इस्तेमाल किया जा सकता है:
    • street_address में मोहल्ले का सटीक पता दिया जाता है.
    • route नाम वाले रास्ते के बारे में बताता है (जैसे कि "US 101").
    • intersection, आम तौर पर दो मुख्य सड़कों के बराबर होने वाला चौराहा होता है.
    • political एक राजनैतिक इकाई है. आम तौर पर, यह टाइप कुछ सिविल प्रशासन के पॉलीगॉन को दिखाता है.
    • country किसी राष्ट्रीय राजनैतिक इकाई के बारे में बताता है. आम तौर पर, यह जियोकोडर से मिलने वाला सबसे ज़्यादा ऑर्डर टाइप होता है.
    • administrative_area_level_1, देश के स्तर से नीचे की फ़र्स्ट-ऑर्डर सिविल इकाई के बारे में बताता है. अमेरिका में ये एडमिन लेवल, राज्य के हैं. सभी देशों में, ये प्रशासनिक लेवल नहीं दिखते. ज़्यादातर मामलों में, admin_area_level_1 छोटे नाम ISO 3166-2 सबडिवीज़न और बड़े पैमाने पर सर्कुलेट की जाने वाली दूसरी सूचियों से काफ़ी हद तक मैच करेंगे. हालांकि, इसकी कोई गारंटी नहीं है कि हमारे जियोकोडिंग नतीजे अलग-अलग सिग्नल और जगह की जानकारी के डेटा पर आधारित होते हैं.
    • administrative_area_level_2, देश के स्तर से नीचे की दूसरी-ऑर्डर वाली नागरिक इकाई के बारे में बताता है. अमेरिका में, ये प्रशासनिक लेवल, काउंटी के होते हैं. सभी देशों में, ये प्रशासनिक लेवल नहीं दिखते.
    • administrative_area_level_3, देश के स्तर से नीचे तीसरे क्रम की दीवानी इकाई के बारे में बताता है. यह टाइप, छोटे सिविल डिवीज़न को दिखाता है. सभी देशों में ये प्रशासनिक स्तर नहीं दिखते.
    • administrative_area_level_4, देश के स्तर से नीचे की चौथे क्रम की सिविल इकाई के बारे में बताता है. यह टाइप, छोटे सिविल डिवीज़न को दिखाता है. सभी देशों में ये प्रशासनिक स्तर नहीं दिखते.
    • administrative_area_level_5, देश के स्तर से नीचे की पांचवें क्रम की नागरिक इकाई के बारे में बताता है. यह टाइप, छोटे सिविल डिवीज़न को दिखाता है. सभी देशों में ये प्रशासनिक स्तर नहीं दिखते.
    • administrative_area_level_6, देश के स्तर से नीचे की छठे-क्रम की दीवानी इकाई के बारे में बताता है. यह टाइप, छोटे सिविल डिवीज़न को दिखाता है. सभी देशों में ये प्रशासनिक स्तर नहीं दिखते.
    • administrative_area_level_7, देश के स्तर से नीचे सातवें क्रम की नागरिक इकाई है. यह टाइप, छोटे सिविल डिवीज़न को दिखाता है. सभी देशों में ये प्रशासनिक स्तर नहीं दिखते.
    • colloquial_area, इकाई के लिए आम तौर पर इस्तेमाल किया जाने वाला वैकल्पिक नाम बताता है.
    • locality किसी शहर या कस्बे की राजनैतिक इकाई को दिखाता है.
    • sublocality, किसी इलाके के नीचे फ़र्स्ट-ऑर्डर सिविल इकाई के बारे में बताता है. कुछ जगहों के लिए, इनमें से कोई भी तरीका उपलब्ध हो सकता है: sublocality_level_1 से sublocality_level_5. हर मोहल्ले का लेवल एक सिविल इकाई है. बड़ी संख्याएं, छोटे भौगोलिक इलाके को दिखाती हैं.
    • neighborhood से पता चलता है कि आस-पास के किसी इलाके का नाम दिया गया है
    • premise नाम वाली जगह के बारे में बताता है. आम तौर पर, यह ऐसी इमारत या इमारतों का संग्रह होता है जिनके नाम
    • subpremise नाम वाली जगह के नीचे पहले-ऑर्डर वाली इकाई के बारे में बताता है. आम तौर पर, यह एक ऐसी इमारत होती है जिसमें कई इमारतों का नाम शामिल होता है.
    • plus_code, कोड में बदली गई जगह के रेफ़रंस को दिखाता है, जिसे अक्षांश और देशांतर से लिया जाता है. Plus Code का इस्तेमाल उन जगहों पर मोहल्ले के पते बदलने के तौर पर किया जा सकता है जहां वे मौजूद नहीं हैं (जहां इमारतों के नंबर नहीं होते या सड़कों के नाम नहीं होते). ज़्यादा जानकारी के लिए, https://plus.codes पर जाएं.
    • postal_code उस पिन कोड को दिखाता है जिसका इस्तेमाल देश में पोस्टल मेल के लिए किया जाता है.
    • natural_feature एक अहम प्राकृतिक सुविधा है.
    • airport किसी हवाई अड्डे का संकेत है.
    • park नाम वाले पार्क को दिखाता है.
    • point_of_interest पसंदीदा स्थान दिखाता है. आम तौर पर, ये "लोकप्रिय जगह" ऐसी स्थानीय इकाइयां होती हैं जो मुख्य तौर पर, किसी अन्य कैटगरी में आसानी से फ़िट नहीं होती हैं. जैसे, "एंपायर स्टेट बिल्डिंग" या "आइफ़िल टावर".
  • location_type — एक या ज़्यादा तरह की जगहों का फ़िल्टर, जिसे पाइप (|) से अलग किया जाता है. अगर पैरामीटर में कई तरह की जगहें हैं, तो एपीआई उन सभी पतों को दिखाता है जो किसी भी टाइप से मेल खाते हैं. प्रोसेसिंग के बारे में जानकारी: location_type पैरामीटर, खोज को किसी खास जगह के हिसाब से restrict नहीं करता. इसके बजाय, location_type खोज के बाद वाले फ़िल्टर की तरह काम करता है: एपीआई तय किए गए latlng के लिए सभी नतीजे फ़ेच करता है. इसके बाद, उन नतीजों को खारिज कर देता है जो बताई गई जगह के टाइप से मेल नहीं खाते. ये वैल्यू इस्तेमाल की जा सकती हैं:
    • "ROOFTOP" सिर्फ़ वे पते दिखाता है जिनकी जगह की जानकारी, Google के पास मौजूद होती है. इससे, मोहल्ले का पता सटीक होता है.
    • "RANGE_INTERPOLATED" सिर्फ़ उन पतों को दिखाता है जो दो सटीक पॉइंट (जैसे कि चौराहों) के बीच अनुमान (आम तौर पर सड़क पर) दिखाते हैं. आम तौर पर, इंटरपोलेट की गई रेंज यह बताती है कि मोहल्ले के पते के लिए, छत पर जियोकोड उपलब्ध नहीं है.
    • "GEOMETRIC_CENTER" किसी जगह के सिर्फ़ जियोमेट्रिक सेंटर को दिखाता है, जैसे कि पॉलीलाइन (उदाहरण के लिए, सड़क) या पॉलीगॉन (क्षेत्र).
    • "APPROXIMATE" सिर्फ़ वही पते दिखाता है जिन्हें अनुमानित के तौर पर दिखाया गया है.

अगर result_type और location_type, दोनों फ़िल्टर मौजूद हैं, तो एपीआई सिर्फ़ वे नतीजे दिखाता है जो result_type और location_type, दोनों वैल्यू से मेल खाते हैं. अगर कोई भी फ़िल्टर वैल्यू स्वीकार नहीं की जाती, तो एपीआई ZERO_RESULTS दिखाता है.

रिवर्स जियोकोडिंग का उदाहरण

नीचे दी गई क्वेरी में ब्रुकलिन के किसी जगह का अक्षांश/देशांतर वैल्यू शामिल है:

https://maps.googleapis.com/maps/api/geocode/json?latlng=40.714224,-73.961452&key=YOUR_API_KEY

ऊपर दी गई क्वेरी से यह नतीजा मिलता है:

{
   "results" : [
      {
         "address_components" : [
            {
               "long_name" : "277",
               "short_name" : "277",
               "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" : [ "sublocality", "political" ]
            },
            {
               "long_name" : "Kings",
               "short_name" : "Kings",
               "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" : "277 Bedford Avenue, Brooklyn, NY 11211, USA",
         "geometry" : {
            "location" : {
               "lat" : 40.714232,
               "lng" : -73.9612889
            },
            "location_type" : "ROOFTOP",
            "viewport" : {
               "northeast" : {
                  "lat" : 40.7155809802915,
                  "lng" : -73.9599399197085
               },
               "southwest" : {
                  "lat" : 40.7128830197085,
                  "lng" : -73.96263788029151
               }
            }
         },
         "place_id" : "ChIJd8BlQ2BZwokRAFUEcm_qrcA",
         "types" : [ "street_address" ]
      },

  ... Additional <code>results[]</code> ...

ध्यान दें कि रिवर्स जियोकोडर ने एक से ज़्यादा नतीजे दिखाए हैं. "formatted_address" के नतीजों में सिर्फ़ डाक पते नहीं होते, बल्कि किसी जगह का नाम बताने का भी एक तरीका होता है. उदाहरण के लिए, जब शिकागो शहर में किसी पॉइंट को जियोकोड किया जाता है, तो जियोकोड किए गए पॉइंट को सड़क के पते के रूप में, शहर (शिकागो), उसके राज्य (इलिनॉय) के रूप में या देश (संयुक्त राज्य अमेरिका) के रूप में दिखाया जा सकता है. सभी जियोकोडर के लिए "पते" हैं. रिवर्स जियोकोडर इनमें से किसी भी प्रकार को मान्य परिणामों के रूप में लौटाता है.

रिवर्स जियोकोडर राजनैतिक इकाइयों (देशों, प्रांतों, शहरों और पड़ोस), मोहल्ले के पतों, और पिन कोड से मेल खाता है.

पिछली क्वेरी से मिले formatted_address वैल्यू की पूरी सूची नीचे दी गई है.

{
   "plus_code" : {
      "compound_code" : "P27Q+MCM New York, NY, USA",
      "global_code" : "87G8P27Q+MCM"
   },
   "results" : [
      {
         "formatted_address" : "277 Bedford Ave, Brooklyn, NY 11211, USA",
         ...
         "types" : [ "street_address" ]
      },
      {
         "formatted_address" : "279 Bedford Ave, Brooklyn, NY 11211, USA",
         ...
         "types" : [ "premise" ]
      },
      {
         "formatted_address" : "277 Bedford Ave, Brooklyn, NY 11211, USA",
         ...
         "types" : [ "establishment", "point_of_interest" ]
      },
      {
         "formatted_address" : "291-275 Bedford Ave, Brooklyn, NY 11211, USA",
         ...
         "types" : [ "route" ]
      },
      {
         "formatted_address" : "P27Q+MC New York, NY, USA",
         ...
         "types" : [ "plus_code" ]
      },
      {
         "formatted_address" : "South Williamsburg, Brooklyn, NY, USA",
         ...
         "types" : [ "neighborhood", "political" ]
      },
      {
         "formatted_address" : "Brooklyn, NY 11211, USA",
         ...
         "types" : [ "postal_code" ]
      },
      {
         "formatted_address" : "Williamsburg, Brooklyn, NY, USA",
         ...
         "types" : [ "neighborhood", "political" ]
      },
      {
         "formatted_address" : "Kings County, Brooklyn, NY, USA",
         ...
         "types" : [ "administrative_area_level_2", "political" ]
      },
      {
         "formatted_address" : "Brooklyn, NY, USA",
         ...
         "types" : [ "political", "sublocality", "sublocality_level_1" ]
      },
      {
         "formatted_address" : "New York, NY, USA",
         ...
         "types" : [ "locality", "political" ]
      },
      {
         "formatted_address" : "New York, USA",
         ...
         "types" : [ "administrative_area_level_1", "political" ]
      },
      {
         "formatted_address" : "United States",
         ...
         "types" : [ "country", "political" ]
      }
   ],
   "status" : "OK"
}

यह एपीआई अलग-अलग तरह के पते दिखाता है. इनमें मोहल्ले के पते से लेकर, कम खास राजनैतिक इकाइयां शामिल होती हैं, जैसे कि आस-पास के पते, शहर, काउंटी, और राज्य. आम तौर पर, सटीक पता लगाने के लिए खोज नतीजे सबसे अहम होते हैं, जैसा कि इस मामले में होता है. अगर आपको किसी खास तरह के पते का मिलान करना है, तो नतीजों को टाइप के हिसाब से सीमित करना सेक्शन देखें. इस वजह से, नतीजे अलग-अलग हो सकते हैं.

टाइप के हिसाब से फ़िल्टर की गई रिवर्स जियोकोडिंग

नीचे दिए गए उदाहरण में, लौटाए गए पतों को फ़िल्टर किया गया है. ऐसा इसलिए किया गया है, ताकि सिर्फ़ उन पतों को शामिल किया जा सके जिनमें लोकेशन टाइप ROOFTOP और पता street_address टाइप हो.

https://maps.googleapis.com/maps/api/geocode/json?latlng=40.714224,-73.961452
&location_type=ROOFTOP&result_type=street_address&key=YOUR_API_KEY

ध्यान दें: ये फ़िल्टर सिर्फ़ रिवर्स जियोकोडिंग के लिए मान्य हैं.

रिवर्स जियोकोडिंग रिस्पॉन्स

रिवर्स जियोकोडिंग रिस्पॉन्स का फ़ॉर्मैट और जियोकोडिंग रिस्पॉन्स एक ही है. जियोकोडिंग के जवाब देखें. रिवर्स जियोकोडिंग रिस्पॉन्स में नीचे स्थिति कोड दिए गए हैं.

जियोकोडिंग स्थिति कोड को उलटना

जियोकोडिंग रिस्पॉन्स ऑब्जेक्ट में मौजूद "status" फ़ील्ड में, अनुरोध की स्थिति शामिल होती है. साथ ही, इसमें डीबग करने की जानकारी भी हो सकती है, ताकि आप यह ट्रैक कर सकें कि रिवर्स जियोकोडिंग क्यों काम नहीं कर रहा है. "status" फ़ील्ड में ये वैल्यू हो सकती हैं:

  • "OK" बताता है कि कोई गड़बड़ी नहीं हुई और कम से कम एक पता लौटाया गया.
  • "ZERO_RESULTS" से पता चलता है कि रिवर्स जियोकोडिंग सफल रहा, लेकिन कोई नतीजा नहीं मिला. ऐसा तब हो सकता है, जब जियोकोडर को किसी दूर की जगह पर latlng पास किया गया हो.
  • "OVER_QUERY_LIMIT" से पता चलता है कि आपका कोटा पार हो गया है.
  • "REQUEST_DENIED" से पता चलता है कि अनुरोध अस्वीकार किया गया था. ऐसा इसलिए हो सकता है, क्योंकि अनुरोध में result_type या location_type पैरामीटर शामिल है, लेकिन एपीआई कुंजी शामिल नहीं है.
  • आम तौर पर, "INVALID_REQUEST" में इनमें से कोई एक जानकारी होती है:
    • क्वेरी (address, components या latlng) मौजूद नहीं है.
    • एक अमान्य result_type या location_type दिया गया था.
  • "UNKNOWN_ERROR" से पता चलता है कि सर्वर की गड़बड़ी की वजह से अनुरोध को प्रोसेस नहीं किया जा सका. अगर आप फिर से कोशिश करते हैं, तो हो सकता है कि अनुरोध पूरा हो जाए.

रिवर्स जियोकोडिंग और कोड

जियोकोडिंग रिस्पॉन्स में plus_code फ़ील्ड में एक प्लस कोड होता है, जो क्वेरी किए गए अक्षांश और देशांतर का सबसे अच्छा अनुमान लगाता है. इसके अलावा, ज़्यादातर मामलों में JSON के नतीजों के कलेक्शन में पूरा जियोकोडिंग नतीजा होता है जिसमें plus_code टाइप और पते में प्लस कोड होता है. डिकोड किए गए प्लस कोड और अनुरोध की जगह के बीच की दूरी 10 मीटर से कम होने की गारंटी दी जाती है.