अनुरोध
Geocoding API का अनुरोध इस तरह से किया जा सकता है:
https://maps.googleapis.com/maps/api/geocode/outputFormat?parameters
जहां outputFormat
इनमें से कोई एक वैल्यू हो सकती है:
json
(सुझाया गया), JavaScript ऑब्जेक्ट नोटेशन (JSON) में आउटपुट दिखाता है; याxml
, एक्सएमएल में आउटपुट दिखाता है
एचटीटीपीएस ज़रूरी है.
कुछ पैरामीटर ज़रूरी होते हैं, जबकि कुछ वैकल्पिक होते हैं. जैसा कि यूआरएल में स्टैंडर्ड होता है,
पैरामीटर को एंपरसैंड (&
) वर्ण का इस्तेमाल करके अलग किया जाता है.
इस पेज के बाकी हिस्से में जियोकोडिंग और अलग से रिवर्स जियोकोडिंग की वजह से, हर तरह के अनुरोध के लिए अलग-अलग पैरामीटर उपलब्ध हैं.
जियोकोडिंग (अक्षांश/देशांतर लुकअप) पैरामीटर
जियोकोडिंग के अनुरोध के लिए ज़रूरी पैरामीटर:
address
— मोहल्ले का पता या प्लस कोड जिन्हें आप जियोकोड करना चाहते हैं. इस फ़ॉर्मैट के हिसाब से पतों की जानकारी दें टारगेट किए गए देश की राष्ट्रीय डाक सेवा इस्तेमाल करती है. अन्य जानकारी पते के एलिमेंट, जैसे कि कारोबार के नाम और यूनिट, सुइट या फ़्लोर नंबर ऐसा करने से बचना चाहिए. मोहल्ले के पते के एलिमेंट को खाली जगह से अलग करना चाहिए (%20
को यूआरएल-एस्केप्ड के तौर पर यहां दिखाया गया है):address=24%20Sussex%20Drive%20Ottawa%20ON
यहां दिए गए तरीके के मुताबिक प्लस कोड फ़ॉर्मैट करें (प्लस साइन को%2B
पर यूआरएल एस्केप और स्पेस को%20
में यूआरएल एस्केप किया जाता है):- ग्लोबल कोड, चार वर्णों का एरिया कोड और छह या उससे ज़्यादा वर्ण का कोड है
लोकल कोड (849VCWT8+R9,
849VCWC8%2BR9
है). - कंपाउंड कोड, छह या इससे ज़्यादा वर्णों का लोकल कोड होता है. इसमें
किसी भी अश्लील जगह की जानकारी (CWT8+R9 Mountain View, CA, USA
CWC8%2BR9%20Mountain%20View%20CA%20USA
है).
--OR--
components
— एलिमेंट वाला कॉम्पोनेंट फ़िल्टर अलग करने के लिए पाइप (|
) का इस्तेमाल करें. कॉम्पोनेंट फ़िल्टर भी स्वीकार किए जाते हैं अगरaddress
दिया गया है, तो वैकल्पिक पैरामीटर के तौर पर. कॉम्पोनेंट फ़िल्टर के हर एलिमेंट मेंcomponent:value
पेयर करें और नतीजों को पूरी तरह से सीमित करें से लिया गया है. इसके बारे में ज़्यादा जानकारी देखें कॉम्पोनेंट को फ़िल्टर करने की सुविधा नीचे दी गई है.- ग्लोबल कोड, चार वर्णों का एरिया कोड और छह या उससे ज़्यादा वर्ण का कोड है
लोकल कोड (849VCWT8+R9,
key
— आपके ऐप्लिकेशन की API कुंजी. इस कुंजी से पता चलता है कि कोटा मैनेजमेंट के मकसद से आपका ऐप्लिकेशन. सीखें कि कैसे कुंजी पाएं.
कृपया हमारे अक्सर पूछे जाने वाले सवाल देखें अतिरिक्त दिशा-निर्देश.
जियोकोडिंग के अनुरोध में ऐसे पैरामीटर जो ज़रूरी नहीं हैं:
bounds
— व्यूपोर्ट का बाउंडिंग बॉक्स जिसमें जियोकोड के नतीजों को ज़्यादा प्रमुखता से शामिल किया जाए. यह पैरामीटर जियोकोडर से मिलने वाले नतीजों पर असर डालें, उन पर पूरी तरह से पाबंदी न लगाएं. (और ज़्यादा जानकारी नीचे व्यूपोर्ट मापदंड तय करना देखें.)language
— वह भाषा जिसमें नतीजे दिखाएं.- Google Ads में इस्तेमाल किए जा सकने वाले प्रॉडक्ट की सूची देखें भाषाएं में बदल दिया जाता है. 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 ने json
का अनुरोध किया है
"1600 Amphitheatre Parkway, Mountain View,
CA".
इस अनुरोध में 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 और एक्सएमएल के सैंपल देखने के लिए, नीचे दिए गए टैब चुनें.
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>
ध्यान दें कि एक्सएमएल रिस्पॉन्स में एक
<GeocodeResponse>
और दो टॉप लेवल एलिमेंट:
<status>
में, अनुरोध से जुड़ा मेटाडेटा मौजूद होता है. यहां जाएं: स्टेटस कोड नीचे दिए गए हैं.- शून्य या उससे ज़्यादा
<result>
एलिमेंट. हर एलिमेंट में एक शामिल है जियोकोड किए गए पते और ज्यामिति जानकारी का सेट.
एक्सएमएल का रिस्पॉन्स, JSON रिस्पॉन्स से काफ़ी लंबा होता है. इसके लिए
इस वजह से, हमारा सुझाव है कि आप json
को
आउटपुट फ़्लैग का इस्तेमाल करें, बशर्ते किसी वजह से आपकी सेवा को xml
की ज़रूरत न हो.
साथ ही, एक्सएमएल ट्री को प्रोसेस करने में थोड़ी सावधानी बरतनी पड़ती है, ताकि आप
सही नोड और एलिमेंट शामिल करें. यहां जाएं:
आउटपुट प्रोसेसिंग के लिए, सुझाए गए कुछ डिज़ाइन पैटर्न के लिए, एक्सएमएल को खाने के साथ-साथ को पार्स किया जा रहा है.
- एक्सएमएल के नतीजे, रूट
<GeocodeResponse>
एलिमेंट में रैप किए जाते हैं. - JSON, बहुवचन सरणियों (
types
) से एक से ज़्यादा एलिमेंट वाली एंट्री को दिखाता है, जबकि एक्सएमएल एक से ज़्यादा एकवचन एलिमेंट (<type>
) का इस्तेमाल करके इनके बारे में बताता है. - खाली एलिमेंट को JSON में, खाली अरे के ज़रिए दिखाया जाता है. हालांकि, उनमें कोई
एक्सएमएल में इस तरह के एलिमेंट की ज़रूरत होती है. अगर किसी जवाब से कोई नतीजा नहीं मिलता, तो वह खाली दिखेगी
JSON में
results
कलेक्शन, लेकिन एक्सएमएल में<result>
एलिमेंट नहीं है, उदाहरण के लिए.
स्थिति कोड
जियोकोडिंग रिस्पॉन्स ऑब्जेक्ट में मौजूद "status"
फ़ील्ड में स्टेटस होता है
और इसमें डीबग करने की जानकारी शामिल हो सकती है, ताकि आपको यह पता चल सके कि जियोकोडिंग की वजह क्या है
काम नहीं कर रहा है. "status"
फ़ील्ड में ये वैल्यू हो सकती हैं:
"OK"
से पता चलता है कि कोई गड़बड़ी नहीं हुई; पते को सफलतापूर्वक पार्स कर दिया गया था और कम से कम एक जियोकोड लौटाया गया."ZERO_RESULTS"
बताता है कि जियोकोड सफल रहा, लेकिन कोई नतीजा नहीं मिला. ऐसा तब हो सकता है, जब जियोकोडर को ऐसेaddress
से पास किया गया हो जो मौजूद नहीं है.OVER_DAILY_LIMIT
इनमें से किसी का भी संकेत देता है:- एपीआई पासकोड मौजूद नहीं है या गलत है.
- आपके खाते में बिलिंग की सुविधा चालू नहीं की गई है.
- खुद लागू किए गए इस्तेमाल की सीमा पार हो गई है.
- पैसे चुकाने का आपका दिया गया तरीका अब मान्य नहीं है (उदाहरण के लिए, क्रेडिट कार्ड की अवधि खत्म हो चुकी है).
और जानने के लिए मैप पर अक्सर पूछे जाने वाले सवाल देखें इसे कैसे ठीक करें.
"OVER_QUERY_LIMIT"
बताता है कि आपने स्टोरेज कोटा पार कर लिया है."REQUEST_DENIED"
बताता है कि आपका अनुरोध अस्वीकार कर दिया गया है.- आम तौर पर,
"INVALID_REQUEST"
से पता चलता है कि क्वेरी (address
,components
याlatlng
) मौजूद नहीं है. "UNKNOWN_ERROR"
से पता चलता है कि यह अनुरोध नहीं किया जा सका सर्वर की गड़बड़ी की वजह से प्रोसेस हुआ. अनुरोध पूरा हो सकता है, अगर आपने फिर से कोशिश करें.
गड़बड़ी के मैसेज
जब जियोकोडर OK
के अलावा कोई दूसरा स्टेटस कोड दिखाता है, तो
जियोकोडिंग रिस्पॉन्स ऑब्जेक्ट में error_message
फ़ील्ड. इस फ़ील्ड में ज़्यादा फ़ील्ड शामिल हैं
दिए गए स्टेटस कोड की वजहों के बारे में ज़्यादा जानकारी.
नतीजे
जब जियोकोडर नतीजे दिखाता है, तो यह उन्हें (JSON) results
में डाल देता है
कलेक्शन. अगर जियोकोडर कोई परिणाम नहीं दिखाता है (जैसे कि पता मौजूद नहीं है), तब भी ऐसा होता रहेगा
यह फ़ंक्शन खाली results
कलेक्शन दिखाता है. (एक्सएमएल के रिस्पॉन्स में शून्य या उससे ज़्यादा हैं
<result>
elements.)
किसी सामान्य नतीजे में ये फ़ील्ड शामिल होते हैं:
types[]
अरे, दिखाए गए प्रॉडक्ट का टाइप दिखाता है नतीजा. इस श्रेणी में शून्य या उससे ज़्यादा टैग का एक सेट है, जो सुविधा के नतीजे में मिले. उदाहरण के लिए, "शिकागो" का जियोकोड वापस करना "जगह" जिससे पता चलता है कि "शिकागो" एक शहर है, और इसकी वजह से "राजनैतिक" भी मिल रहा है जिससे पता चलता है कि यह एक राजनैतिक इकाई है. कॉम्पोनेंट में खाली टाइप हो सकते हैं अरे. ज़रूरत पड़ने पर एपीआई में, टाइप की नई वैल्यू जोड़ी जा सकती हैं. ज़्यादा जानकारी के लिए, पते के टाइप और पते के कॉम्पोनेंट देखें.formatted_address
ऐसी स्ट्रिंग है जिसमें मौजूद कॉन्टेंट को कोई भी व्यक्ति आसानी से पढ़ सकता है इस जगह का पता.अक्सर यह पता, डाक पते के बराबर होता है. ध्यान दें कि कुछ यूनाइटेड किंगडम जैसे देशों में, किसी भी समयावधि में डाक पते न भेजें.
फ़ॉर्मैट किया गया पता, लॉजिकल तरीके से एक या एक से ज़्यादा पते वाले फ़ॉर्मैट में लिखा जाता है कॉम्पोनेंट के तौर पर दिखता है. उदाहरण के लिए, पता "111 8th Avenue, New York, NY" इसमें ये कॉम्पोनेंट शामिल होते हैं: "111" (सड़क का नंबर), "एट्थ ऐवेन्यू" (रूट), "न्यूयॉर्क" (शहर) और "NY" (अमेरिका का राज्य).
फ़ॉर्मैट किए गए पते को प्रोग्राम के हिसाब से पार्स न करें. इसके बजाय, आपको पते के अलग-अलग कॉम्पोनेंट, जिन्हें एपीआई के जवाब में शामिल किया जाता है लिंक किया गया है.
address_components[]
एक कलेक्शन है, जिसमें इस पते पर लागू होने वाले कॉम्पोनेंट.पते के हर कॉम्पोनेंट में आम तौर पर ये फ़ील्ड शामिल होते हैं:
types[]
एक कलेक्शन है, जो वैल्यू के type को दिखाता है पता कॉम्पोनेंट. इसकी सूची देखें अलग-अलग तरह के फ़ॉर्मैट में काम करता है.long_name
पता कॉम्पोनेंट, जो जियोकोडर के वापस भेजा गया हो.short_name
, पते का छोटा टेक्स्ट नाम है कॉम्पोनेंट, अगर उपलब्ध हो. उदाहरण के लिए, राज्य के लिए पते का कॉम्पोनेंट अलास्का के लिए, "अलास्का" काlong_name
हो सकता है और एक "AK" में सेshort_name
का उपयोग करें.
address_components[]
के बारे में इन बातों का ध्यान रखें कलेक्शन:- पते के कॉम्पोनेंट के कलेक्शन में,
formatted_address
. - यह ज़रूरी नहीं है कि कलेक्शन में वे सभी राजनैतिक इकाइयां शामिल हों जो
में शामिल पता छोड़कर, उसका कोई पता नहीं होता
formatted_address
. सभी राजनैतिक इकाइयों को फिर से पाने के लिए का उपयोग करें, जिसमें एक विशिष्ट पता शामिल है, तो आपको रिवर्स जियोकोडिंग का उपयोग करना चाहिए अनुरोध के पैरामीटर के तौर पर पते का अक्षांश/देशांतर. - इस बात की कोई गारंटी नहीं है कि इन दोनों के बीच रिस्पॉन्स का फ़ॉर्मैट समान रहेगा
अनुरोध. खास तौर पर,
address_components
की संख्या यह अनुरोध किए गए पते के आधार पर अलग-अलग होती है और समय के साथ एक ही पता. कोई कॉम्पोनेंट, अरे में जगह बदल सकता है. कॉम्पोनेंट का टाइप बदल सकता है. कोई खास कॉम्पोनेंट हम बाद के जवाब में गायब हो गए हैं.
कॉम्पोनेंट के कलेक्शन को मैनेज करने के लिए, आपको रिस्पॉन्स को पार्स करना होगा और एक्सप्रेशन के ज़रिए सही वैल्यू चुनें. इसके लिए गाइड देखें जवाब पार्स करना.
postcode_localities[]
एक कलेक्शन है, जो 100 इलाकों को दिखाता है पिन कोड के हिसाब से. यह सिर्फ़ तब मौजूद होता है, जब नतीजा पोस्टल हो जिसमें कई स्थान शामिल हों.geometry
में यह जानकारी शामिल है:location
में जियोकोड किए गए अक्षांश, देशांतर मान शामिल हैं. सामान्य के लिए तो यह फ़ील्ड आमतौर पर सबसे महत्वपूर्ण होता है.location_type
, बताई गई जगह के बारे में अतिरिक्त डेटा सेव करता है. कॉन्टेंट बनाने फ़िलहाल, ये वैल्यू इस्तेमाल की जा सकती हैं:"ROOFTOP"
से पता चलता है कि दिखाया गया नतीजा, इसके लिए सटीक जियोकोड है हमारे पास मोहल्ले के पते की सटीक जानकारी होती है."RANGE_INTERPOLATED"
संकेत देता है कि लौटाए गए नतीजे में सन्निकटन (आम तौर पर सड़क पर) को दो सटीक पॉइंट (जैसे कि चौराहों) के बीच इंटरपोलेट करके दिखाया जाता है. इंटरपोलेट किए गए नतीजे आम तौर पर तब दिखाए जाते हैं, जब किसी सड़क के लिए छत पर जियोकोड उपलब्ध नहीं होते इससे पहले ही अपने कारोबार के हिसाब से name@yourcompany.com जैसा कोई ईमेल पता बनाएं."GEOMETRIC_CENTER"
से पता चलता है कि वापस मिला नतीजा, इसका ज्यामितीय केंद्र है कोई नतीजा, जैसे कि पॉलीलाइन (उदाहरण के लिए, कोई सड़क) या पॉलीगॉन (क्षेत्र)."APPROXIMATE"
से पता चलता है कि दिया गया परिणाम अनुमानित है.
viewport
में, डिसप्ले करने के लिए सुझाया गया व्यूपोर्ट शामिल है वापस लौटाया गया नतीजा, जिसे दो अक्षांश,देशांतर की वैल्यू के तौर पर दिखाया गया हैsouthwest
और व्यूपोर्ट बाउंडिंग बॉक्स काnortheast
कोना. आम तौर पर व्यूपोर्ट का इस्तेमाल करके, उपयोगकर्ता को नतीजा दिखाते समय उसे फ़्रेम किया जाता है.bounds
(वैकल्पिक रूप से लौटाया गया) बाउंडिंग बॉक्स को सेव करता है जिसमें, लौटाए गए नतीजे को पूरी तरह शामिल किया जा सकता है. ध्यान दें कि ये सीमाएं सुझाया गया व्यूपोर्ट. (उदाहरण के लिए, सैन फ़्रांसिस्को में फ़ारालन द्वीप समूह, जो तकनीकी रूप से शहर का हिस्सा हैं, लेकिन हो सकता है कि इन्हें व्यूपोर्ट में लौटाया नहीं जाना चाहिए.)
-
plus_code
(देखें लोकेशन कोड खोलें और प्लस कोड) एक एनकोडेड है जगह का रेफ़रंस होता है, जो अक्षांश और देशांतर निर्देशांक से लिया जाता है, क्षेत्र का प्रतिनिधित्व करता है: डिग्री के 1/8000वें हिस्से के लिए डिग्री के 1/8000वें हिस्से के लिए डिग्री (करीब 14 मीटर x) भूमध्य रेखा पर 14 मीटर) या इससे कम. प्लस कोड का इस्तेमाल इनकी जगह पर किया जा सकता है उन जगहों के पते जहां पते नहीं दिए गए हैं (जहां इमारत मौजूद नहीं है) या सड़कों के नाम नहीं दिए गए हैं). यह एपीआई हमेशा प्लस कोड नहीं दिखाता.जब यह सेवा प्लस कोड दिखाती है, तो इसे ग्लोबल कोड और कंपाउंड कोड के तौर पर फ़ॉर्मैट किया जाता है:
global_code
, चार वर्णों का एरिया कोड और छह या इससे लंबा लोकल कोड है (849VCWT8+R9).compound_code
, छह या इससे ज़्यादा वर्णों का लोकल कोड है. इसमें जगह की जानकारी साफ़ तौर पर दी गई है (CW8+R9, माउंटेन व्यू, कैलिफ़ोर्निया, अमेरिका). इस कॉन्टेंट को प्रोग्राम के हिसाब से पार्स न करें.
-
partial_match
बताता है कि जियोकोडर वापस नहीं आया मूल अनुरोध के लिए एग्ज़ैक्ट मैच है. हालांकि, यह किया गया है. हो सकता है कि आप गलत स्पेलिंग के लिए मूल अनुरोध और/या अधूरा पता.आंशिक मिलान अक्सर उन सड़क के पतों के लिए होते हैं जो मौजूद नहीं हैं उस मोहल्ला के भीतर जहां आपने अनुरोध किया है. 'कुछ हद तक मैच' वाले कीवर्ड भी हो सकते हैं जब कोई अनुरोध एक ही इलाके में दो या दो से ज़्यादा जगहों से मेल खाता है, तब दिखाया जाता है. उदाहरण के लिए, "Hillpar St, Bristol, UK" दोनों के लिए आंशिक मिलान देगा हेनरी स्ट्रीट और हेनरीएटा स्ट्रीट. ध्यान दें कि अगर किसी अनुरोध में गलत स्पेलिंग वाला पता कॉम्पोनेंट, जियोकोडिंग सेवा किसी अन्य विकल्प का सुझाव दे सकती है इससे पहले ही अपने कारोबार के हिसाब से name@yourcompany.com जैसा कोई ईमेल पता बनाएं. इस तरह ट्रिगर किए गए सुझावों को भी आंशिक तौर पर मार्क किया जाएगा मिलान.
place_id
यूनीक है ऐसा आइडेंटिफ़ायर जिसका इस्तेमाल दूसरे Google API के साथ किया जा सकता है. उदाहरण के लिए, आपके पासplace_id
का इस्तेमाल पाने के लिए Places API अनुरोध किसी स्थानीय कारोबार की जानकारी, जैसे कि फ़ोन नंबर, कारोबार के खुले होने का समय, समीक्षाएं वगैरह. स्थान आईडी देखें खास जानकारी पर टैप करें.
पते के टाइप और पते के कॉम्पोनेंट
नतीजे में मौजूद types[]
अरे यह जानकारी देता है
पते का टाइप. पते के टाइप के उदाहरणों में मोहल्ले का पता,
देश या कोई राजनैतिक इकाई है. इसमें types[]
कलेक्शन भी मौजूद है
address_components[]
, जो इसके हर हिस्से के टाइप को दिखाता है
इससे पहले ही अपने कारोबार के हिसाब से name@yourcompany.com जैसा कोई ईमेल पता बनाएं. उदाहरण के लिए, सड़क का नंबर या देश. (यहां इन रणनीतियों की पूरी सूची दी गई है
types.) पते एक से ज़्यादा तरह के हो सकते हैं. इन टाइप को 'टैग' माना जा सकता है.
उदाहरण के लिए, कई शहर political
और
locality
टाइप.
नीचे दिए गए टाइप, जियोकोडर के ज़रिए दोनों भाषाओं में काम करते हैं पते का टाइप और पते के कॉम्पोनेंट के कलेक्शन:
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
, नाम वाले पसंदीदा विषय को दिखाता है. आम तौर पर, ये "लोकप्रिय जगह" ऐसी प्रमुख स्थानीय इकाइयां होती हैं जो किसी भी जगह पर आसानी से फ़िट नहीं होती हैं किसी अन्य कैटगरी में डालें, जैसे कि "एंपायर स्टेट बिल्डिंग" या "कुतुब मीनार" के रूप में जाना जाता है.
टाइप की खाली सूची से पता चलता है कि पता कॉम्पोनेंट, उदाहरण के लिए, फ़्रांस का ल्यू-डिट.
ऊपर दी गई जानकारी के अलावा, पते के कॉम्पोनेंट में यहां बताए गए टाइप शामिल हो सकते हैं. इस सूची में इसमें पूरी जानकारी नहीं है और इसमें बदलाव किया जा सकता है.
floor
इमारत के पते की मंज़िल दिखाता है.establishment
आम तौर पर ऐसी जगह के बारे में बताता है जिसने अभी तक को वर्गीकृत किया गया है.landmark
आस-पास की ऐसी जगह के बारे में बताता है जिसे रेफ़रंस के तौर पर इस्तेमाल किया जाता है. इस्तेमाल करने में मदद मिलेगी.point_of_interest
, नाम वाले पसंदीदा विषय को दिखाता है.parking
पार्किंग की जगह या पार्किंग की जगह के बारे में बताता है.post_box
एक खास डाक बॉक्स के बारे में बताता है.postal_town
भौगोलिक क्षेत्रों के समूह को दिखाता है, जैसेlocality
औरsublocality
का इस्तेमाल डाक पतों के लिए किया जाता है कुछ देशों में.room
किसी इमारत के पते के कमरे के बारे में बताता है.street_number
सटीक सड़क संख्या दिखाता है.bus_station
,train_station
, औरtransit_station
किसी बस, ट्रेन या सार्वजनिक पते की जानकारी देता है बस, मेट्रो वगैरह के स्टॉप.
व्यूपोर्ट बायसिंग
जियोकोडिंग अनुरोध में, आप जियोकोडिंग सेवा को नीचे
नतीजे किसी व्यूपोर्ट पर मौजूद होते हैं. इसे बाउंडिंग बॉक्स के तौर पर दिखाया जाता है. आपने कर लिया
bounds
पैरामीटर सेट करके अनुरोध यूआरएल में शामिल करें.
bounds
पैरामीटर, अक्षांश/देशांतर निर्देशांक के बारे में बताता है
बाउंडिंग बॉक्स के दक्षिण-पश्चिम और उत्तर-पूर्वी कोनों के लिए, जो एक पाइप का इस्तेमाल करता हो
निर्देशांकों को अलग करने के लिए (|
) वर्ण.
उदाहरण के लिए, "Washington" के लिए जियोकोड आम तौर पर अमेरिका के वॉशिंगटन:
अनुरोध:
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"
}
क्षेत्र के आधार पर भेदभाव करना
जियोकोडिंग अनुरोध में, आप जियोकोडिंग सेवा को वापस जाने का निर्देश दे सकते हैं
region
का इस्तेमाल करने से किसी खास क्षेत्र के लिए नतीजे मिलते हैं
पैरामीटर. इस पैरामीटर को एक ccTLD (देश कोड टॉप-लेवल) का इस्तेमाल करना होता है
डोमेन) तर्क का इस्तेमाल करें. ज़्यादातर ccTLD कोड इसके समान हैं
कुछ खास अपवादों के साथ, ISO 3166-1 कोड. उदाहरण के लिए, युनाइटेड
किंगडम का ccTLD "uk" है (.co.uk
) है, जबकि इसका ISO 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 पता दिखा सकता है
किसी विशिष्ट क्षेत्र तक सीमित परिणाम. पाबंदी की जानकारी देने के लिए इसका इस्तेमाल किया जा सकता है
components
फ़िल्टर. फ़िल्टर में
component:value
जोड़े को पाइप (|
) से अलग किया गया.
फ़िल्टर वैल्यू, स्पेलिंग में सुधार करने और कुछ हद तक एक जैसे तरीकों का इस्तेमाल करती हैं
का इस्तेमाल अन्य जियोकोडिंग अनुरोधों के रूप में कर रहे हैं. अगर जियोकोडर को किसी
कॉम्पोनेंट फ़िल्टर है, तो रिस्पॉन्स में partial_match
फ़ील्ड शामिल होगा.
फ़िल्टर किए जा सकने वाले components
में ये शामिल हैं:
postal_code
,postal_code
से मेल खाता है औरpostal_code_prefix
.country
देश के नाम या दो अक्षर से मेल खाता है आईएसओ 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
के साथ
कैनरी द्वीप समूह, स्पेन में सांता क्रूज़ डे टेनेरीफ़ की वापसी है.
अनुरोध:
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"
}