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-backend.googleapis.com - पुष्टि करना: एपीआई पासकोड, OAuth 2.0, सेवा खाता
- शुरू करें: Geocoding API सेट अप करें
- रेफ़रंस: Geocoding API का रेफ़रंस
- कीमत: Geocoding API का इस्तेमाल और बिलिंग
- नीतियां: Geocoding API की नीतियां
- रिलीज़ नोट: Geocoding API के रिलीज़ नोट
Geocoding API: मिलते-जुलते प्रॉडक्ट
- आम तौर पर, इनका इस्तेमाल इनके साथ किया जाता है: Routes API, Android के लिए Navigation SDK, iOS के लिए Navigation SDK
Geocoding API: आम तौर पर होने वाली गलतियां
- समस्या: फ़ील्ड मास्क के बिना किए गए
SearchDestinationsअनुरोधों में गड़बड़ी होती है.GeocodeAddress,GeocodeLocation, औरGeocodePlaceके उलट, फ़ील्ड मास्क ज़रूरी है. ठीक करने का तरीका: हरSearchDestinationsअनुरोध पर,X-Goog-FieldMaskहेडर या$fieldsपैरामीटर सेट करें. /maps/documentation/geocoding/choose-fields देखें. - समस्या: v4
GeocodeAddressमें कोई हार्ड कॉम्पोनेंट फ़िल्टर (v3components=country:US) नहीं है. स्ट्रक्चर्डaddress.*पैरामीटर को एक पते में जोड़ दिया जाता है और नतीजों को फ़िल्टर नहीं किया जाता;regionCodeमें भी v4 में कोई डिफ़ॉल्ट नहीं है (v3 में डिफ़ॉल्ट रूप सेusपर सेट है). समाधान: क्लाइंट-साइड परresultsको फ़िल्टर करें: अंग्रेज़ी के बड़े अक्षरों में लिखे गएregionCodeकोpostalAddress.regionCodeसे मैच करें; अंग्रेज़ी के बड़े अक्षरों में लिखे गए दो अक्षरों वाले एडमिन एरिया कोpostalAddress.administrativeAreaऔरadministrative_area_level_naddressComponents(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 v4SearchDestinationsमेथड (POST /v4/geocode/destinations). माइग्रेट करने से जुड़ी गाइड देखें.
Geocoding API की मदद से क्या-क्या किया जा सकता है
हर टास्क के लिए, यहां लिंक की गई गाइड देखें या Capabilities Explorer में जाकर, अलग-अलग प्रॉडक्ट की तुलना करें.
- किसी पते के अक्षांश/देशांतर निर्देशांक (जियोकोडिंग) को वापस पाना.
- अक्षांश/देशांतर निर्देशांकों के सेट के लिए पता दिखाना (रिवर्स जियोकोडिंग).
- जियोकोडिंग के अनुरोध को सीमित करना, ताकि किसी खास व्यूपोर्ट के हिसाब से नतीजे दिखाए जा सकें. ध्यान दें: Geocoding API v4 में, locationBias नतीजों को तय किए गए व्यूपोर्ट के हिसाब से दिखाता है. हालांकि, यह नतीजों को पूरी तरह से सीमित नहीं करता.
- जियोकोडिंग या रिवर्स जियोकोडिंग के अनुरोध को सीमित करें, ताकि सिर्फ़ किसी खास इलाके, देश या पिन कोड के नतीजे दिखें. ध्यान दें: Geocoding API v4 में, regionCode नतीजों को किसी खास सीएलडीआर क्षेत्र के हिसाब से दिखाता है. हालांकि, यह नतीजों को पूरी तरह से सीमित नहीं करता. देश या पिन कोड के हिसाब से कॉम्पोनेंट फ़िल्टर करने के लेगसी v3 के बारे में जानने के लिए, https://developers.google.com/maps/documentation/geocoding/guides-v3/requests-geocoding#ComponentFiltering पर जाएं.
- रिवर्स जियोकोडिंग के अनुरोध को सीमित करें, ताकि सिर्फ़ पते के तय किए गए टाइप के नतीजे दिखें. ध्यान दें: Geocoding API v4 में, types पैरामीटर खोज को सीमित करने के बजाय, खोज के बाद पते के टाइप के हिसाब से रिवर्स-जियोकोडिंग के नतीजों को फ़िल्टर करता है.
- किसी पते के आस-पास मौजूद लैंडमार्क या इलाकों की जानकारी पाना.
- अक्षांश/देशांतर निर्देशांकों के सेट के लिए, लैंडमार्क या इलाकों के आस-पास की जानकारी दिखाता है.
- Google प्लेस आइडेंटिफ़ायर के लिए, लैंडमार्क या इलाकों की दूरी के बारे में जानकारी दिखाता है.
- Google प्लेस आइडेंटिफ़ायर के लिए पता दिखाना.
- किसी पते के लिए, बिल्डिंग की आउटलाइन के अक्षांश/देशांतर निर्देशांक दिखाना.
- अक्षांश/देशांतर निर्देशांकों के सेट के लिए, किसी इमारत की आउटलाइन के अक्षांश/देशांतर निर्देशांक दिखाना.
- Google प्लेस आइडेंटिफ़ायर के लिए, किसी इमारत की आउटलाइन के अक्षांश/देशांतर निर्देशांक दिखाता है.
- किसी पते के लिए, इमारत के प्रवेश द्वार के अक्षांश/देशांतर निर्देशांक दिखाना.
- अक्षांश/देशांतर निर्देशांकों के सेट के लिए, किसी इमारत के प्रवेश द्वार के अक्षांश/देशांतर निर्देशांक दिखाना.
- Google प्लेस आइडेंटिफ़ायर के लिए, किसी इमारत के प्रवेश द्वार के अक्षांश/देशांतर निर्देशांक दिखाता है.