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

यूरोपियन इकनॉमिक एरिया (ईईए) के डेवलपर

जियोकोडिंग का मतलब आम तौर पर, किसी व्यक्ति के लिए आसानी से पढ़े जा सकने वाले पते को मैप पर मौजूद किसी जगह में बदलना होता है. इसके उलट, मैप पर मौजूद किसी जगह को किसी व्यक्ति के लिए आसानी से पढ़े जा सकने वाले पते में बदलने की प्रोसेस को रिवर्स जियोकोडिंग कहा जाता है.

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

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

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

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

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

  • language — वह भाषा जिसमें नतीजे दिखाए जाएंगे.
    • उपलब्ध भाषाओं की सूची देखें. Google अक्सर उन भाषाओं को अपडेट करता रहता है जिनमें यह सुविधा उपलब्ध है. इसलिए, हो सकता है कि इस सूची में सभी भाषाएं शामिल न हों.
    • अगर language नहीं दिया गया है, तो जियोकोडर Accept-Language हेडर में बताई गई पसंदीदा भाषा या उस डोमेन की मूल भाषा का इस्तेमाल करने की कोशिश करता है जिससे अनुरोध भेजा गया है.
    • जियोकोडर, मोहल्ले का ऐसा पता देने की पूरी कोशिश करता है जिसे उपयोगकर्ता और स्थानीय लोग, दोनों पढ़ सकें. इस लक्ष्य को हासिल करने के लिए, यह स्थानीय भाषा में मोहल्ले के पते दिखाता है. साथ ही, अगर ज़रूरी हो, तो उपयोगकर्ता की पसंदीदा भाषा को ध्यान में रखते हुए, उसे ऐसी स्क्रिप्ट में ट्रांसलिट्रेट करता है जिसे उपयोगकर्ता पढ़ सके. अन्य सभी पते, आपकी पसंदीदा भाषा में दिखाए जाते हैं. पते के सभी कॉम्पोनेंट उसी भाषा में दिखाए जाते हैं जो पहले कॉम्पोनेंट के लिए चुनी गई है.
    • अगर पसंदीदा भाषा में कोई नाम उपलब्ध नहीं है, तो जियोकोडर सबसे मिलते-जुलते नाम का इस्तेमाल करता है.
  • region — देश/इलाके का कोड, जिसे ccTLD ("टॉप-लेवल डोमेन") की दो वर्णों वाली वैल्यू के तौर पर बताया गया है. लागू होने वाले कानून के आधार पर, पैरामीटर से नतीजों पर भी असर पड़ सकता है.
  • result_type — एक या उससे ज़्यादा तरह के पतों का फ़िल्टर, जिसे पाइप (|) से अलग किया गया हो. अगर पैरामीटर में एक से ज़्यादा तरह के पते शामिल हैं, तो एपीआई उन सभी पतों को दिखाता है जो इनमें से किसी भी तरह के पते से मैच करते हैं. प्रोसेसिंग के बारे में जानकारी: result_type पैरामीटर, खोज को पते के बताए गए टाइप तक सीमित नहीं करता. इसके बजाय, result_type, खोज के बाद फ़िल्टर के तौर पर काम करता है: एपीआई, तय किए गए latlng के लिए सभी नतीजे फ़ेच करता है. इसके बाद, उन नतीजों को खारिज कर देता है जो पते के लिए तय किए गए टाइप से मेल नहीं खाते. ये वैल्यू इस्तेमाल की जा सकती हैं:

    पते के टाइप और पते के कॉम्पोनेंट के टाइप

    जवाब में GeocodeResult के मुख्य हिस्से में मौजूद types कलेक्शन, पते के टाइप के बारे में बताता है. पते के टाइप के उदाहरणों में, मोहल्ले का पता, देश या राजनैतिक इकाई शामिल है. GeocodeResult बॉडी के AddressComponents फ़ील्ड में मौजूद types ऐरे से, पते के हर हिस्से के टाइप का पता चलता है. उदाहरण के लिए, स्ट्रीट नंबर या देश.

    पते कई तरह के हो सकते हैं. टाइप को 'टैग' माना जा सकता है. उदाहरण के लिए, कई शहरों को political और locality टाइप के साथ टैग किया जाता है.

    यहां दिए गए टाइप इस्तेमाल किए जा सकते हैं. साथ ही, इन्हें पते के टाइप और पते के कॉम्पोनेंट टाइप, दोनों के कलेक्शन में दिखाया जाता है:

    पते का प्रकार ब्यौरा
    street_address मोहल्ले का सटीक पता.
    route किसी रास्ते का नाम (जैसे, "US 101").
    intersection एक मुख्य चौराहा, जो आम तौर पर दो मुख्य सड़कों को जोड़ता है.
    political कोई राजनैतिक इकाई. आम तौर पर, इस टाइप से किसी सिविल एडमिनिस्ट्रेशन के पॉलीगॉन का पता चलता है.
    country राष्ट्रीय राजनैतिक इकाई. आम तौर पर, Geocoder से मिलने वाला सबसे बड़ा ऑर्डर टाइप.
    administrative_area_level_1 'देश' स्तर से नीचे, पहले क्रम की नागरिक इकाई. अमेरिका में, इन प्रशासनिक स्तरों को राज्य कहा जाता है. सभी देशों में ये प्रशासनिक स्तर नहीं होते. ज़्यादातर मामलों में, administrative_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 अक्षांश और देशांतर से मिली जगह की जानकारी का एन्कोड किया गया रेफ़रंस. प्लस कोड का इस्तेमाल, उन जगहों पर मोहल्ले के पते के तौर पर किया जा सकता है जहां मोहल्ले के पते मौजूद नहीं हैं. जैसे, जहां इमारतों को नंबर नहीं दिए गए हैं या सड़कों के नाम नहीं हैं. ज़्यादा जानकारी के लिए, https://plus.codes पर जाएं.
    postal_code देश में डाक भेजने के लिए इस्तेमाल किया जाने वाला पिन कोड.
    natural_feature कोई खास प्राकृतिक जगह.
    airport हवाई अड्डा.
    park कोई पार्क, जिसका नाम हो.
    point_of_interest किसी लोकप्रिय जगह का नाम. आम तौर पर, ये "लोकप्रिय जगहें" ऐसी स्थानीय इकाइयां होती हैं जो किसी दूसरी कैटगरी में आसानी से फ़िट नहीं होतीं. जैसे, "ताज महल" या "एफ़िल टावर".

    अगर टाइप की सूची खाली है, तो इसका मतलब है कि पते के उस कॉम्पोनेंट के लिए कोई टाइप मौजूद नहीं है. उदाहरण के लिए, फ़्रांस में Lieu-dit.

  • location_type — एक या उससे ज़्यादा जगह के टाइप का फ़िल्टर, जिसे पाइप (|) से अलग किया गया हो. अगर पैरामीटर में जगह के कई टाइप शामिल हैं, तो एपीआई उन सभी पतों को दिखाता है जो किसी भी टाइप से मेल खाते हैं. प्रोसेसिंग के बारे में जानकारी: location_type पैरामीटर, खोज को चुनिंदा जगहों के टाइप तक सीमित नहीं करता. इसके बजाय, location_type, खोज के बाद फ़िल्टर के तौर पर काम करता है: एपीआई, तय किए गए latlng के लिए सभी नतीजे फ़ेच करता है. इसके बाद, उन नतीजों को खारिज कर देता है जो जगह के तय किए गए टाइप से मैच नहीं करते. इन वैल्यू का इस्तेमाल किया जा सकता है:
    • "ROOFTOP" सिर्फ़ उन पतों को दिखाता है जिनके लिए Google के पास मोहल्ले के पते की सटीक जगह की जानकारी होती है.
    • "RANGE_INTERPOLATED" सिर्फ़ उन पतों को दिखाता है जो दो सटीक पॉइंट (जैसे, चौराहे) के बीच इंटरपोलेट किए गए अनुमान (आम तौर पर सड़क पर) को दिखाते हैं. इंटरपोलेट की गई रेंज से आम तौर पर पता चलता है कि मोहल्ले के पते के लिए, रूफ़टॉप जियोकोड उपलब्ध नहीं हैं.
    • "GEOMETRIC_CENTER" सिर्फ़ किसी जगह के ज्यामितीय केंद्र दिखाता है. जैसे, पॉलीलाइन (उदाहरण के लिए, सड़क) या पॉलीगॉन (इलाका).
    • "APPROXIMATE" सिर्फ़ उन पतों को दिखाता है जो अनुमानित हैं.
  • extra_computations — जवाब में इन अतिरिक्त सुविधाओं के बारे में बताने के लिए, इस पैरामीटर का इस्तेमाल करें: एक ही एपीआई अनुरोध के लिए इनमें से कई सुविधाएं चालू करने के लिए, हर सुविधा के अनुरोध में extra_computations पैरामीटर शामिल करें. उदाहरण के लिए: 
    extra_computations=ADDRESS_DESCRIPTORS&extra_computations=BUILDING_AND_ENTRANCES

अगर 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

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