Geocoding API के बारे में खास जानकारी

Geocoding API एक वेब सेवा है. यह पतों को निर्देशांकों और जगह के आईडी में बदलती है. साथ ही, निर्देशांकों या जगह के आईडी को पतों में बदलती है. इसका v4 SearchDestinations तरीका, मंज़िल की जानकारी भी दिखाता है. जैसे, इमारत में जाने के रास्ते, नेविगेशन पॉइंट, इमारत और मैदान की आउटलाइन, और आस-पास के लैंडमार्क.

Geocoding API: अहम जानकारी

  • प्रॉडक्ट: Geocoding API
  • कैटगरी: जगहें
  • प्लैटफ़ॉर्म: वेब सेवा (REST)
  • इस पर चलता है: सर्वर (बैकएंड कोड)
  • लॉन्च स्टेज: GA
  • लाइफ़साइकल: चालू है
  • खास जानकारी: Geocoding API के बारे में खास जानकारी

Geocoding API: इसका इस्तेमाल कब करें

Geocoding API का इस्तेमाल तब करें, जब:

  • आपको अपने बैकएंड सर्वर पर, मोहल्ले के पते को अक्षांश/देशांतर निर्देशांक और जगह के आईडी में बदलना होगा.
  • जीपीएस कोऑर्डिनेट या किसी जगह के आईडी के लिए, आपको डिसप्ले पता या राज्य (शहर, पिन कोड) की जानकारी देनी होगी.
  • ड्राइवर या कूरियर को किसी डेस्टिनेशन तक पहुंचाने के लिए, आपको बिल्डिंग के दरवाज़ों, रूट किए जा सकने वाले नेविगेशन पॉइंट या बिल्डिंग/ग्राउंड की आउटलाइन की ज़रूरत होती है.
  • आपको किसी बड़े कॉम्प्लेक्स (हवाई अड्डा, मॉल, कैंपस) के अंदर मौजूद डेस्टिनेशन को सब-डेस्टिनेशन या आस-पास की जगहों में बांटना होगा.

Geocoding API का इस्तेमाल तब न करें, जब:

  • आपको क्लाइंट-साइड ब्राउज़र JavaScript से जियोकोडिंग की ज़रूरत है. एक्सपोज़ किए गए एपीआई पासकोड के साथ v4 को कॉल करना, सुरक्षा के लिए खतरा है. इसके बजाय, Maps JavaScript API का इस्तेमाल करें.
  • आपको जियोकोड किए गए डेस्टिनेशन के लिए, रास्ते या ईटीए का हिसाब लगाना होगा. इसके बजाय, Routes API का इस्तेमाल करें.
  • आपको Android ऐप्लिकेशन में नेविगेशन पॉइंट टोकन के लिए, मोड़-दर-मोड़ निर्देश चाहिए. इसके बजाय, Android के लिए Navigation SDK का इस्तेमाल करें.
  • आपको iOS ऐप्लिकेशन में, नेविगेशन पॉइंट टोकन के लिए मोड़-दर-मोड़ दिशा-निर्देश चाहिए. इसके बजाय, iOS के लिए Navigation SDK टूल का इस्तेमाल करें.

Geocoding API: सेटअप

Geocoding API: आम तौर पर होने वाली गलतियां

  • समस्या: फ़ील्ड मास्क के बिना किए गए SearchDestinations अनुरोधों में गड़बड़ी होती है. GeocodeAddress, GeocodeLocation, और GeocodePlace के उलट, फ़ील्ड मास्क ज़रूरी है. ठीक करने का तरीका: हर SearchDestinations अनुरोध पर, X-Goog-FieldMask हेडर या $fields पैरामीटर सेट करें. /maps/documentation/geocoding/choose-fields देखें.
  • समस्या: v4 GeocodeAddress में कोई हार्ड कॉम्पोनेंट फ़िल्टर (v3 components=country:US) नहीं है. स्ट्रक्चर्ड address.* पैरामीटर को एक पते में जोड़ दिया जाता है और नतीजों को फ़िल्टर नहीं किया जाता; regionCode में भी v4 में कोई डिफ़ॉल्ट नहीं है (v3 में डिफ़ॉल्ट रूप से us पर सेट है). समाधान: क्लाइंट-साइड पर results को फ़िल्टर करें: अंग्रेज़ी के बड़े अक्षरों में लिखे गए regionCode को postalAddress.regionCode से मैच करें; अंग्रेज़ी के बड़े अक्षरों में लिखे गए दो अक्षरों वाले एडमिन एरिया को postalAddress.administrativeArea और administrative_area_level_n addressComponents (shortText) से मैच करें; इनपुट और postalAddress.postalCode, दोनों को सामान्य बनाएं (स्पेस/हाइफ़न हटाएं और क्षेत्र के नियम लागू करें). /maps/documentation/geocoding/geocoding-v4-migrate देखें.
  • समस्या: ब्राउज़र JavaScript से सीधे Geocoding API v4 को कॉल करने पर, एपीआई पासकोड दिख जाता है. Referer हेडर को फ़र्ज़ी बनाकर, एचटीटीपी रेफ़रर से जुड़ी पाबंदियों को बायपास किया जा सकता है. ठीक करने का तरीका: सुरक्षित पासकोड का इस्तेमाल करके, अपने बैकएंड से v4 को कॉल करें. इसके अलावा, क्लाइंट-साइड की ज़रूरतों के लिए, Maps JavaScript API की जियोकोडिंग सेवा (v3 बैकएंड) का इस्तेमाल करें. /maps/documentation/geocoding/geocoding-v4-migrate देखें.
  • समस्या: SearchDestinations ऐसे नतीजे दिखा सकता है जिनमें सटीक मुख्य पता न हो. हालांकि, v3 और v4 के अन्य तरीकों में ऐसा नहीं होता. ठीक करने का तरीका: अगर आपको सिर्फ़ सटीक मुख्य पतों वाले नतीजे चाहिए, तो placeFilter.addressability को PRIMARY पर सेट करें. /maps/documentation/geocoding/geocoding-v4-migrate देखें.
  • समस्या: Geocoding API v3 के लिए लिखा गया कोड, v4 REST रिस्पॉन्स पर काम नहीं करता: v4 में lowerCamelCase फ़ील्ड के नामों (address_components नहीं, बल्कि addressComponents) का इस्तेमाल किया जाता है. साथ ही, status और error_message को हटा दिया जाता है. इसके अलावा, results कलेक्शन के बजाय GeocodePlace से एक रूट ऑब्जेक्ट मिलता है. ठीक किया गया: v4 REST कॉल पर एचटीटीपी स्टेटस कोड और गड़बड़ी के मुख्य हिस्से की जांच करें. साथ ही, lowerCamelCase फ़ील्ड (addressComponents, postalAddress) पढ़ें. ध्यान दें कि gRPC रिस्पॉन्स अब भी snake_case का इस्तेमाल करते हैं. /maps/documentation/geocoding/geocoding-v4-migrate देखें.

Geocoding API: लेगसी और अब काम न करने वाली सुविधाएं

  • Geocoding API v3 का हाइपरलोकल डेटा (extra_computations: BUILDING_AND_ENTRANCES, NAVIGATION_POINTS, GROUNDS; रिस्पॉन्स फ़ील्ड buildings.entrances, navigation_points, buildings.building_outlines, grounds): 13-08-2025 से अब काम नहीं करता. इसकी जगह इस्तेमाल करें: Geocoding API v4 SearchDestinations मेथड (POST /v4/geocode/destinations). माइग्रेट करने से जुड़ी गाइड देखें.

Geocoding API की मदद से क्या-क्या किया जा सकता है

हर टास्क के लिए, यहां लिंक की गई गाइड देखें या Capabilities Explorer में जाकर, अलग-अलग प्रॉडक्ट की तुलना करें.