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

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

अनुरोध

जियोकोडिंग एपीआई के अनुरोध का फ़ॉर्म यहां दिया गया है:

https://maps.googleapis.com/maps/api/geocode/outputFormat?parameters

जहां outputFormat में इनमें से कोई एक वैल्यू हो सकती है:

json (सुझाया गया) JavaScript ऑब्जेक्ट नोटेशन (JSON) में आउटपुट दिखाता है; या
xml, एक्सएमएल में आउटपुट दिखाता है

एपीआई कुंजी का इस्तेमाल करने वाले अनुरोधों के लिए, एचटीटीपीएस ज़रूरी है.

कुछ पैरामीटर ज़रूरी होते हैं, जबकि कुछ ज़रूरी नहीं होते हैं. पैरामीटर की तरह, पैरामीटर को एंपरसैंड (&) वर्ण का इस्तेमाल करके अलग किया जाता है.

इस पेज के बाकी हिस्से में, जियोकोडिंग और रिवर्स जियोकोडिंग के बारे में जानकारी दी गई है. ऐसा इसलिए है, क्योंकि हर तरह के अनुरोध के लिए अलग-अलग पैरामीटर उपलब्ध हैं.

जियोकोडिंग (अक्षांश/देशांतर लुकअप) पैरामीटर

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

address — मोहल्ले का पता या प्लस कोड जिसे आप भौगोलिक जगह पर दिखाना चाहते हैं. पते को उस देश के हिसाब से तय करें जिसका इस्तेमाल, उस देश की राष्ट्रीय डाक सेवा करती है. पते के अतिरिक्त एलिमेंट, जैसे कि कारोबार का नाम, यूनिट, सुइट या फ़्लोर नंबर का इस्तेमाल करने से बचें. मोहल्ले के पते के एलिमेंट, स्पेस के हिसाब से अलग-अलग होने चाहिए (यहां %20 के तौर पर, यूआरएल एस्केप करने के तौर पर दिखाया गया है):
```
address=24%20Sussex%20Drive%20Ottawa%20ON
```
यहां बताए गए तरीके के मुताबिक प्लस कोड फ़ॉर्मैट करें (इसके अलावा, यूआरएल को एस्केप किया गया %2B और स्पेस को यूआरएल से एस्केप किया जाता है):
- ग्लोबल कोड चार वर्णों का एरिया कोड या छह वर्ण या उससे लंबा स्थानीय कोड होता है (849VCWC8+R9 849VCWC8%2BR9 है).
- कंपाउंड कोड एक छह वर्णों या उससे ज़्यादा का लोकल कोड है, जिसमें जगह की जानकारी साफ़ तौर पर दी गई होती है (CWC8+R9 माउंटेन व्यू, सीए, अमेरिका CWC8%2BR9%20Mountain%20View%20CA%20USA है).
----
components — पाइप (|) से अलग किए गए एलिमेंट वाला कॉम्पोनेंट फ़िल्टर. कॉम्पोनेंट फ़िल्टर, address दिए जाने पर, वैकल्पिक पैरामीटर के तौर पर भी स्वीकार किया जाता है. कॉम्पोनेंट फ़िल्टर के हर एलिमेंट में एक component:value पेयर की सुविधा होती है. साथ ही, नतीजों में दिखने वाले सभी लोगों को पूरी तरह से दिखाया जा सकता है. नीचे कॉम्पोनेंट फ़िल्टर के बारे में ज़्यादा जानकारी देखें.
key — आपके ऐप्लिकेशन की एपीआई कुंजी. यह कुंजी, कोटा मैनेज करने के लिए आपके ऐप्लिकेशन की पहचान करती है. कुंजी पाने का तरीका जानें.

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

किसी जियोकोडिंग अनुरोध में वैकल्पिक पैरामीटर:

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

जवाब

जियोकोडिंग रिस्पॉन्स, यूआरएल अनुरोध में या output या डिफ़ॉल्ट तौर पर JSON फ़ॉर्मैट में दिखाए गए फ़ॉर्मैट में दिखाए जाते हैं.

इस उदाहरण में, जियोकोडिंग एपीआई ने जगह का आईडी "ChIJeRpOeF67j4AR9ydy_PIzPuM" पर की गई क्वेरी के लिए json अनुरोध का अनुरोध किया. यह जगह 1600 Amphitheatre Parkway, Mountain View, CA में मौजूद इमारत के लिए है.

प्लस कोड आयताकार-एन्कोडेड स्थान संदर्भों में होते हैं, जो अक्षांश और देशांतर निर्देशांकों से लिए जाते हैं. पूरी तरह से बताए गए मोहल्ले के पतों के लिए अनुरोध, जैसे कि "1600 Amphitheatre Parkway, Mountain View, CA", अगर नतीजे में बिल्डिंग या परिसर हो, तो हो सकता है कि वह प्लस कोड न दिखाए, क्योंकि इन नतीजों में आम तौर पर एक से ज़्यादा कोड क्षेत्र होते हैं.

यह अनुरोध JSON फ़्लैग output का इस्तेमाल करके दिखाया गया है:

https://maps.googleapis.com/maps/api/geocode/json?place_id=ChIJeRpOeF67j4AR9ydy_PIzPuM&key=YOUR_API_KEY

यह अनुरोध XML output फ़्लैग का इस्तेमाल करके दिखाता है:

https://maps.googleapis.com/maps/api/geocode/xml?place_id=ChIJeRpOeF67j4AR9ydy_PIzPuM&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"
                    ]
                }
            ],
            "formatted_address": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA",
            "geometry": {
                "location": {
                    "lat": 37.4224428,
                    "lng": -122.0842467
                },
                "location_type": "ROOFTOP",
                "viewport": {
                    "northeast": {
                        "lat": 37.4239627802915,
                        "lng": -122.0829089197085
                    },
                    "southwest": {
                        "lat": 37.4212648197085,
                        "lng": -122.0856068802915
                    }
                }
            },
            "place_id": "ChIJeRpOeF67j4AR9ydy_PIzPuM",
            "plus_code": {
                "compound_code": "CWC8+X8 Mountain View, CA",
                "global_code": "849VCWC8+X8"
            },
            "types": [
                "street_address"
            ]
        }
    ],
    "status": "OK"
}

ध्यान दें कि JSON के रिस्पॉन्स में दो रूट एलिमेंट हैं:

"status" के अनुरोध में मेटाडेटा शामिल होता है. यहां दिए गए स्टेटस कोड देखें.
"results" में पते की सही जानकारी और ज्यामिति की जानकारी शामिल होती है.

आम तौर पर, "results" ऐरे में सिर्फ़ एक एंट्री मिलती है, लेकिन पते की खोज करने वाले लोगों को, नतीजे पाने में मुश्किल होती है.

एक्सएमएल

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

स्टेटस कोड

जियोकोडिंग रिस्पॉन्स ऑब्जेक्ट में "status" फ़ील्ड में, अनुरोध की स्थिति होती है. इसमें डीबग करने की जानकारी भी हो सकती है, जिससे आपको यह समझने में मदद मिलती है कि जियोकोडिंग क्यों काम नहीं कर रही है. "status" फ़ील्ड में ये वैल्यू हो सकती हैं:

"OK" से पता चलता है कि कोई गड़बड़ी नहीं हुई है. साथ ही, पते को पार्स कर दिया गया है और कम से कम एक वेब पेज दिखाया गया है.
"ZERO_RESULTS" से पता चलता है कि वेबपेज सही से काम कर रहा है, लेकिन कोई नतीजा नहीं मिला. ऐसा तब हो सकता है, जब GCLID को किसी गैर-मौजूद address से पास किया गया हो.
OVER_DAILY_LIMIT इनमें से किसी एक चीज़ को दिखाता है:
- एपीआई कुंजी मौजूद नहीं है या अमान्य है.
- आपके खाते पर बिलिंग चालू नहीं की गई है.
- खुद के इस्तेमाल की सीमा पार हो गई है.
- दिया गया पैसे चुकाने का तरीका अब मान्य नहीं है (उदाहरण के लिए, क्रेडिट कार्ड की समयसीमा खत्म हो गई है).
इसे ठीक करने का तरीका जानने के लिए, Maps के बारे में अक्सर पूछे जाने वाले सवाल देखें.
"OVER_QUERY_LIMIT" यह बताता है कि आप अपने कोटे से ज़्यादा हैं.
"REQUEST_DENIED" यह बताता है कि आपका अनुरोध अस्वीकार कर दिया गया है.
आम तौर पर, "INVALID_REQUEST" से पता चलता है कि क्वेरी (address, components या latlng) मौजूद नहीं है.
"UNKNOWN_ERROR" यह बताता है कि सर्वर की गड़बड़ी की वजह से, अनुरोध को प्रोसेस नहीं किया जा सका. दोबारा कोशिश करने पर, हो सकता है कि आपका अनुरोध स्वीकार न हो.

गड़बड़ी के मैसेज

जब जियोकोडर OK के अलावा और कोई स्टेटस कोड दिखाता है, तो जियोकोडिंग रिस्पॉन्स ऑब्जेक्ट में अतिरिक्त error_message फ़ील्ड जोड़ा जा सकता है. इस फ़ील्ड में, दिए गए स्टेटस कोड को बनाने की वजहें बताई जाती हैं.

नतीजे

जब Firebase का नतीजा मिलता है, तो वह उन्हें (JSON) results ऐरे में रखता है. भले ही, एन्कोडर नहीं होने पर कोई नतीजा (जैसे कि पता मौजूद न हो) होने पर भी कोई खाली results कलेक्शन दिखाता है. (एक्सएमएल रिस्पॉन्स में शून्य या <result> एलिमेंट होते हैं.)

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

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

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

प्रोग्राम के हिसाब से, फ़ॉर्मैट किए गए पते को पार्स न करें. इसके बजाय, आपको अलग-अलग पते वाले कॉम्पोनेंट का इस्तेमाल करना चाहिए. इस एपीआई में, फ़ॉर्मैट किए गए पते वाले फ़ील्ड के साथ-साथ, एपीआई के जवाब भी शामिल होते हैं.
address_components[] एक कैटगरी है, जिसमें इस पते पर लागू होने वाले अलग-अलग कॉम्पोनेंट शामिल होते हैं.
आम तौर पर, पते के हर कॉम्पोनेंट में ये फ़ील्ड होते हैं:
- types[] एक कलेक्शन है, जो पते वाले कॉम्पोनेंट के टाइप की जानकारी देता है. इस्तेमाल किए जा सकने वाले टाइप की सूची देखें.
- long_name, पूरे टेक्स्ट की जानकारी या जियोकोडर के दिए गए पते के कॉम्पोनेंट का नाम होता है.
- अगर उपलब्ध हो, तो short_name पता टेक्स्ट के कॉम्पोनेंट का छोटा नाम होता है. उदाहरण के लिए, अलास्का राज्य के लिए पता के कॉम्पोनेंट में "अलास्का" का long_name और "AK" का short_name हो सकता है. इसके लिए, दो अक्षर वाले छोटे छोटे नाम का इस्तेमाल किया जाता है.
address_components[] कलेक्शन के बारे में यह जानकारी दें:
- पते के कलेक्शन में, formatted_address से ज़्यादा कॉम्पोनेंट हो सकते हैं.
- यह ज़रूरी नहीं है कि श्रेणी में उन सभी राजनैतिक इकाइयों को शामिल किया गया हो जिनमें पता होता है. इनमें formatted_address में शामिल राजनैतिक इकाइयां भी शामिल होती हैं. किसी खास पते वाली सभी राजनैतिक इकाइयों को फिर से पाने के लिए, आपको पते के अक्षांश/देशांतर को अनुरोध के तौर पर पास करके, रिवर्स जियोकोडिंग का इस्तेमाल करना चाहिए.
- यह ज़रूरी नहीं है कि रिस्पॉन्स का फ़ॉर्मैट, अनुरोधों के बीच एक जैसा ही रहे. खास तौर पर, address_components के लिए अनुरोध किए गए पते के आधार पर यह संख्या बदल सकती है. हालांकि, समय के साथ पते की संख्या बदल सकती है. कोई कॉम्पोनेंट, ऐरे में पोज़िशन बदल सकता है. कॉम्पोनेंट किस तरह का है, इसमें बदलाव किया जा सकता है. हो सकता है कि बाद में दिए गए जवाब में कोई खास कॉम्पोनेंट मौजूद न हो.
कॉम्पोनेंट के कलेक्शन को मैनेज करने के लिए, आपको रिस्पॉन्स को पार्स करना होगा और एक्सप्रेशन की मदद से सही वैल्यू चुननी होंगी. जवाब को पार्स करने की गाइड देखें.
postcode_localities[] एक कलेक्शन है, जो पिन कोड में शामिल सभी इलाकों को दिखाता है. यह नतीजा तब ही दिखता है, जब नतीजे में एक पिन कोड दिया गया हो, जिसमें कई इलाके शामिल हों.
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 से यह पता चलता है कि भौगोलिक अनुरोध में, मूल अनुरोध से पूरी तरह मेल नहीं खाता, हालांकि यह अनुरोध किए गए पते के हिस्से से पूरी तरह मेल खाता था. हो सकता है कि आप गलत स्पेलिंग और/या पते के अधूरे होने के मूल अनुरोध की जांच करना चाहें.

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

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

उदाहरण के लिए, "Toledo" के लिए एक भौगोलिक पेज इस नतीजे को दिखाता है, क्योंकि जियोकोडिंग एपीआई के लिए डिफ़ॉल्ट डोमेन को अमेरिका पर सेट किया गया है. अनुरोध:

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"
}

कॉम्पोनेंट फ़िल्टर करना

जियोकोडिंग रिस्पॉन्स में, जियोकोडिंग एपीआई से, किसी इलाके के लिए सीमित किए गए पते के नतीजे दिखाए जा सकते हैं. आप components फ़िल्टर का इस्तेमाल करके पाबंदी के बारे में बता सकते हैं. फ़िल्टर में पाइप (|) से अलग किए गए component:value जोड़ों की सूची होती है. फ़िल्टर वैल्यू में वर्तनी (स्पेलिंग) को ठीक करने के तरीके और कुछ दूसरे जियोकोडिंग अनुरोधों की तरह ही आंशिक तौर पर मैच होने वाले तरीके इस्तेमाल किए जा सकते हैं. अगर Firebase को किसी कॉम्पोनेंट फ़िल्टर के लिए कुछ हद तक मैच करने वाला मिलता है, तो जवाब में एक partial_match फ़ील्ड होगा.

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

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

components को नतीजों पर असर डालने के लिए इस्तेमाल किया जा सकता है, लेकिन यह लागू नहीं होता:

route, रास्ते के लंबे या छोटे नाम से मेल खाता है.
locality और sublocality के बीच, locality मैच हो रहा है.
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"
}