अनुरोध
Geocoding API का अनुरोध इस तरह किया जाता है:
https://maps.googleapis.com/maps/api/geocode/outputFormat?parameters
यहां outputFormat इनमें से कोई भी वैल्यू हो सकती है:
json(सुझाया गया) से पता चलता है कि आउटपुट JavaScript Object Notation (JSON) में है; याxmlएक्सएमएल में आउटपुट दिखाता है
एचटीटीपीएस ज़रूरी है.
कुछ पैरामीटर ज़रूरी होते हैं, जबकि कुछ ज़रूरी नहीं होते हैं. यूआरएल में स्टैंडर्ड के तौर पर, पैरामीटर को एंपरसैंड (&) वर्ण का इस्तेमाल करके अलग किया जाता है.
इस पेज के बाकी हिस्से में, जियोकोडिंग और रिवर्स जियोकोडिंग के बारे में अलग-अलग बताया गया है. ऐसा इसलिए, क्योंकि हर तरह के अनुरोध के लिए अलग-अलग पैरामीटर उपलब्ध होते हैं.
जियोकोडिंग (अक्षांश/देशांतर की जानकारी ढूंढना) पैरामीटर
जियोकोडिंग के अनुरोध में ये पैरामीटर शामिल होने चाहिए:
key— आपके ऐप्लिकेशन का एपीआई पासकोड. इस कुंजी से, कोटा मैनेजमेंट के लिए आपके ऐप्लिकेशन की पहचान होती है. कुंजी पाने का तरीका जानें.अनुरोध में, आपको
addressयाcomponentsया दोनों में से किसी एक की जानकारी देनी होगी:address— वह सड़क का पता या प्लस कोड जिसे आपको जियोकोड करना है. पते, उस देश की राष्ट्रीय डाक सेवा के इस्तेमाल किए गए फ़ॉर्मैट के मुताबिक होने चाहिए. पते में कारोबार का नाम और यूनिट, सुइट या फ़्लोर नंबर जैसी अतिरिक्त जानकारी शामिल नहीं करनी चाहिए. सड़क के पते के कॉम्पोनेंट को स्पेस से अलग किया जाना चाहिए (यहां%20के लिए यूआरएल-एस्केप के तौर पर दिखाया गया है):address=24%20Sussex%20Drive%20Ottawa%20ON
%2Bऔर स्पेस को यूआरएल-एस्केप करके%20में बदला जाता है:- ग्लोबल कोड, चार वर्णों वाला एरिया कोड और छह या उससे ज़्यादा वर्णों वाला लोकल कोड होता है. उदाहरण के लिए, 849VCWC8+R9
849VCWC8%2BR9है. - कंपाउंड कोड, छह या इससे ज़्यादा वर्णों वाला लोकल कोड होता है. इसमें जगह की जानकारी साफ़ तौर पर दी जाती है. जैसे, CWC8+R9 Mountain View, CA, USA
CWC8%2BR9%20Mountain%20View%20CA%20USAहै.
- ग्लोबल कोड, चार वर्णों वाला एरिया कोड और छह या उससे ज़्यादा वर्णों वाला लोकल कोड होता है. उदाहरण के लिए, 849VCWC8+R9
components— यह कॉम्पोनेंट फ़िल्टर है. इसमें मौजूद एलिमेंट को पाइप (|) से अलग किया जाता है. अगरaddressदिया गया है, तो कॉम्पोनेंट फ़िल्टर को वैकल्पिक पैरामीटर के तौर पर भी स्वीकार किया जाता है. कॉम्पोनेंट फ़िल्टर में मौजूद हर एलिमेंट मेंcomponent:valueपेयर होता है. साथ ही, यह जियोकोडर से मिलने वाले नतीजों को पूरी तरह से सीमित करता है. कॉम्पोनेंट फ़िल्टर करने के बारे में ज़्यादा जानकारी यहां दी गई है.
ज़्यादा जानकारी के लिए, अक्सर पूछे जाने वाले सवाल देखें.
जियोकोडिंग के अनुरोध में मौजूद ज़रूरी नहीं पैरामीटर:
bounds— व्यूपोर्ट का बाउंडिंग बॉक्स, जिसमें जियोकोड के नतीजों को ज़्यादा प्रमुखता से दिखाया जाता है. यह पैरामीटर, जियोकोडर से मिले नतीजों को पूरी तरह से नहीं, बल्कि सिर्फ़ कुछ हद तक सीमित करेगा. (ज़्यादा जानकारी के लिए, नीचे दिया गया व्यू पोर्ट बायसिंग सेक्शन देखें.)language— वह भाषा जिसमें नतीजे दिखाने हैं.- इस्तेमाल की जा सकने वाली भाषाओं की सूची देखें. Google, इस सुविधा के लिए उपलब्ध भाषाओं को अक्सर अपडेट करता रहता है. इसलिए, हो सकता है कि इस सूची में पूरी जानकारी शामिल न हो.
- अगर
languageनहीं दिया जाता है, तो जियोकोडरAccept-Languageहेडर में बताई गई पसंदीदा भाषा का इस्तेमाल करने की कोशिश करता है. इसके अलावा, वह उस डोमेन की मूल भाषा का इस्तेमाल करने की कोशिश करता है जिससे अनुरोध भेजा गया है. - जियोकोडर, सड़क का ऐसा पता देने की पूरी कोशिश करता है जिसे उपयोगकर्ता और स्थानीय लोग, दोनों पढ़ सकें. इस लक्ष्य को पूरा करने के लिए, यह स्थानीय भाषा में सड़क के पते दिखाता है. अगर ज़रूरी हो, तो यह उपयोगकर्ता की पसंदीदा भाषा में पते को लिप्यंतरित भी करता है. अन्य सभी पते, पसंदीदा भाषा में दिखाए जाते हैं. पते के सभी कॉम्पोनेंट, एक ही भाषा में दिखाए जाते हैं. यह भाषा, पहले कॉम्पोनेंट से चुनी जाती है.
- अगर नाम पसंदीदा भाषा में उपलब्ध नहीं है, तो जियोकोडर सबसे मिलते-जुलते नाम का इस्तेमाल करता है.
- पसंदीदा भाषा का असर, एपीआई से मिले नतीजों के सेट और उनके क्रम पर पड़ता है. जियोकोडर, भाषा के हिसाब से शॉर्ट फ़ॉर्म का अलग-अलग मतलब निकालता है. जैसे, सड़क के टाइप के लिए शॉर्ट फ़ॉर्म या ऐसे समानार्थी शब्द जो एक भाषा में मान्य हो सकते हैं, लेकिन दूसरी भाषा में नहीं. उदाहरण के लिए, हंगेरियन भाषा में utca और tér, सड़क और स्क्वेयर के समानार्थी शब्द हैं.
region— यह क्षेत्र का कोड है. इसे ccTLD ("टॉप लेवल डोमेन") के तौर पर तय किया जाता है. इसकी वैल्यू दो वर्णों की होती है. यह पैरामीटर, जियोकोडर से मिले नतीजों को पूरी तरह से नहीं, बल्कि सिर्फ़ कुछ हद तक सीमित करेगा. (ज़्यादा जानकारी के लिए, नीचे दिया गया क्षेत्र के हिसाब से खोज के नतीजों को बेहतर बनाना देखें.) लागू कानून के आधार पर, इस पैरामीटर से नतीजों पर भी असर पड़ सकता है.components— यह कॉम्पोनेंट फ़िल्टर है. इसमें मौजूद एलिमेंट को पाइप (|) से अलग किया जाता है. अगर अनुरोध मेंaddressशामिल नहीं है, तो कॉम्पोनेंट फ़िल्टर ज़रूरी है. कॉम्पोनेंट फ़िल्टर में मौजूद हर एलिमेंट मेंcomponent:valueपेयर होता है. साथ ही, यह जियोकोडर से मिलने वाले नतीजों को पूरी तरह से सीमित कर देता है. कॉम्पोनेंट फ़िल्टर करने के बारे में ज़्यादा जानकारी यहां दी गई है.extra_computations— इस पैरामीटर का इस्तेमाल करके, जवाब में ये अतिरिक्त सुविधाएं शामिल की जा सकती हैं:ADDRESS_DESCRIPTORS— ज़्यादा जानकारी के लिए, पता बताने वाले शब्द देखें.BUILDING_AND_ENTRANCES— ज़्यादा जानकारी के लिए, प्रवेश द्वार और बिल्डिंग की आउटलाइन देखें.
extra_computationsपैरामीटर शामिल करें. उदाहरण के लिए:extra_computations=ADDRESS_DESCRIPTORS&extra_computations=BUILDING_AND_ENTRANCES
जवाब
जियोकोडिंग के जवाब, यूआरएल अनुरोध में output फ़्लैग से तय किए गए फ़ॉर्मैट में मिलते हैं. इसके अलावा, डिफ़ॉल्ट रूप से JSON फ़ॉर्मैट में भी मिलते हैं.
इस उदाहरण में, Geocoding API, "1600 Amphitheatre Parkway, Mountain View, CA" पते के बारे में क्वेरी के लिए json
जवाब का अनुरोध करता है.
इस अनुरोध में, JSON output फ़्लैग का इस्तेमाल करने का तरीका दिखाया गया है:
https://maps.googleapis.com/maps/api/geocode/json?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA&key=YOUR_API_KEY
इस अनुरोध में, एक्सएमएल output फ़्लैग का इस्तेमाल करने का तरीका दिखाया गया है:
https://maps.googleapis.com/maps/api/geocode/xml?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA&key=YOUR_API_KEY
JSON और XML के जवाबों के सैंपल देखने के लिए, यहां दिए गए टैब चुनें.
JSON
{ "results": [ { "address_components": [ { "long_name": "1600", "short_name": "1600", "types": [ "street_number" ] }, { "long_name": "Amphitheatre Parkway", "short_name": "Amphitheatre Pkwy", "types": [ "route" ] }, { "long_name": "Mountain View", "short_name": "Mountain View", "types": [ "locality", "political" ] }, { "long_name": "Santa Clara County", "short_name": "Santa Clara County", "types": [ "administrative_area_level_2", "political" ] }, { "long_name": "California", "short_name": "CA", "types": [ "administrative_area_level_1", "political" ] }, { "long_name": "United States", "short_name": "US", "types": [ "country", "political" ] }, { "long_name": "94043", "short_name": "94043", "types": [ "postal_code" ] }, { "long_name": "1351", "short_name": "1351", "types": [ "postal_code_suffix" ] } ], "formatted_address": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA", "geometry": { "location": { "lat": 37.4222804, "lng": -122.0843428 }, "location_type": "ROOFTOP", "viewport": { "northeast": { "lat": 37.4237349802915, "lng": -122.083183169709 }, "southwest": { "lat": 37.4210370197085, "lng": -122.085881130292 } } }, "place_id": "ChIJRxcAvRO7j4AR6hm6tys8yA8", "plus_code": { "compound_code": "CWC8+W7 Mountain View, CA", "global_code": "849VCWC8+W7" }, "types": [ "street_address" ] } ], "status": "OK" }
ध्यान दें कि JSON रिस्पॉन्स में दो रूट एलिमेंट होते हैं:
"status"में अनुरोध के बारे में मेटाडेटा होता है. यहां स्टेटस कोड देखें."results"में, जियोकोड किए गए पते की जानकारी और ज्यामिति की जानकारी का कलेक्शन होता है.
आम तौर पर, पते की जानकारी ढूंढने के लिए "results" ऐरे में सिर्फ़ एक एंट्री मिलती है. हालांकि, पते की क्वेरी अस्पष्ट होने पर, जियोकोडर कई नतीजे दिखा सकता है.
XML
<GeocodeResponse> <status>OK</status> <result> <type>street_address</type> <formatted_address>1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA</formatted_address> <address_component> <long_name>1600</long_name> <short_name>1600</short_name> <type>street_number</type> </address_component> <address_component> <long_name>Amphitheatre Parkway</long_name> <short_name>Amphitheatre Pkwy</short_name> <type>route</type> </address_component> <address_component> <long_name>Mountain View</long_name> <short_name>Mountain View</short_name> <type>locality</type> <type>political</type> </address_component> <address_component> <long_name>Santa Clara County</long_name> <short_name>Santa Clara County</short_name> <type>administrative_area_level_2</type> <type>political</type> </address_component> <address_component> <long_name>California</long_name> <short_name>CA</short_name> <type>administrative_area_level_1</type> <type>political</type> </address_component> <address_component> <long_name>United States</long_name> <short_name>US</short_name> <type>country</type> <type>political</type> </address_component> <address_component> <long_name>94043</long_name> <short_name>94043</short_name> <type>postal_code</type> </address_component> <geometry> <location> <lat>37.4224428</lat> <lng>-122.0842467</lng> </location> <location_type>ROOFTOP</location_type> <viewport> <southwest> <lat>37.4212648</lat> <lng>-122.0856069</lng> </southwest> <northeast> <lat>37.4239628</lat> <lng>-122.0829089</lng> </northeast> </viewport> </geometry> <place_id>ChIJeRpOeF67j4AR9ydy_PIzPuM</place_id> <plus_code> <global_code>849VCWC8+X8</global_code> <compound_code>CWC8+X8 Mountain View, CA</compound_code> </plus_code> </result> </GeocodeResponse>
ध्यान दें कि XML जवाब में एक <GeocodeResponse> और दो टॉप-लेवल एलिमेंट शामिल होते हैं:
<status>में अनुरोध के बारे में मेटाडेटा होता है. यहां स्टेटस कोड देखें.- शून्य या उससे ज़्यादा
<result>एलिमेंट. हर एलिमेंट में, जियोकोड किए गए पते की जानकारी और ज्यामिति की जानकारी का एक सेट होता है.
XML रिस्पॉन्स, JSON रिस्पॉन्स से काफ़ी लंबा होता है. इसलिए, हमारा सुझाव है कि आप json को पसंदीदा आउटपुट फ़्लैग के तौर पर इस्तेमाल करें. हालांकि, अगर आपकी सेवा के लिए किसी वजह से xml ज़रूरी है, तो इसका इस्तेमाल किया जा सकता है.
इसके अलावा, XML ट्री को प्रोसेस करने के लिए कुछ बातों का ध्यान रखना ज़रूरी है, ताकि आप सही नोड और एलिमेंट का रेफ़रंस दे सकें. आउटपुट प्रोसेसिंग के लिए सुझाए गए कुछ डिज़ाइन पैटर्न के बारे में जानने के लिए,
XPath की मदद से एक्सएमएल पार्स करना लेख पढ़ें.
- एक्सएमएल के नतीजे, रूट
<GeocodeResponse>एलिमेंट में रैप किए जाते हैं. - JSON में, एक से ज़्यादा एलिमेंट वाली एंट्री को प्लुरल ऐरे (
types) से दिखाया जाता है. वहीं, XML में इन्हें सिंगुलर एलिमेंट (<type>) से दिखाया जाता है. - JSON में खाली एलिमेंट को खाली कलेक्शन के ज़रिए दिखाया जाता है. हालांकि, एक्सएमएल में ऐसे किसी भी एलिमेंट के मौजूद न होने से यह पता चलता है कि एलिमेंट खाली है. ऐसे रिस्पॉन्स में कोई नतीजा नहीं मिलता है. इसलिए, JSON में खाली
resultsकलेक्शन दिखता है. हालांकि, XML में कोई<result>एलिमेंट नहीं दिखता. उदाहरण के लिए, ऐसा तब होता है, जब कोई उपयोगकर्ता किसी ऐसे प्रॉडक्ट के बारे में पूछता है जो आपकी इन्वेंट्री में मौजूद नहीं है.
स्टेटस कोड
जियोकोडिंग के जवाब वाले ऑब्जेक्ट में मौजूद "status" फ़ील्ड में, अनुरोध की स्थिति होती है. इसमें डीबग करने से जुड़ी जानकारी भी हो सकती है. इससे आपको यह पता लगाने में मदद मिलती है कि जियोकोडिंग क्यों काम नहीं कर रही है. "status" फ़ील्ड में ये वैल्यू हो सकती हैं:
"OK"से पता चलता है कि कोई गड़बड़ी नहीं हुई है. पते को पार्स कर लिया गया है और कम से कम एक जियोकोड मिला है."ZERO_RESULTS"का मतलब है कि जियोकोड सही तरीके से किया गया है, लेकिन कोई नतीजा नहीं मिला. ऐसा तब हो सकता है, जब जियोकोडर को ऐसाaddressपास किया गया हो जो मौजूद नहीं है.OVER_DAILY_LIMITका मतलब इनमें से कोई भी हो सकता है:- एपीआई पासकोड मौजूद नहीं है या अमान्य है.
- आपके खाते में बिलिंग की सुविधा चालू नहीं है.
- इस्तेमाल की तय सीमा पार कर ली गई है.
- पेमेंट का दिया गया तरीका अब मान्य नहीं है. उदाहरण के लिए, क्रेडिट कार्ड की समयसीमा खत्म हो गई है.
इसे ठीक करने का तरीका जानने के लिए, Maps के बारे में अक्सर पूछे जाने वाले सवाल देखें.
"OVER_QUERY_LIMIT"का मतलब है कि आपने तय सीमा से ज़्यादा स्टोरेज का इस्तेमाल किया है."REQUEST_DENIED"का मतलब है कि आपका अनुरोध अस्वीकार कर दिया गया है."INVALID_REQUEST"से आम तौर पर यह पता चलता है कि क्वेरी (address,componentsयाlatlng) मौजूद नहीं है."UNKNOWN_ERROR"का मतलब है कि सर्वर की गड़बड़ी की वजह से अनुरोध को प्रोसेस नहीं किया जा सका. फिर से कोशिश करने पर, अनुरोध पूरा हो सकता है.
गड़बड़ी के मैसेज
जब जियोकोडर, OK के अलावा कोई दूसरा स्टेटस कोड दिखाता है, तो जियोकोडिंग रिस्पॉन्स ऑब्जेक्ट में एक और error_message फ़ील्ड मौजूद हो सकता है. इस फ़ील्ड में, दिए गए स्टेटस कोड की वजहों के बारे में ज़्यादा जानकारी होती है.
नतीजे
जियोकोडर, नतीजे मिलने पर उन्हें (JSON) results
ऐरे में रखता है. अगर जियोकोडर कोई नतीजा नहीं दिखाता है (जैसे, अगर पता मौजूद नहीं है), तो भी यह एक खाली results कलेक्शन दिखाता है. (XML जवाबों में, शून्य या उससे ज़्यादा <result> एलिमेंट होते हैं.)
किसी सामान्य नतीजे में ये फ़ील्ड शामिल होते हैं:
types[]ऐरे से, खोज के नतीजों के टाइप के बारे में पता चलता है. इस ऐरे में, ऐसे टैग का सेट होता है जो नतीजे में दिखाई गई सुविधा के टाइप की पहचान करते हैं. इसमें शून्य या इससे ज़्यादा टैग हो सकते हैं. उदाहरण के लिए, "शिकागो" के जियोकोड से "locality" मिलता है. इससे पता चलता है कि "शिकागो" एक शहर है. साथ ही, इससे "political" भी मिलता है. इससे पता चलता है कि यह एक राजनैतिक इकाई है. जब किसी पते के कॉम्पोनेंट के लिए कोई टाइप नहीं होता है, तब कॉम्पोनेंट में types ऐरे खाली हो सकता है. एपीआई, ज़रूरत के हिसाब से नई टाइप वैल्यू जोड़ सकता है. ज़्यादा जानकारी के लिए, पते के टाइप और पते के कॉम्पोनेंट लेख पढ़ें.formatted_addressएक स्ट्रिंग है. इसमें इस जगह का पता होता है, ताकि लोग इसे आसानी से पढ़ सकें.आम तौर पर, यह पता डाक पते के बराबर होता है. ध्यान दें कि कुछ देशों, जैसे कि यूनाइटेड किंगडम में लाइसेंस से जुड़ी पाबंदियों की वजह से, सही पोस्टल पते शेयर करने की अनुमति नहीं है.
फ़ॉर्मैट किया गया पता, एक या उससे ज़्यादा पते के कॉम्पोनेंट से मिलकर बना होता है. उदाहरण के लिए, "111 8th Avenue, New York, NY" पते में ये कॉम्पोनेंट शामिल हैं: "111" (सड़क का नंबर), "8th Avenue" (रास्ता), "New York" (शहर), और "NY" (अमेरिका का राज्य).
फ़ॉर्मैट किए गए पते को प्रोग्राम के हिसाब से पार्स न करें. इसके बजाय, आपको पते के अलग-अलग कॉम्पोनेंट का इस्तेमाल करना चाहिए. एपीआई रिस्पॉन्स में, फ़ॉर्मैट किए गए पते वाले फ़ील्ड के साथ-साथ ये कॉम्पोनेंट भी शामिल होते हैं.
address_components[]एक कैटगरी है. इसमें इस पते पर लागू होने वाले अलग-अलग कॉम्पोनेंट शामिल होते हैं.आम तौर पर, पते के हर कॉम्पोनेंट में ये फ़ील्ड शामिल होते हैं:
types[]एक ऐसा कलेक्शन है जो पते के कॉम्पोनेंट के टाइप के बारे में बताता है. इस्तेमाल किए जा सकने वाले टाइप की सूची देखें.long_name, पते के कॉम्पोनेंट का पूरा टेक्स्ट ब्यौरा या नाम है. यह Geocoder से मिलता है.short_name, पते के कॉम्पोनेंट का छोटा किया गया नाम है. यह तब दिखता है, जब यह उपलब्ध हो. उदाहरण के लिए, अलास्का राज्य के पते के कॉम्पोनेंट में,long_nameकी वैल्यू "अलास्का" औरshort_nameकी वैल्यू "AK" हो सकती है. इसके लिए, दो अक्षरों वाले पोस्टल कोड का इस्तेमाल किया जाता है.
address_components[]ऐरे के बारे में यहां दी गई बातों का ध्यान रखें:- पते के कॉम्पोनेंट के ऐरे में,
formatted_addressसे ज़्यादा कॉम्पोनेंट हो सकते हैं. - इस कैटगरी में, ऐसी सभी राजनैतिक इकाइयां शामिल नहीं होती हैं जिनमें पता होता है. हालांकि, इसमें
formatted_addressमें शामिल इकाइयां शामिल होती हैं. किसी खास पते वाली सभी राजनैतिक इकाइयों को फिर से पाने के लिए, आपको रिवर्स जियोकोडिंग का इस्तेमाल करना चाहिए. इसके लिए, अनुरोध में पते के अक्षांश/देशांतर को पैरामीटर के तौर पर पास करें. - यह ज़रूरी नहीं है कि अनुरोधों के बीच, जवाब का फ़ॉर्मैट एक जैसा ही रहे. खास तौर पर,
address_componentsकी संख्या, अनुरोध किए गए पते के हिसाब से अलग-अलग होती है. साथ ही, एक ही पते के लिए समय के साथ बदल सकती है. किसी कॉम्पोनेंट की पोज़िशन को ऐरे में बदला जा सकता है. कॉम्पोनेंट का टाइप बदला जा सकता है. ऐसा हो सकता है कि बाद के जवाब में कोई कॉम्पोनेंट मौजूद न हो.
कॉम्पोनेंट के ऐरे को मैनेज करने के लिए, आपको जवाब को पार्स करना चाहिए. साथ ही, एक्सप्रेशन के ज़रिए सही वैल्यू चुननी चाहिए. रिस्पॉन्स को पार्स करने से जुड़ी गाइड देखें.
postcode_localities[]एक ऐसा कलेक्शन है जो किसी पिन कोड में मौजूद 100 इलाकों के बारे में बताता है. यह जानकारी सिर्फ़ तब दिखती है, जब खोज के नतीजे में ऐसा पिन कोड शामिल होता है जिसमें कई इलाके शामिल होते हैं.geometryमें यह जानकारी शामिल होती है:locationमें जियोकोड किया गया अक्षांश और देशांतर शामिल होता है. सामान्य पते की जानकारी ढूंढने के लिए, यह फ़ील्ड आम तौर पर सबसे अहम होता है.location_typeकुकी, तय की गई जगह के बारे में अतिरिक्त डेटा सेव करती है. फ़िलहाल, इन वैल्यू का इस्तेमाल किया जा सकता है:"ROOFTOP"से पता चलता है कि खोज के नतीजे में मिला सटीक जियोकोड, उस जगह का है जिसकी जानकारी हमारे पास है. यह जानकारी, सड़क के पते के हिसाब से सटीक है."RANGE_INTERPOLATED"से पता चलता है कि खोज के नतीजे में दिखाई गई जगह, दो सटीक जगहों (जैसे कि चौराहे) के बीच में मौजूद है. आम तौर पर, यह सड़क पर मौजूद होती है. आम तौर पर, इंटरपोलेट किए गए नतीजे तब दिखाए जाते हैं, जब किसी सड़क के पते के लिए रूफ़टॉप जियोकोड उपलब्ध नहीं होते हैं."GEOMETRIC_CENTER"से पता चलता है कि ज्यामितीय केंद्र के तौर पर दिखाया गया नतीजा, किसी नतीजे का हिस्सा है. जैसे, पॉलीलाइन (उदाहरण के लिए, कोई सड़क) या पॉलीगॉन (क्षेत्र)."APPROXIMATE"से पता चलता है कि दिखाया गया नतीजा अनुमानित है.
viewportमें, खोज के नतीजों को दिखाने के लिए सुझाया गया व्यूपोर्ट शामिल होता है. इसे अक्षांश और देशांतर की दो वैल्यू के तौर पर दिखाया जाता है. ये वैल्यू,व्यूपोर्ट बाउंडिंग बॉक्स केsouthwestऔरnortheastकोने को तय करती हैं. आम तौर पर, उपयोगकर्ता को कोई नतीजा दिखाते समय, उसे फ़्रेम करने के लिए व्यूपोर्ट का इस्तेमाल किया जाता है.bounds(ज़रूरी नहीं) में बाउंडिंग बॉक्स सेव होता है. यह बाउंडिंग बॉक्स, नतीजे में मिली पूरी जानकारी को शामिल कर सकता है. ध्यान दें कि ये सीमाएं, सुझाई गई व्यूपोर्ट से मेल नहीं खा सकती हैं. (उदाहरण के लिए, सैन फ़्रांसिस्को में फ़ारालोन द्वीप शामिल हैं. तकनीकी तौर पर, ये शहर का हिस्सा हैं, लेकिन शायद इन्हें व्यूपोर्ट में नहीं दिखाना चाहिए.)
-
plus_code(ओपन लोकेशन कोड और प्लस कोड देखें) एक एन्कोड किया गया लोकेशन रेफ़रंस है. यह अक्षांश और देशांतर के निर्देशांकों से मिलता है. यह एक इलाके को दिखाता है: 1/8000 डिग्री गुणा 1/8000 डिग्री (भूमध्य रेखा पर करीब 14 मीटर x 14 मीटर) या इससे छोटा. प्लस कोड का इस्तेमाल, उन जगहों पर मोहल्ले के पतों की जगह किया जा सकता है जहां पते मौजूद नहीं हैं. जैसे, जहां बिल्डिंग के नंबर नहीं हैं या सड़कों के नाम नहीं हैं. यह ज़रूरी नहीं है कि एपीआई हमेशा प्लस कोड दिखाए.जब सेवा Plus Code दिखाती है, तो उसे ग्लोबल कोड और कंपाउंड कोड के तौर पर फ़ॉर्मैट किया जाता है:
global_codeचार वर्णों वाला एरिया कोड और छह या इससे ज़्यादा वर्णों वाला लोकल कोड होता है (849VCWC8+R9).compound_codeछह या इससे ज़्यादा वर्णों वाला स्थानीय कोड है. इसमें जगह की जानकारी साफ़ तौर पर दी गई है (CWC8+R9, Mountain View, CA, USA). इस कॉन्टेंट को प्रोग्राम के हिसाब से पार्स न करें.
-
partial_matchका मतलब है कि जियोकोडर ने मूल अनुरोध से पूरी तरह मेल खाने वाला नतीजा नहीं दिया. हालांकि, वह अनुरोध किए गए पते के कुछ हिस्से से मेल खाने वाला नतीजा दे पाया. ऐसा हो सकता है कि आपने पते में स्पेलिंग गलत लिखी हो और/या पता अधूरा हो. इसलिए, हम आपको मूल अनुरोध की जांच करने का सुझाव देते हैं.पते के कुछ हिस्से का मेल न खाना, आम तौर पर उन सड़कों के पतों के लिए होता है जो अनुरोध में दिए गए इलाके में मौजूद नहीं हैं. जब कोई अनुरोध, एक ही इलाके में मौजूद दो या उससे ज़्यादा जगहों से मेल खाता है, तब भी आंशिक रूप से मेल खाने वाले नतीजे दिखाए जा सकते हैं. उदाहरण के लिए, "Hillpar St, Bristol, UK" के लिए, हेनरी स्ट्रीट और हेनरीटा स्ट्रीट, दोनों के लिए आंशिक तौर पर मेल खाने वाला नतीजा दिखेगा. ध्यान दें कि अगर किसी अनुरोध में पते के कॉम्पोनेंट की स्पेलिंग गलत है, तो जियोकोडिंग सेवा पते का कोई दूसरा सुझाव दे सकती है. इस तरह ट्रिगर किए गए सुझावों को भी आंशिक मिलान के तौर पर मार्क किया जाएगा.
place_idएक यूनीक आइडेंटिफ़ायर है, जिसका इस्तेमाल Google के अन्य एपीआई के साथ किया जा सकता है. उदाहरण के लिए, किसी स्थानीय कारोबार के बारे में जानकारी पाने के लिए, Places API के अनुरोध मेंplace_idका इस्तेमाल किया जा सकता है. जैसे, फ़ोन नंबर, खुले होने का समय, उपयोगकर्ता की समीक्षाएं वगैरह. जगह के आईडी के बारे में खास जानकारी देखें.
पते के टाइप और पते के कॉम्पोनेंट के टाइप
जवाब में मौजूद types कलेक्शन, पते का टाइप दिखाता है. पते के टाइप के उदाहरणों में, सड़क का पता, देश या राजनैतिक इकाई शामिल है. address_component फ़ील्ड में मौजूद 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.
ऊपर दी गई जानकारी के अलावा, पते के कॉम्पोनेंट में यहां दिए गए टाइप भी शामिल हो सकते हैं.
| पते के कॉम्पोनेंट का टाइप | ब्यौरा |
|---|---|
floor |
इमारत के पते का फ़्लोर. |
establishment |
आम तौर पर, ऐसी जगह जिसे अब तक किसी कैटगरी में नहीं रखा गया है. |
landmark |
आस-पास की कोई जगह, जिसका इस्तेमाल नेविगेशन में मदद पाने के लिए किया जाता है. |
point_of_interest |
नाम वाली कोई लोकप्रिय जगह. |
parking |
पार्किंग की जगह या पार्किंग की सुविधा. |
post_box |
कोई पोस्ट ऑफ़िस बॉक्स. |
postal_town |
यह भौगोलिक क्षेत्रों का ग्रुप होता है. जैसे, locality और sublocality. इसका इस्तेमाल कुछ देशों में डाक पते के लिए किया जाता है. |
room |
इमारत के पते में मौजूद कमरा. |
street_number |
सड़क का सटीक नंबर. |
bus_station, train_station, और transit_station |
बस, ट्रेन या सार्वजनिक परिवहन के स्टॉप की जगह. |
व्यूपोर्ट के हिसाब से नतीजे दिखाना
जियोकोडिंग के अनुरोध में, जियोकोडिंग सेवा को यह निर्देश दिया जा सकता है कि वह दिए गए व्यूपोर्ट (बाउंडिंग बॉक्स के तौर पर दिखाया गया) में मौजूद नतीजों को प्राथमिकता दे. इसके लिए, अनुरोध किए गए यूआरएल में bounds पैरामीटर सेट करें.
bounds पैरामीटर, इस बाउंडिंग बॉक्स के दक्षिण-पश्चिम और उत्तर-पूर्व कोनों के अक्षांश/देशांतर निर्देशांकों को तय करता है. इसके लिए, पाइप (|) वर्ण का इस्तेमाल करके निर्देशांकों को अलग किया जाता है.
उदाहरण के लिए, "वॉशिंगटन" के लिए आम तौर पर, अमेरिका के वॉशिंगटन राज्य का जियोकोड मिलता है:
अनुरोध:
https://maps.googleapis.com/maps/api/geocode/json?address=Washington&key=YOUR_API_KEY
जवाब:
{
"results" : [
{
"address_components" : [
{
"long_name" : "Washington",
"short_name" : "WA",
"types" : [ "administrative_area_level_1", "political" ]
},
{
"long_name" : "United States",
"short_name" : "US",
"types" : [ "country", "political" ]
}
],
"formatted_address" : "Washington, USA",
"geometry" : {
"bounds" : {
"northeast" : {
"lat" : 49.0024442,
"lng" : -116.91558
},
"southwest" : {
"lat" : 45.543541,
"lng" : -124.8489739
}
},
"location" : {
"lat" : 47.7510741,
"lng" : -120.7401385
},
"location_type" : "APPROXIMATE",
"viewport" : {
"northeast" : {
"lat" : 49.0024442,
"lng" : -116.91558
},
"southwest" : {
"lat" : 45.543541,
"lng" : -124.8489739
}
}
},
"place_id" : "ChIJ-bDD5__lhVQRuvNfbGh4QpQ",
"types" : [ "administrative_area_level_1", "political" ]
}
],
"status" : "OK"
}
हालांकि, अमेरिका के उत्तर-पूर्वी हिस्से के आस-पास बाउंडिंग बॉक्स तय करने वाला bounds आर्ग्युमेंट जोड़ने पर, यह जियोकोड वॉशिंगटन, डी॰सी॰ शहर का जियोकोड दिखाता है:
अनुरोध:
https://maps.googleapis.com/maps/api/geocode/json?address=Washington&bounds=36.47,-84.72%7C43.39,-65.90&key=YOUR_API_KEY
जवाब:
{
"results" : [
{
"address_components" : [
{
"long_name" : "Washington",
"short_name" : "Washington",
"types" : [ "locality", "political" ]
},
{
"long_name" : "District of Columbia",
"short_name" : "District of Columbia",
"types" : [ "administrative_area_level_2", "political" ]
},
{
"long_name" : "District of Columbia",
"short_name" : "DC",
"types" : [ "administrative_area_level_1", "political" ]
},
{
"long_name" : "United States",
"short_name" : "US",
"types" : [ "country", "political" ]
}
],
"formatted_address" : "Washington, DC, USA",
"geometry" : {
"bounds" : {
"northeast" : {
"lat" : 38.9958641,
"lng" : -76.90939299999999
},
"southwest" : {
"lat" : 38.7916449,
"lng" : -77.119759
}
},
"location" : {
"lat" : 38.9071923,
"lng" : -77.03687069999999
},
"location_type" : "APPROXIMATE",
"viewport" : {
"northeast" : {
"lat" : 38.9958641,
"lng" : -76.90939299999999
},
"southwest" : {
"lat" : 38.7916449,
"lng" : -77.119759
}
}
},
"place_id" : "ChIJW-T2Wt7Gt4kRKl2I1CJFUsI",
"types" : [ "locality", "political" ]
}
],
"status" : "OK"
}
क्षेत्र के हिसाब से प्राथमिकता तय करना
Geocoding के अनुरोध में, Geocoding सेवा को यह निर्देश दिया जा सकता है कि वह region पैरामीटर का इस्तेमाल करके, किसी खास इलाके के हिसाब से नतीजे दिखाए. यह पैरामीटर, ccTLD (देश के कोड के हिसाब से टॉप लेवल डोमेन) आर्ग्युमेंट लेता है. इससे क्षेत्र के हिसाब से खोज के नतीजों में बदलाव होता है. ज़्यादातर ccTLD कोड, आईएसओ 3166-1 कोड के जैसे ही होते हैं. हालांकि, कुछ मामलों में ये अलग होते हैं. उदाहरण के लिए, यूनाइटेड किंगडम का ccTLD "uk" (.co.uk) है, जबकि इसका आईएसओ 3166-1 कोड "gb" है (तकनीकी तौर पर, यह "ग्रेट ब्रिटेन और उत्तरी आयरलैंड के यूनाइटेड किंगडम" के लिए है).
जियोकोडिंग के नतीजे, हर उस डोमेन के लिए पक्षपाती हो सकते हैं जिसमें Google Maps ऐप्लिकेशन आधिकारिक तौर पर लॉन्च किया गया है. ध्यान दें कि किसी डोमेन को प्राथमिकता देने का मतलब यह नहीं है कि उस डोमेन के बाहर के ज़्यादा काम के नतीजे शामिल नहीं किए जाएंगे. इसका मतलब सिर्फ़ यह है कि उस डोमेन के नतीजों को प्राथमिकता दी जाएगी.
उदाहरण के लिए, "टॉलेडो" के लिए जियोकोड करने पर यह नतीजा मिलता है, क्योंकि Geocoding API के लिए डिफ़ॉल्ट डोमेन, अमेरिका पर सेट है. अनुरोध:
https://maps.googleapis.com/maps/api/geocode/json?address=Toledo&key=YOUR_API_KEY
जवाब:
{
"results" : [
{
"address_components" : [
{
"long_name" : "Toledo",
"short_name" : "Toledo",
"types" : [ "locality", "political" ]
},
{
"long_name" : "Lucas County",
"short_name" : "Lucas County",
"types" : [ "administrative_area_level_2", "political" ]
},
{
"long_name" : "Ohio",
"short_name" : "OH",
"types" : [ "administrative_area_level_1", "political" ]
},
{
"long_name" : "United States",
"short_name" : "US",
"types" : [ "country", "political" ]
}
],
"formatted_address" : "Toledo, OH, USA",
"geometry" : {
"bounds" : {
"northeast" : {
"lat" : 41.732844,
"lng" : -83.454229
},
"southwest" : {
"lat" : 41.580266,
"lng" : -83.69423700000002
}
},
"location" : {
"lat" : 41.6639383,
"lng" : -83.55521200000001
},
"location_type" : "APPROXIMATE",
"viewport" : {
"northeast" : {
"lat" : 41.732844,
"lng" : -83.454229
},
"southwest" : {
"lat" : 41.580266,
"lng" : -83.69423700000002
}
}
},
"place_id" : "ChIJeU4e_C2HO4gRRcM6RZ_IPHw",
"types" : [ "locality", "political" ]
}
],
"status" : "OK"
}
region=es (स्पेन) के साथ "टोलेडो" के लिए जियोकोडिंग का अनुरोध करने पर, स्पेन के शहर की जानकारी मिलेगी.
अनुरोध:
https://maps.googleapis.com/maps/api/geocode/json?address=Toledo®ion=es&key=YOUR_API_KEY
जवाब:
{
"results" : [
{
"address_components" : [
{
"long_name" : "Toledo",
"short_name" : "Toledo",
"types" : [ "locality", "political" ]
},
{
"long_name" : "Toledo",
"short_name" : "TO",
"types" : [ "administrative_area_level_2", "political" ]
},
{
"long_name" : "Castile-La Mancha",
"short_name" : "CM",
"types" : [ "administrative_area_level_1", "political" ]
},
{
"long_name" : "Spain",
"short_name" : "ES",
"types" : [ "country", "political" ]
}
],
"formatted_address" : "Toledo, Spain",
"geometry" : {
"bounds" : {
"northeast" : {
"lat" : 39.88605099999999,
"lng" : -3.9192423
},
"southwest" : {
"lat" : 39.8383676,
"lng" : -4.0796176
}
},
"location" : {
"lat" : 39.8628316,
"lng" : -4.027323099999999
},
"location_type" : "APPROXIMATE",
"viewport" : {
"northeast" : {
"lat" : 39.88605099999999,
"lng" : -3.9192423
},
"southwest" : {
"lat" : 39.8383676,
"lng" : -4.0796176
}
}
},
"place_id" : "ChIJ8f21C60Lag0R_q11auhbf8Y",
"types" : [ "locality", "political" ]
}
],
"status" : "OK"
}
कॉम्पोनेंट फ़िल्टर करना
Geocoding API, Geocoding के जवाब में किसी खास इलाके के पते के नतीजे दिखा सकता है. components फ़िल्टर का इस्तेमाल करके, पाबंदी तय की जा सकती है. फ़िल्टर में, पाइप (|) से अलग किए गए component:value
जोड़े की सूची होती है. फ़िल्टर वैल्यू में, स्पेलिंग ठीक करने और कुछ हद तक मेल खाने के लिए, वही तरीके इस्तेमाल किए जाते हैं जो अन्य जियोकोडिंग अनुरोधों में इस्तेमाल किए जाते हैं. अगर जियोकोडर को कॉम्पोनेंट फ़िल्टर से मिलता-जुलता कोई हिस्सा मिलता है, तो जवाब में partial_match फ़ील्ड शामिल होगा.
components को फ़िल्टर किया जा सकता है. इनमें ये शामिल हैं:
postal_code,postal_codeऔरpostal_code_prefixसे मेल खाता है.country, देश के नाम या दो अक्षरों वाले ISO 3166-1 देश कोड से मेल खाता है. एपीआई, देशों को तय करने के लिए आईएसओ स्टैंडर्ड का पालन करता है. साथ ही, देश के आईएसओ कोड का इस्तेमाल करने पर फ़िल्टर करने की सुविधा सबसे अच्छी तरह से काम करती है.
नतीजों को बेहतर बनाने के लिए, यहां दिए गए components का इस्तेमाल किया जा सकता है. हालांकि, इन्हें लागू करना ज़रूरी नहीं है:
route, किसी रूट के पूरे नाम या छोटे नाम से मेल खाता है.locality,localityऔरsublocalityटाइप से मैच करता है.administrative_areaसभीadministrative_areaलेवल से मेल खाता है.
कॉम्पोनेंट फ़िल्टर करने के बारे में जानकारी:
- अनुरोधों में इन कॉम्पोनेंट फ़िल्टर को दोहराएं नहीं. ऐसा करने पर, एपीआई यह जवाब देगा:
Invalid_request:country,postal_code,route - अगर अनुरोध में कॉम्पोनेंट फ़िल्टर को दोहराया जाता है, तो एपीआई उन फ़िल्टर का आकलन AND के तौर पर करता है, न कि OR के तौर पर.
- नतीजे, Google Maps के नतीजों से मिलते-जुलते हैं. हालाँकि, कभी-कभी
ZERO_RESULTSसे ऐसे जवाब मिल जाते हैं जिनकी हमने उम्मीद नहीं की होती. किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा का इस्तेमाल करने से, कुछ मामलों में बेहतर नतीजे मिल सकते हैं. ज़्यादा जानने के लिए, अक्सर पूछे जाने वाले यह सवाल पढ़ें. - पते के हर कॉम्पोनेंट के लिए, उसे
addressपैरामीटर याcomponentsफ़िल्टर में से किसी एक में तय करें. दोनों में तय न करें. दोनों में एक जैसी वैल्यू देने पर,ZERO_RESULTSमिल सकता है.
"हाई स्ट्रीट, हैस्टिंग्स" के लिए components=country:GB का इस्तेमाल करने पर, नतीजे में अमेरिका के हैस्टिंग्स-ऑन-हडसन के बजाय, इंग्लैंड के हैस्टिंग्स की जानकारी मिलती है.
अनुरोध:
https://maps.googleapis.com/maps/api/geocode/json?address=high+st+hasting&components=country:GB&key=YOUR_API_KEY
जवाब:
{
"results" : [
{
"address_components" : [
{
"long_name" : "High Street",
"short_name" : "High St",
"types" : [ "route" ]
},
{
"long_name" : "Hastings",
"short_name" : "Hastings",
"types" : [ "postal_town" ]
},
{
"long_name" : "East Sussex",
"short_name" : "East Sussex",
"types" : [ "administrative_area_level_2", "political" ]
},
{
"long_name" : "England",
"short_name" : "England",
"types" : [ "administrative_area_level_1", "political" ]
},
{
"long_name" : "United Kingdom",
"short_name" : "GB",
"types" : [ "country", "political" ]
},
{
"long_name" : "TN34 3EY",
"short_name" : "TN34 3EY",
"types" : [ "postal_code" ]
}
],
"formatted_address" : "High St, Hastings TN34 3EY, UK",
"geometry" : {
"bounds" : {
"northeast" : {
"lat" : 50.8601041,
"lng" : 0.5957329
},
"southwest" : {
"lat" : 50.8559061,
"lng" : 0.5906163
}
},
"location" : {
"lat" : 50.85830319999999,
"lng" : 0.5924594
},
"location_type" : "GEOMETRIC_CENTER",
"viewport" : {
"northeast" : {
"lat" : 50.8601041,
"lng" : 0.5957329
},
"southwest" : {
"lat" : 50.8559061,
"lng" : 0.5906163
}
}
},
"partial_match" : true,
"place_id" : "ChIJ-Ws929sa30cRKgsMNVkPyws",
"types" : [ "route" ]
}
],
"status" : "OK"
}
components=country:ES के साथ "Santa Cruz" इलाके के लिए जियोकोड अनुरोध करने पर, स्पेन के कैनेरी द्वीप समूह में मौजूद सांता क्रूज़ डे टेनेरिफ़ मिलता है.
अनुरोध:
https://maps.googleapis.com/maps/api/geocode/json?components=locality:santa+cruz|country:ES&key=YOUR_API_KEY
जवाब:
{
"results" : [
{
"address_components" : [
{
"long_name" : "Santa Cruz de Tenerife",
"short_name" : "Santa Cruz de Tenerife",
"types" : [ "locality", "political" ]
},
{
"long_name" : "Santa Cruz de Tenerife",
"short_name" : "TF",
"types" : [ "administrative_area_level_2", "political" ]
},
{
"long_name" : "Canary Islands",
"short_name" : "CN",
"types" : [ "administrative_area_level_1", "political" ]
},
{
"long_name" : "Spain",
"short_name" : "ES",
"types" : [ "country", "political" ]
}
],
"formatted_address" : "Santa Cruz de Tenerife, Spain",
"geometry" : {
"bounds" : {
"northeast" : {
"lat" : 28.487616,
"lng" : -16.2356646
},
"southwest" : {
"lat" : 28.4280248,
"lng" : -16.3370045
}
},
"location" : {
"lat" : 28.4636296,
"lng" : -16.2518467
},
"location_type" : "APPROXIMATE",
"viewport" : {
"northeast" : {
"lat" : 28.487616,
"lng" : -16.2356646
},
"southwest" : {
"lat" : 28.4280248,
"lng" : -16.3370045
}
}
},
"place_id" : "ChIJcUElzOzMQQwRLuV30nMUEUM",
"types" : [ "locality", "political" ]
}
],
"status" : "OK"
}
कॉम्पोनेंट फ़िल्टर करने की सुविधा, ZERO_RESULTS रिस्पॉन्स सिर्फ़ तब देती है, जब ऐसे फ़िल्टर दिए जाते हैं जो एक-दूसरे को शामिल नहीं करते.
अनुरोध:
https://maps.googleapis.com/maps/api/geocode/json?components=administrative_area:TX|country:FR&key=YOUR_API_KEY
जवाब:
{
"results" : [],
"status" : "ZERO_RESULTS"
}
components फ़िल्टर का इस्तेमाल करके, पते के पैरामीटर के बिना मान्य क्वेरी की जा सकती हैं. (पूरे पते को जियोकोड करते समय, अगर अनुरोध में इमारतों के नाम और नंबर शामिल हैं, तो address पैरामीटर ज़रूरी है.)
अनुरोध:
https://maps.googleapis.com/maps/api/geocode/json?components=route:Annankatu|administrative_area:Helsinki|country:Finland&key=YOUR_API_KEY
जवाब:
{
"results" : [
{
"address_components" : [
{
"long_name" : "Annankatu",
"short_name" : "Annankatu",
"types" : [ "route" ]
},
{
"long_name" : "Helsinki",
"short_name" : "HKI",
"types" : [ "locality", "political" ]
},
{
"long_name" : "Finland",
"short_name" : "FI",
"types" : [ "country", "political" ]
},
{
"long_name" : "00101",
"short_name" : "00101",
"types" : [ "postal_code" ]
}
],
"formatted_address" : "Annankatu, 00101 Helsinki, Finland",
"geometry" : {
"bounds" : {
"northeast" : {
"lat" : 60.168997,
"lng" : 24.9433353
},
"southwest" : {
"lat" : 60.16226160000001,
"lng" : 24.9332897
}
},
"location" : {
"lat" : 60.1657808,
"lng" : 24.938451
},
"location_type" : "GEOMETRIC_CENTER",
"viewport" : {
"northeast" : {
"lat" : 60.168997,
"lng" : 24.9433353
},
"southwest" : {
"lat" : 60.16226160000001,
"lng" : 24.9332897
}
}
},
"place_id" : "ChIJARW7C8sLkkYRgl4je4-RPUM",
"types" : [ "route" ]
}
],
"status" : "OK"
}