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

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

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

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

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

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

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

  • language — वह भाषा जिसमें नतीजे दिखाने हैं.
    • Google Ads में इस्तेमाल किए जा सकने वाले प्रॉडक्ट की सूची देखें भाषाएं में बदल दिया जाता है. Google अक्सर इस्तेमाल की जा सकने वाली भाषाओं को अपडेट करता रहता है. इसलिए, ऐसा हो सकता है कि यह सूची पूरी न हो.
    • अगर language नहीं दिया गया है, तो जियोकोडर, Accept-Language हेडर में बताई गई पसंदीदा भाषा या उस डोमेन की मूल भाषा का इस्तेमाल करने की कोशिश करता है जिससे अनुरोध भेजा गया है.
    • जियोकोडर सड़क का ऐसा पता देने की पूरी कोशिश करता है जो इसे उपयोगकर्ता और स्थानीय लोग, दोनों के लिए पढ़ा जा सकता है. उस लक्ष्य को हासिल करने के लिए, स्थानीय भाषा में मोहल्ले के पते दिखाता है, ताकि ज़रूरत पड़ने पर उपयोगकर्ता, पसंदीदा स्क्रिप्ट को देख सकता है भाषा. अन्य सभी पते, आपकी पसंदीदा भाषा में दिखाए जाते हैं. पते के सभी कॉम्पोनेंट, एक ही भाषा में दिखाए जाते हैं. जिसे पहले कॉम्पोनेंट से चुना गया है.
    • अगर कोई नाम पसंदीदा भाषा में उपलब्ध नहीं है, तो जियोकोडर इस्तेमाल करता है सबसे नज़दीकी मिलान.
  • region — क्षेत्र कोड, जो ccTLD के तौर पर तय किया गया है ("टॉप लेवल डोमेन") दो वर्णों की वैल्यू. पैरामीटर का असर लागू कानून के आधार पर तय करें.
  • result_type — एक या उससे ज़्यादा पतों के टाइप का फ़िल्टर, जिसे पाइप (|) से अलग किया गया है. अगर पैरामीटर में कई पतों के टाइप शामिल हैं, तो एपीआई उन सभी पतों को दिखाता है जो किसी भी टाइप से मैच करते हैं. प्रोसेसिंग के बारे में एक ज़रूरी जानकारी: result_type पैरामीटर में बताए गए पता प्रकार(पतों) से खोज को प्रतिबंधित करें. इसके बजाय, result_type, खोज के बाद वाले फ़िल्टर की तरह काम करता है: एपीआई सभी यूआरएल फ़ेच करता है चुने गए latlng के लिए नतीजे दिखाता है, फिर उन नतीजों को खारिज कर देता है जो बताए गए पता प्रकार(यों) से मेल नहीं खाता है.नीचे दिए गए मान हैं समर्थित:
    • street_address, सटीक मोहल्ले का पता दिखाता है.
    • route नाम वाले रास्ते के बारे में बताता है (जैसे कि "US 101").
    • intersection, आम तौर पर दो मुख्य सड़कों के मुख्य चौराहे के बारे में बताता है.
    • political किसी राजनैतिक इकाई के बारे में बताता है. आम तौर पर, इस टाइप से किसी सिविल एडमिनिस्ट्रेशन के पॉलीगॉन का पता चलता है.
    • country से किसी देश की राजनैतिक इकाई का पता चलता है. आम तौर पर, यह जियोकोडर से मिलने वाला सबसे ज़्यादा ऑर्डर टाइप होता है.
    • 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_5 के लिए sublocality_level_1. हर मोहल्ले का स्तर एक नागरिक इकाई होता है. बड़ी संख्या का मतलब है कि छोटी संख्या भौगोलिक क्षेत्र.
    • neighborhood, आस-पड़ोस का नाम दिखाता है
    • premise से किसी जगह का नाम पता चलता है. आम तौर पर, यह किसी इमारत या एक ही नाम वाली कई इमारतों का नाम होता है
    • subpremise किसी नाम के नीचे, पहले ऑर्डर की गई इकाई के बारे में बताता है स्थान, आमतौर पर इमारतों के समूह के अंदर एक अकेला इमारत होता है कोई सामान्य नाम
    • plus_code, एन्कोड की गई जगह के रेफ़रंस को दिखाता है. यह रेफ़रंस, अक्षांश और देशांतर से मिलता है. प्लस कोड का इस्तेमाल इनकी जगह पर किया जा सकता है उन स्थानों के पते जहां वे मौजूद नहीं हैं (जहां इमारतों को क्रमांकित न किया गया हो या सड़कों के नाम नहीं दिए गए हैं). ज़्यादा जानकारी के लिए, https://plus.codes पर जाएं.
    • postal_code, डाक पते के तौर पर इस्तेमाल किए जाने वाले पिन कोड के बारे में बताता है मेल भेजे जाते हैं.
    • natural_feature एक प्रमुख प्राकृतिक सुविधा दिखाता है.
    • airport, हवाई अड्डे का मतलब है.
    • park, नाम वाले पार्क को दिखाता है.
    • point_of_interest से, किसी लोकप्रिय जगह का नाम पता चलता है. आम तौर पर, ये "पीओआई" ऐसी लोकल इकाइयां होती हैं जिन्हें किसी दूसरी कैटगरी में आसानी से नहीं रखा जा सकता. जैसे, "एम्पायर स्टेट बिल्डिंग" या "एफ़िल टावर".
  • 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 फ़ील्ड में एक प्लस कोड होता है, जो अनुरोध किए गए अक्षांश और देशांतर का सबसे सही अनुमान लगाता है. इसके अलावा, ज़्यादातर मामलों में JSON के नतीजों के कलेक्शन में, पूरी जियोकोडिंग शामिल होती है plus_code टाइप और प्लस वाले पते के साथ नतीजा कोड. डिकोड किए गए प्लस कोड और अनुरोध किए गए पॉइंट के बीच की दूरी 10 मीटर से कम होनी चाहिए.