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

अनुरोध

जियोकोडिंग एपीआई अनुरोध इस तरह से होता है:

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

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

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

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

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

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

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

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

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

    --OR--
    components — एलिमेंट वाला एक कॉम्पोनेंट फ़िल्टर, जिसे पाइप (|) से अलग किया जाता है. अगर address दिया गया है, तो कॉम्पोनेंट फ़िल्टर को वैकल्पिक पैरामीटर के तौर पर भी स्वीकार किया जाता है. कॉम्पोनेंट फ़िल्टर में मौजूद हर एलिमेंट में component:value पेयर होता है और यह जियोकोडर से मिलने वाले नतीजों पर पूरी तरह से पाबंदी लगाता है. नीचे कॉम्पोनेंट को फ़िल्टर करने के बारे में ज़्यादा जानकारी देखें.
  • key — आपके ऐप्लिकेशन की एपीआई कुंजी. यह कुंजी कोटा मैनेजमेंट के लिए, आपके ऐप्लिकेशन की पहचान करती है. कुंजी पाने का तरीका जानें.

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

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

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

जवाब

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

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

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

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

यह अनुरोध एक्सएमएल 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" कलेक्शन में सिर्फ़ एक एंट्री दी जाती है. हालांकि, अगर पते से जुड़ी क्वेरी साफ़ तौर पर नहीं बताई गई हैं, तो जियोकोडर कई नतीजे दिखा सकता है.

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, इनमें से किसी एक के बारे में बताता है:
    • एपीआई पासकोड मौजूद नहीं है या अमान्य है.
    • आपके खाते के लिए बिलिंग की सुविधा चालू नहीं की गई है.
    • खुद से लगाई गई इस्तेमाल की सीमा पार हो गई है.
    • पैसे चुकाने का दिया गया तरीका अब मान्य नहीं है. उदाहरण के लिए, क्रेडिट कार्ड की समयसीमा खत्म हो गई हो.

    इसे ठीक करने का तरीका जानने के लिए, 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 और short_name "AK" हो सकता है.

    address_components[] कलेक्शन के बारे में इन तथ्यों पर ध्यान दें:

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

    कॉम्पोनेंट के कलेक्शन को मैनेज करने के लिए, आपको रिस्पॉन्स को पार्स करना होगा. साथ ही, एक्सप्रेशन के ज़रिए सही वैल्यू चुननी होंगी. किसी जवाब को पार्स करने की गाइड देखें.

  • postcode_localities[] किसी पिन कोड में मौजूद ज़्यादा से ज़्यादा 100 इलाकों की जानकारी देने वाला कलेक्शन है. यह सिर्फ़ तब दिखता है, जब नतीजा ऐसा पिन कोड होता है जिसमें एक से ज़्यादा शहर होते हैं.
  • geometry में यह जानकारी शामिल है:
    • location में जियोकोड किया गया अक्षांश, देशांतर मान है. सामान्य पता लुकअप के लिए, आम तौर पर यह फ़ील्ड सबसे ज़रूरी होता है.
    • location_type, बताई गई जगह के बारे में अतिरिक्त डेटा स्टोर करता है. फ़िलहाल, ये वैल्यू इस्तेमाल की जा सकती हैं:

      • "ROOFTOP" बताता है कि लौटाया गया नतीजा एक सटीक जियोकोड है जिसके लिए हमारे पास जगह की सटीक जानकारी से लेकर मोहल्ले का पता सटीक होता है.
      • "RANGE_INTERPOLATED" से पता चलता है कि दिखाया गया नतीजा दो सटीक पॉइंट (जैसे कि चौराहों) के बीच का अनुमान (आम तौर पर सड़क पर) दिखाता है. आम तौर पर, इंटरपोलेट किए गए नतीजे तब दिखाए जाते हैं, जब किसी मोहल्ले के पते के लिए छत पर जियोकोड उपलब्ध नहीं होता.
      • "GEOMETRIC_CENTER" से पता चलता है कि दिखाया गया नतीजा, नतीजे का ज्यामितीय केंद्र है. जैसे, पॉलीलाइन (उदाहरण के लिए, सड़क) या पॉलीगॉन (क्षेत्र).
      • "APPROXIMATE" से पता चलता है कि यह नतीजा अनुमानित है.
    • viewport में लौटाए गए नतीजे को दिखाने के लिए सुझाया गया व्यूपोर्ट होता है, जिसे दो अक्षांश और देशांतर वैल्यू के तौर पर तय किया जाता है. ये व्यूपोर्ट बाउंडिंग बॉक्स के southwest और northeast कोने को तय करते हैं. आम तौर पर, व्यूपोर्ट का इस्तेमाल किसी नतीजे को उपयोगकर्ता को दिखाते समय उसे फ़्रेम करने के लिए किया जाता है.
    • bounds (विकल्प के तौर पर दिया गया विकल्प) बाउंडिंग बॉक्स को सेव करता है. इसमें, लौटाए गए नतीजे को पूरी तरह से शामिल किया जा सकता है. ध्यान दें कि हो सकता है कि ये सीमाएं, सुझाए गए व्यूपोर्ट से मेल न खाएं. (उदाहरण के लिए, सैन फ़्रांसिस्को में फ़ैरालॉन आइलैंड शामिल हैं, जो तकनीकी रूप से शहर का हिस्सा हैं. हालांकि, ऐसा हो सकता है कि इन्हें व्यूपोर्ट में न दिखाया जाए.)
  • plus_code (ओपन लोकेशन कोड और प्लस कोड देखें) कोड में बदली गई जगह की जानकारी होती है. इसे अक्षांश और देशांतर निर्देशांक से लिया जाता है. यह क्षेत्र को दिखाता है: डिग्री का 1/8, 000वां हिस्सा, डिग्री का 1/8000वां (भूमध्य रेखा पर करीब 14 मीटर x 14 मीटर) या इससे छोटा. प्लस कोड का इस्तेमाल ऐसी जगहों पर सड़क के पतों के बदले किया जा सकता है जहां पते मौजूद नहीं हैं (जहां इमारतों को नंबर नहीं दिया गया है या सड़कों के नाम नहीं दिए गए हैं). एपीआई हमेशा प्लस कोड नहीं दिखाता है.

    जब सेवा कोई प्लस कोड दिखाती है, तो उसे ग्लोबल कोड और कंपाउंड कोड के तौर पर फ़ॉर्मैट किया जाता है:

    • global_code, चार वर्ण वाला एरिया कोड और छह या इससे ज़्यादा वर्णों का लोकल कोड है (849VCWC8+R9).
    • compound_code, छह वर्ण या उससे ज़्यादा का स्थानीय कोड है, जिसकी जगह की जानकारी साफ़ तौर पर दी गई होती है (CWC8+R9, Mountain View, CA, USA). इस कॉन्टेंट को प्रोग्राम के हिसाब से पार्स न करें.
    जहां उपलब्ध हो, एपीआई ग्लोबल कोड और कंपाउंड कोड, दोनों की जानकारी दिखाता है. हालांकि, अगर नतीजा किसी दूसरी जगह (उदाहरण के लिए, कोई महासागर या रेगिस्तान) में है, तो सिर्फ़ ग्लोबल कोड दिखाया जा सकता है.
  • partial_match बताता है कि जियोकोडर ने मूल अनुरोध के लिए सटीक मिलान नहीं दिया, हालांकि यह अनुरोध किए गए पते के हिस्से से मेल खा रहा था. गलत स्पेलिंग और/या अधूरे पते के लिए, मूल अनुरोध की जांच की जा सकती है.

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

  • 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 किसी बस, ट्रेन या सार्वजनिक परिवहन स्टॉप की जगह दिखाते हैं.

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

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

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 जोड़े की सूची होती है. फ़िल्टर की वैल्यू में, स्पेलिंग को ठीक करने और कुछ हद तक मैच करने के तरीके, दूसरे जियोकोडिंग अनुरोधों की तरह ही काम करते हैं. अगर जियोकोडर को किसी कॉम्पोनेंट फ़िल्टर से कुछ हद तक मैच मिलता है, तो रिस्पॉन्स में partial_match फ़ील्ड शामिल होगा.

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

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

नतीजों में बदलाव करने के लिए इस 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"
}