इस पेज का अनुवाद Cloud Translation API से किया गया है.

जियोकोडिंग का अनुरोध और जवाब

अनुरोध

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 जोड़ा होता है और यह जियोकोडर से मिलने वाले नतीजों पर पूरी तरह से पाबंदी लगाता है. नीचे कॉम्पोनेंट को फ़िल्टर करने के बारे में ज़्यादा जानकारी देखें.
key — आपके ऐप्लिकेशन की API कुंजी. यह कुंजी, कोटा प्रबंधन के लिए आपके ऐप्लिकेशन की पहचान करती है. कुंजी पाने का तरीका जानें.

ज़्यादा जानकारी के लिए, कृपया अक्सर पूछे जाने वाले सवाल देखें.

जियोकोडिंग के अनुरोध में ऐसे पैरामीटर जो ज़रूरी नहीं हैं:

bounds — व्यूपोर्ट का बाउंडिंग बॉक्स, जिसमें जियोकोड के नतीजों को ज़्यादा प्रमुखता से दिखाया जा सके. इस पैरामीटर से सिर्फ़ जियोकोडर के नतीजों पर असर पड़ेगा, उन पर पूरी तरह से पाबंदी नहीं लगेगी. (ज़्यादा जानकारी के लिए, नीचे व्यूपोर्ट मापदंड देखें.)
language — वह भाषा जिसमें नतीजे देने हैं.
- इस्तेमाल की जा सकने वाली भाषाओं की सूची देखें. Google अक्सर इस्तेमाल की जाने वाली भाषाओं को अपडेट करता रहता है. इसलिए, हो सकता है कि यह सूची पूरी न हो.
- अगर language नहीं दिया गया है, तो जियोकोडर, Accept-Language हेडर में बताई गई पसंदीदा भाषा या उस डोमेन की मूल भाषा का इस्तेमाल करने की कोशिश करता है जिससे अनुरोध भेजा गया है.
- जियोकोडर, मोहल्ले का ऐसा पता देने की पूरी कोशिश करता है जिसे उपयोगकर्ता और स्थानीय लोग आसानी से पढ़ सकें. इस लक्ष्य को पूरा करने के लिए, यह स्थानीय भाषा में मोहल्लों के पते दिखाता है. साथ ही, ज़रूरत पड़ने पर उपयोगकर्ता की पढ़ने लायक स्क्रिप्ट में ट्रांसलिट्रेट किया जाता है. साथ ही, पसंदीदा भाषा को भी ध्यान में रखता है. इसके अलावा, बाकी सभी पते अपनी पसंदीदा भाषा में दिखाए जाते हैं. पते के सभी कॉम्पोनेंट उसी भाषा में दिखाए जाते हैं जिसे पहले कॉम्पोनेंट से चुना जाता है.
- अगर पसंदीदा भाषा में कोई नाम उपलब्ध नहीं है, तो जियोकोडर सबसे मिलते-जुलते नाम का इस्तेमाल करता है.
- पसंदीदा भाषा का थोड़ा असर, नतीजों के उस सेट पर होता है जिसे एपीआई चुनता है. साथ ही, यह भी कि वे किस क्रम में दिखती हैं. जियोकोडर, भाषा के हिसाब से शब्दों के छोटे रूप को अलग-अलग तरीके से समझता है. जैसे, सड़कों के लिए छोटे रूप या समानार्थी शब्द, जो हो सकता है कि एक भाषा में मान्य हों, लेकिन दूसरी भाषा में नहीं. उदाहरण के लिए, हंगेरियन में utca और tér, सड़क और वर्ग के समानार्थी शब्द हैं.
region — क्षेत्र का कोड, जिसे ccTLD ("टॉप लेवल डोमेन") दो वर्णों की वैल्यू के तौर पर बताया गया है. यह पैरामीटर सिर्फ़ जियोकोडर से मिलने वाले नतीजों पर असर डालेगा, उस पर पूरी तरह से पाबंदी नहीं लगाएगा. ज़्यादा जानकारी के लिए, नीचे क्षेत्र के हिसाब से तय करना देखें.) पैरामीटर, लागू कानून के आधार पर भी नतीजों पर असर डाल सकता है.
components — एक कॉम्पोनेंट फ़िल्टर, जिसमें पाइप (|) से अलग किए गए एलिमेंट शामिल हैं. अगर अनुरोध में address शामिल नहीं है, तो कॉम्पोनेंट फ़िल्टर ज़रूरी है. कॉम्पोनेंट फ़िल्टर के हर एलिमेंट में एक component:value जोड़ा होता है और यह जियोकोडर से मिलने वाले नतीजों पर पूरी तरह से पाबंदी लगाता है. नीचे कॉम्पोनेंट को फ़िल्टर करने के बारे में ज़्यादा जानकारी देखें.
extra_computations — इस पैरामीटर के लिए सिर्फ़ ADDRESS_DESCRIPTORS वैल्यू की अनुमति है. ज़्यादा जानकारी के लिए पते के डिस्क्रिप्टर देखें.

जवाब

जियोकोडिंग के जवाब, यूआरएल के अनुरोध में मौजूद 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&amp;key=YOUR_API_KEY

इस अनुरोध में एक्सएमएल output फ़्लैग का इस्तेमाल करने के बारे में बताया गया है:

https://maps.googleapis.com/maps/api/geocode/xml?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA&amp;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 की ज़रूरत न हो. इसके अलावा, एक्सएमएल ट्री को प्रोसेस करने के लिए खास तौर पर ध्यान देने की ज़रूरत होती है, ताकि आप सही नोड और एलिमेंट का रेफ़रंस दे सकें. आउटपुट प्रोसेसिंग के लिए, कुछ सुझाए गए डिज़ाइन पैटर्न के लिए, XX के साथ एक्सएमएल को पार्स करना लेख पढ़ें.

एक्सएमएल के नतीजे, रूट <GeocodeResponse> एलिमेंट में रैप किए जाते हैं.
JSON, एक से ज़्यादा एलिमेंट वाली एंट्री को बहुवचन सरणियों (types) से दिखाता है. वहीं, एक्सएमएल में इन्हें एकवचन वाले एलिमेंट (<type>) का इस्तेमाल करके दिखाया जाता है.
खाली एलिमेंट को JSON में, खाली अरे के ज़रिए दिखाया जाता है. हालांकि, एक्सएमएल में ऐसा कोई भी एलिमेंट मौजूद न होने से दिखाया जाता है. ऐसा रिस्पॉन्स जो कोई नतीजा नहीं जनरेट करता, वह JSON में खाली results कलेक्शन दिखाएगा. हालांकि, एक्सएमएल में <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 कलेक्शन दिखाता है. (एक्सएमएल के रिस्पॉन्स में शून्य या उससे ज़्यादा <result> एलिमेंट हैं.)

किसी सामान्य नतीजे में ये फ़ील्ड शामिल होते हैं:

types[] कलेक्शन, लौटाए गए नतीजे का टाइप दिखाता है. इस अरे में, शून्य या उससे ज़्यादा टैग का एक सेट होता है. इससे यह पता चलता है कि नतीजे में किस तरह की सुविधा मिलेगी. उदाहरण के लिए, "शिकागो" के जियोकोड के तौर पर "जगह" दिखता है. इससे पता चलता है कि "शिकागो" एक शहर है और "राजनैतिक" भी दिखाता है. इससे पता चलता है कि यह एक राजनैतिक इकाई है. अगर पते के कॉम्पोनेंट के टाइप की जानकारी नहीं है, तो कॉम्पोनेंट में खाली टाइप का कलेक्शन हो सकता है. ज़रूरत पड़ने पर एपीआई में, टाइप की नई वैल्यू जोड़ी जा सकती हैं. ज़्यादा जानकारी के लिए, पते के टाइप और पते के कॉम्पोनेंट देखें.
formatted_address एक ऐसी स्ट्रिंग है जिसमें इस जगह का ऐसा पता होता है जिसे कोई भी व्यक्ति आसानी से पढ़ सकता है.
अक्सर यह पता, डाक पते के बराबर होता है. ध्यान दें कि यूनाइटेड किंगडम जैसे कुछ देश, लाइसेंस देने से जुड़ी पाबंदियों की वजह से, सही डाक पते बांटने की अनुमति नहीं देते.

फ़ॉर्मैट किया गया पता, लॉजिकल तरीके से एक या उससे ज़्यादा पते कॉम्पोनेंट से मिलकर बनता है. उदाहरण के लिए, "111 8th Avenue, New York, NY" पते में ये कॉम्पोनेंट शामिल होते हैं: "111" (सड़क का नंबर), "8th Avenue" (रूट), "न्यूयॉर्क" (शहर) और "NY" (अमेरिका का राज्य).

फ़ॉर्मैट किए गए पते को प्रोग्राम के हिसाब से पार्स न करें. इसके बजाय, आपको पते के अलग-अलग कॉम्पोनेंट का इस्तेमाल करना चाहिए, जिसे फ़ॉर्मैट किए गए पते के फ़ील्ड के साथ-साथ, एपीआई के रिस्पॉन्स में शामिल किया जाता है.
address_components[] एक कलेक्शन है, जिसमें इस पते पर लागू होने वाले अलग-अलग कॉम्पोनेंट शामिल होते हैं.
पते के हर कॉम्पोनेंट में आम तौर पर ये फ़ील्ड शामिल होते हैं:
- types[] एक कलेक्शन है, जो पता कॉम्पोनेंट का टाइप बताता है. इस्तेमाल किए जा सकने वाले टाइप की सूची देखें.
- 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" बताता है कि दिखाया गया नतीजा, दो सटीक पॉइंट (जैसे कि चौराहों) के बीच इंटरपोलेट किया गया अनुमान (आम तौर पर सड़क पर) दिखाता है. इंटरपोलेट किए गए नतीजे आम तौर पर तब दिखाए जाते हैं, जब किसी सड़क के पते के लिए छत पर जियोकोड उपलब्ध नहीं होते.
  - "GEOMETRIC_CENTER" से पता चलता है कि मिला नतीजा, किसी नतीजे का ज्यामितीय केंद्र है, जैसे कि पॉलीलाइन (उदाहरण के लिए, कोई सड़क) या पॉलीगॉन (क्षेत्र).
  - "APPROXIMATE" बताता है कि मिला नतीजा अनुमानित है.
- viewport में, दिए गए नतीजे को दिखाने के लिए सुझाया गया व्यूपोर्ट शामिल है. इसे दो अक्षांश, देशांतर वैल्यू के तौर पर दिखाया गया है, जो व्यूपोर्ट के बाउंडिंग बॉक्स के southwest और northeast कोने को तय करते हैं. आम तौर पर, व्यूपोर्ट का इस्तेमाल उपयोगकर्ता को नतीजे दिखाते समय उसे फ़्रेम करने के लिए किया जाता है.
- bounds (वैकल्पिक रूप से लौटाया गया) बाउंडिंग बॉक्स को सेव करता है, जिसमें मिलने वाले नतीजे को पूरी तरह शामिल किया जा सकता है. ध्यान दें कि ऐसा हो सकता है कि ये सीमाएं, सुझाए गए व्यूपोर्ट से मेल न खाएं. (उदाहरण के लिए, सैन फ़्रांसिस्को में फ़ारालन द्वीप शामिल हैं, जो तकनीकी रूप से शहर का हिस्सा हैं, लेकिन हो सकता है कि उन्हें व्यूपोर्ट में दिखाया न जाए.)
plus_code (खुली जगह का कोड और प्लस कोड देखें) एक कोड में बदली गई जगह का संदर्भ है, जो अक्षांश और देशांतर निर्देशांक से लिया जाता है. यह क्षेत्र को 1/8,000 डिग्री के 1/8,000 डिग्री (भूमध्य रेखा पर करीब 14 मीटर x 14 मीटर) या इससे छोटा दिखाता है. प्लस कोड का इस्तेमाल उन जगहों पर सड़क के पतों की जगह पर किया जा सकता है जहां पते नहीं हैं (जहां इमारतों को नंबर नहीं दिया गया है या सड़कों के नाम नहीं दिए गए हैं). यह एपीआई हमेशा प्लस कोड नहीं दिखाता.
जब यह सेवा प्लस कोड दिखाती है, तो इसे ग्लोबल कोड और कंपाउंड कोड के तौर पर फ़ॉर्मैट किया जाता है:
- global_code, चार वर्णों का एरिया कोड और छह या इससे ज़्यादा वर्णों का लोकल कोड है (849VCWM8+R9).
- compound_code, छह या इससे ज़्यादा वर्णों का लोकल कोड है. इसमें जगह की साफ़ तौर पर जानकारी दी जाती है (CWT8+R9, Mountain View, CA, USA). इस कॉन्टेंट को प्रोग्राम के हिसाब से पार्स न करें.
उपलब्ध होने पर, यह एपीआई ग्लोबल कोड और कंपाउंड कोड, दोनों दिखाता है. हालांकि, अगर नतीजा किसी दूसरी जगह (उदाहरण के लिए, महासागर या रेगिस्तान) पर है, तो सिर्फ़ ग्लोबल कोड दिखाया जा सकता है.
partial_match से पता चलता है कि जियोकोडर ने मूल अनुरोध के लिए एग्ज़ैक्ट मैच नहीं दिया. हालांकि, वह अनुरोध किए गए पते के हिस्से से मैच कर सकता था. हो सकता है कि आप गलत स्पेलिंग और/या अधूरे पते के लिए मूल अनुरोध की जांच करना चाहें.

आंशिक मिलान अक्सर उन सड़क के पतों के लिए होते हैं जो आपके अनुरोध में पास किए गए मोहल्ले के भीतर मौजूद नहीं होते हैं. जब कोई अनुरोध एक ही इलाके की दो या उससे ज़्यादा जगहों से मैच करता है, तब भी कुछ हिस्से मैच हो सकते हैं. उदाहरण के लिए, "Hillpar St, Bristol, UK" हेनरी स्ट्रीट और हेनरीएटा स्ट्रीट, दोनों के लिए आंशिक मैच नतीजे देगा. ध्यान दें कि अगर किसी अनुरोध में गलत स्पेलिंग वाले पते का कॉम्पोनेंट शामिल है, तो जियोकोडिंग सेवा किसी दूसरे पते का सुझाव दे सकती है. इस तरह ट्रिगर किए गए सुझावों को भी 'कुछ हद तक मिलते-जुलते' के तौर पर मार्क किया जाएगा.
place_id एक यूनीक आइडेंटिफ़ायर है, जिसे अन्य Google API के साथ इस्तेमाल किया जा सकता है. उदाहरण के लिए, किसी स्थानीय कारोबार की जानकारी पाने के लिए, Location API अनुरोध में place_id का इस्तेमाल किया जा सकता है. जैसे कि फ़ोन नंबर, कारोबार के खुले होने का समय, उपयोगकर्ताओं की समीक्षाएं वगैरह. जगह के आईडी की खास जानकारी देखें.

पते के टाइप और पते के कॉम्पोनेंट

नतीजे में दिखाया गया types[] कलेक्शन, पते का टाइप दिखाता है. पते के टाइप के उदाहरणों में मोहल्ले का पता, देश या कोई राजनैतिक इकाई शामिल है. address_components[] में 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_1 से sublocality_level_5 तक. हर मोहल्ले का स्तर एक नागरिक इकाई होता है. ज़्यादा बड़ी संख्या से पता चलता है कि भौगोलिक क्षेत्र छोटा है.
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 किसी बस, ट्रेन या सार्वजनिक परिवहन के स्टॉप की जगह बताते हैं.

ध्यान दें: यह ज़रूरी नहीं है कि Geocoding API में मौजूद हमारे डेटा सेट में मौजूद किसी पते के लिए, कोई खास कॉम्पोनेंट दिखाया जाए. ब्रुकलिन जैसे किसी शहर को शहर के तौर पर नहीं, बल्कि एक अन्य कॉम्पोनेंट की तरह दिखाया जा सकता है. इस मामले में, sublocality_level_1 को यह देखा जा सकता है कि कौनसे कॉम्पोनेंट लौटाए जाते हैं, उनमें बिना किसी सूचना के बदलाव किया जा सकता है. अगर आपको रिस्पॉन्स से पते के कॉम्पोनेंट एक्सट्रैक्ट करने हैं, तो अपने कोड को इस तरह से डिज़ाइन करें कि वह सुविधाजनक हो.

व्यूपोर्ट बायसिंग

जियोकोडिंग अनुरोध में, आप जियोकोडिंग सेवा को किसी दिए गए व्यूपोर्ट (जिसे बाउंडिंग बॉक्स के रूप में दिखाया जाता है) में ही नतीजे प्राथमिकता देने का निर्देश दे सकते हैं. इसके लिए, अनुरोध यूआरएल में 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"
}

क्षेत्र के आधार पर भेदभाव करना

जियोकोडिंग अनुरोध में, आप region पैरामीटर का इस्तेमाल करके जियोकोडिंग सेवा को किसी खास क्षेत्र के आधार पर नतीजे दिखाने का निर्देश दे सकते हैं. इस पैरामीटर में ccTLD (देश कोड का टॉप लेवल डोमेन) आर्ग्युमेंट इस्तेमाल किया जाता है, जिसमें क्षेत्र के आधार पर होने वाले भेदभाव के बारे में बताया जाता है. ज़्यादातर ccTLD कोड, ISO 3166-1 कोड के जैसे होते हैं. हालांकि, कुछ खास अपवाद भी हैं. उदाहरण के लिए, यूनाइटेड किंगडम का ccTLD "uk" (.co.uk) है, जबकि ISO 3166-1 कोड "gb" है. तकनीकी रूप से, यूनाइटेड किंगडम ऑफ़ ग्रेट ब्रिटेन और नॉर्दन आयरलैंड की इकाई के लिए इसका इस्तेमाल किया जा सकता है.

जियोकोडिंग के नतीजे हर उस डोमेन के लिए भेदभाव के हो सकते हैं जिसमें मुख्य Google Maps ऐप्लिकेशन को आधिकारिक तौर पर लॉन्च किया गया है. ध्यान दें कि मापदंड तय करने का विकल्प सिर्फ़ किसी खास डोमेन के नतीजों को प्राथमिकता देता है. अगर इस डोमेन के बाहर ज़्यादा काम के नतीजे मौजूद हैं, तो उन्हें शामिल किया जा सकता है.

उदाहरण के लिए, "Toledo" के लिए जियोकोड यह नतीजा दिखाता है, क्योंकि 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&region=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 के जवाब में, Geocoding API किसी खास इलाके के लिए सीमित पते के नतीजे दिखा सकता है. components फ़िल्टर का इस्तेमाल करके, कॉन्टेंट पर पाबंदी लगाई जा सकती है. फ़िल्टर में component:value जोड़े की सूची होती है, जो पाइप (|) से अलग की गई होती है. फ़िल्टर की वैल्यू में, स्पेलिंग में सुधार करने और कुछ हद तक मैच करने वाले वही तरीके इस्तेमाल किए जा सकते हैं जो जियोकोडिंग के अन्य अनुरोधों पर करते हैं. अगर जियोकोडर को किसी कॉम्पोनेंट फ़िल्टर के लिए पार्शियल फ़िल्टर मिलता है, तो रिस्पॉन्स में partial_match फ़ील्ड शामिल होगा.

फ़िल्टर किए जा सकने वाले components में ये शामिल हैं:

postal_code, postal_code और postal_code_prefix से मेल खाता है.
country, देश के नाम या दो अक्षरों वाले ISO 3166-1 देश कोड से मेल खाता है. एपीआई, देशों की पहचान करने के लिए आईएसओ मानक का पालन करता है. फ़िल्टर उस देश के आईएसओ कोड का इस्तेमाल करते समय सबसे अच्छी तरह काम करता है.
ध्यान दें: अगर आपको देश के कोड के साथ ऐसे नतीजे मिलते हैं जिनकी उम्मीद नहीं थी, तो पुष्टि करें कि आपने कोड का इस्तेमाल किया है. इसमें देश, आश्रित देश/इलाके, और आपकी पसंद के खास भौगोलिक क्षेत्र शामिल हैं. कोड की जानकारी पाने के लिए, Wikipedia: ISO 3166 देश के कोड की सूची या आईएसओ ऑनलाइन ब्राउज़िंग प्लैटफ़ॉर्म पर जाएं.

नतीजों पर असर डालने के लिए, यहां दिए गए 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"
}