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