जियोकोडिंग का मतलब आम तौर पर ऐसे टेक्स्ट का अनुवाद होता है जिसे कोई भी व्यक्ति आसानी से पढ़ सकता है मैप पर किसी जगह पर जोड़ें. इसके उलट, ऐसा करने की मैप पर किसी स्थान का ऐसे पते में अनुवाद करना जिसे लोग पढ़ सकें, इसे रिवर्स जियोकोडिंग.
रिवर्स जियोकोडिंग अनुरोध
ज़रूरी पैरामीटर
latlng
— अक्षांश और देशांतर उस स्थान को बताने वाले निर्देशांक, जिसके लिए आप सबसे नज़दीक चाहते हैं, ऐसा ईमेल पता जिसे कोई भी व्यक्ति आसानी से पढ़ सके.key
— आपके ऐप्लिकेशन की API कुंजी. इस कुंजी से पता चलता है कि कोटा मैनेजमेंट के मकसद से आपका ऐप्लिकेशन. सीखें कि कैसे कुंजी पाएं.
ज़रूरी नहीं पैरामीटर
ये ऐसे वैकल्पिक पैरामीटर हैं जिन्हें उलटा शामिल किया जा सकता है जियोकोडिंग अनुरोध:
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
का मतलब है, पहले ऑर्डर की सिविल इकाई देश के स्तर से कम है. अमेरिका के अंदर, राज्य स्तर का मतलब राज्य है. सभी देशों में यह जानकारी नहीं दिखती एडमिन वाले लेवल की शर्तें पूरी करता है. ज़्यादातर मामलों में, 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_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
— इसे तय करने के लिए इस पैरामीटर का इस्तेमाल करें जवाब में ये अतिरिक्त सुविधाएँ जोड़ी गई हैं:ADDRESS_DESCRIPTORS
— देखें पता डिस्क्रिप्टर का इस्तेमाल करें.BUILDING_AND_ENTRANCES
— देखें ज़्यादा जानकारी के लिए, एंट्री और बिल्डिंग की आउटलाइन देखें.
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 मीटर से कम होने की गारंटी है.