किसी जगह का जियोकोड पता करना

जगह की जियोकोडिंग की मदद से, जगह के आईडी से पता वापस पाया जा सकता है.

प्लेस आईडी, Google Places डेटाबेस और Google Maps पर किसी जगह की पहचान करते हैं. किसी पते को जियोकोड करते समय प्लेस आईडी वापस पाएं. जगह की जानकारी (नया), टेक्स्ट खोज (नया), और आस-पास की जगहें खोजें (नया) जैसे कई अन्य एपीआई से भी प्लेस आईडी वापस पाया जा सकता है.

जगह की जियोकोडिंग के अनुरोध

जगह के हिसाब से जियोकोडिंग का अनुरोध, इस तरह का एचटीटीपी GET अनुरोध होता है:

https://geocode.googleapis.com/v4/geocode/places/PLACE_ID

यहां PLACE_ID में, दिलचस्पी वाली जगह का आईडी होता है.

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

https://geocode.googleapis.com/v4/geocode/places/ChIJj61dQgK6j4AR4GeTYWZsKWw?key=API_KEY

या कर्ल कमांड में:

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
"https://geocode.googleapis.com/v4/geocode/places/ChIJj61dQgK6j4AR4GeTYWZsKWw"

अनुरोध करने के लिए OAuth का इस्तेमाल करना

Geocoding API v4, पुष्टि करने के लिए OAuth 2.0 का इस्तेमाल करता है. Geocoding API के साथ OAuth का इस्तेमाल करने के लिए, OAuth टोकन को सही स्कोप असाइन किया जाना चाहिए. Geocoding API, जगह की जियोकोडिंग के साथ इस्तेमाल करने के लिए इन स्कोप के साथ काम करता है:

• https://www.googleapis.com/auth/maps-platform.geocode — इसका इस्तेमाल Geocoding API के सभी तरीकों के साथ किया जाता है.
• https://www.googleapis.com/auth/maps-platform.geocode.place — इसका इस्तेमाल सिर्फ़ GeocodePlace के साथ किया जाता है, ताकि जगह की जियोकोडिंग की जा सके.

इसके अलावा, Geocoding API के सभी तरीकों के लिए, सामान्य https://www.googleapis.com/auth/cloud-platform स्कोप का इस्तेमाल किया जा सकता है. यह स्कोप डेवलपमेंट के दौरान काम आता है, लेकिन प्रोडक्शन के दौरान नहीं. ऐसा इसलिए, क्योंकि यह एक सामान्य स्कोप है, जो सभी तरीकों को ऐक्सेस करने की अनुमति देता है.

ज़्यादा जानकारी और उदाहरणों के लिए, OAuth का इस्तेमाल करना लेख पढ़ें.

जगह के जियोकोडिंग के जवाब

जगह के जियोकोडिंग से, GeocodeResult ऑब्जेक्ट मिलता है. यह ऑब्जेक्ट, जगह के आईडी से मेल खाने वाली जगह के बारे में बताता है.

Geocoding API के जवाबों में, types ऐरे शामिल होते हैं. ये GeocodeResult में दो मुख्य जगहों पर मौजूद होते हैं:

1. GeocodeResult.types: इस कलेक्शन से, नतीजे के टाइप(टाइप) के बारे में पता चलता है. इसकी संभावित वैल्यू, 'जगह के टाइप (नया)' पेज पर मौजूद टेबल A और टेबल B से ली जाती हैं.
2. GeocodeResult.addressComponents[].types: पते के हर कॉम्पोनेंट में types ऐरे होता है. इससे पता चलता है कि पते का वह हिस्सा किस तरह का है. ये वैल्यू, 'जगह के टाइप (नया वर्शन)' पेज पर मौजूद पते के टाइप और पते के कॉम्पोनेंट के टाइप टेबल से ली जाती हैं.

पूरा JSON ऑब्जेक्ट इस फ़ॉर्म में होता है:

{
  "place": "//places.googleapis.com/places/ChIJj61dQgK6j4AR4GeTYWZsKWw",
  "placeId": "ChIJj61dQgK6j4AR4GeTYWZsKWw",
  "location": {
    "latitude": 37.4220541,
    "longitude": -122.08532419999999
  },
  "granularity": "ROOFTOP",
  "viewport": {
    "low": {
      "latitude": 37.4209489697085,
      "longitude": -122.08846930000001
    },
    "high": {
      "latitude": 37.4236469302915,
      "longitude": -122.0829156
    }
  },
  "formattedAddress": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA",
  "postalAddress": {
    "regionCode": "US",
    "languageCode": "en",
    "postalCode": "94043",
    "administrativeArea": "CA",
    "locality": "Mountain View",
    "addressLines": [
      "1600 Amphitheatre Pkwy"
    ]
  },
  "addressComponents": [
    {
      "longText": "1600",
      "shortText": "1600",
      "types": [
        "street_number"
      ]
    },
    {
      "longText": "Amphitheatre Parkway",
      "shortText": "Amphitheatre Pkwy",
      "types": [
        "route"
      ],
      "languageCode": "en"
    },
    {
      "longText": "Mountain View",
      "shortText": "Mountain View",
      "types": [
        "locality",
        "political"
      ],
      "languageCode": "en"
    },
    {
      "longText": "Santa Clara County",
      "shortText": "Santa Clara County",
      "types": [
        "administrative_area_level_2",
        "political"
      ],
      "languageCode": "en"
    },
    {
      "longText": "California",
      "shortText": "CA",
      "types": [
        "administrative_area_level_1",
        "political"
      ],
      "languageCode": "en"
    },
    {
      "longText": "United States",
      "shortText": "US",
      "types": [
        "country",
        "political"
      ],
      "languageCode": "en"
    },
    {
      "longText": "94043",
      "shortText": "94043",
      "types": [
        "postal_code"
      ]
    }
  ],
  "types": [
    "establishment",
    "point_of_interest"
  ]
}

ज़रूरी पैरामीटर

• place — यह उस जगह का आईडी होता है जिसके लिए आपको आसानी से पढ़ा जा सकने वाला पता चाहिए. जगह का आईडी एक यूनीक आइडेंटिफ़ायर होता है. इसका इस्तेमाल Google APIs के साथ किया जा सकता है. उदाहरण के लिए, स्नैप किए गए पॉइंट का पता पाने के लिए, Roads API से मिले placeID का इस्तेमाल किया जा सकता है. जगह के आईडी के बारे में ज़्यादा जानने के लिए, जगह के आईडी देखें.

ज़रूरी नहीं पैरामीटर

• languageCode

  वह भाषा जिसमें नतीजे दिखाने हैं.

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

• regionCode

  देश/इलाके का कोड, दो वर्णों वाले CLDR कोड की वैल्यू के तौर पर. इसकी कोई डिफ़ॉल्ट वैल्यू नहीं होती. ज़्यादातर CLDR कोड, आईएसओ 3166-1 कोड के जैसे ही होते हैं.

  किसी पते को जियोकोड करते समय, फ़ॉरवर्ड जियोकोडिंग के लिए, यह पैरामीटर सेवा से मिले नतीजों को किसी खास इलाके के हिसाब से फ़िल्टर कर सकता है. हालांकि, यह पैरामीटर नतीजों को पूरी तरह से फ़िल्टर नहीं कर सकता. किसी जगह या लोकेशन को जियोकोड करते समय, रिवर्स जियोकोडिंग या जगह के हिसाब से जियोकोडिंग के लिए, इस पैरामीटर का इस्तेमाल पते को फ़ॉर्मैट करने के लिए किया जा सकता है. सभी मामलों में, यह पैरामीटर लागू कानून के आधार पर नतीजों पर असर डाल सकता है.

• FieldMask

  जवाब में दिखाए जाने वाले फ़ील्ड तय करने के लिए, जवाब फ़ील्ड मास्क बनाएं. यूआरएल पैरामीटर $fields या fields का इस्तेमाल करके या एचटीटीपी हेडर X-Goog-FieldMask का इस्तेमाल करके, रिस्पॉन्स फ़ील्ड मास्क को तरीके से पास करें. उदाहरण के लिए, नीचे दिए गए अनुरोध से जवाब के सिर्फ़ formattedAddress फ़ील्ड की वैल्यू मिलेगी.

  curl -X GET -H 'Content-Type: application/json' \
  -H 'X-Goog-FieldMask: formattedAddress' \
  -H "X-Goog-Api-Key: API_KEY" \
  "https://geocode.googleapis.com/v4/geocode/places/ChIJj61dQgK6j4AR4GeTYWZsKWw"
  

  जवाब:

  {
    "formattedAddress": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA"
  }

  ज़्यादा जानकारी के लिए, जवाब में शामिल करने के लिए फ़ील्ड चुनना लेख पढ़ें.