ज़्यादा सटीक तरीके से जियोकोड करना

यह प्रॉडक्ट या सुविधा, एक्सपेरिमेंट के तौर पर उपलब्ध है (pre-GA). हो सकता है कि Pre-GA के तहत आने वाले प्रॉडक्ट और सुविधाओं के लिए, आपको पूरी सहायता न मिले. साथ ही, ऐसा हो सकता है कि Pre-GA के तहत आने वाले प्रॉडक्ट और सुविधाओं में किए गए बदलाव, Pre-GA के अन्य वर्शन के साथ काम न करें. Pre-GA ऑफ़र पर, Google Maps Platform की सेवा से जुड़ी खास शर्तें लागू होती हैं. ज़्यादा जानकारी के लिए, लॉन्च के चरणों की जानकारी देखें.

यूरोपियन इकनॉमिक एरिया (ईईए) के डेवलपर

अगर आपका बिलिंग पता यूरोपियन इकनॉमिक एरिया में है, तो 8 जुलाई 2025 से, सेवाओं के आपके इस्तेमाल पर Google Maps Platform की ईईए से जुड़ी सेवा की शर्तें लागू होंगी. यह सुविधा, देश/इलाके के हिसाब से अलग-अलग हो सकती है. ज़्यादा जानें.

GeocodeAddress और SearchDestinations तरीके, वैकल्पिक effort पैरामीटर के साथ काम करते हैं. इससे आपको जवाब मिलने में लगने वाले समय और पते की सटीक जानकारी के बीच संतुलन बनाने में मदद मिलती है.

स्टैंडर्ड जियोकोडिंग, सही फ़ॉर्मैट वाले डाक पतों को एक सेकंड से भी कम समय में प्रोसेस कर लेती है. हालांकि, असल दुनिया में इनपुट अक्सर अधूरे, अनौपचारिक या जटिल होते हैं. उदाहरण के लिए, "Flat 4B, Sunrise Apartments, opposite Central Mall, Andheri West, Mumbai" या "where the warriors play, sf". ज़्यादा effort लेवल कॉन्फ़िगर करके, Geocoding API को मुश्किल पतों को हल करने के लिए, ज़्यादा तर्क और साफ़ तौर पर जानकारी देने का निर्देश दिया जा सकता है.

अहम जानकारी: यह सुविधा v4alpha चैनल में उपलब्ध है. लॉन्च के चरणों के चैनलों के बारे में ज़्यादा जानकारी.

एफ़र्ट लेवल

effort पैरामीटर के लिए, इनमें से कोई एक वैल्यू डालें:

कितनी मेहनत करनी होगी	ब्यौरा	सामान्य लेटेंसी	इस्तेमाल के सुझाए गए उदाहरण
EFFORT_UNSPECIFIED	डिफ़ॉल्ट मान. यह LOW मेहनत की तरह ही काम करता है.	सब-सेकंड	डिफ़ॉल्ट स्टैंडर्ड जियोकोडिंग.
LOW	सबसे तेज़ जवाब देने के लिए ऑप्टिमाइज़ किया गया है. यह मुश्किल पतों के लिए, ज़्यादा जानकारी वाली खोज या साफ़ तौर पर जानकारी देने की सुविधा नहीं देता.	एक सेकंड से कम	रीयल-टाइम में इंटरैक्टिव लुकअप, बड़ी संख्या में स्टैंडर्ड पतों की पुष्टि.
MEDIUM	यह स्पीड और सटीक जानकारी देने की क्षमता को बैलेंस करता है. ज़्यादातर अनुरोधों के जवाब, स्टैंडर्ड इंतज़ार के समय के साथ मिलते हैं. अगर पते की जानकारी साफ़ तौर पर नहीं दी गई है या उसे समझना मुश्किल है, तो सेवा उसे ज़्यादा सटीक बनाने के लिए अतिरिक्त प्रोसेसिंग करती है. इसमें कुछ सेकंड लग सकते हैं.	स्टैंडर्ड पतों के लिए एक सेकंड से भी कम समय; ऐसे पते जो साफ़ तौर पर समझ न आएं उनके लिए कुछ सेकंड (≤ 4 सेकंड)	इंटरैक्टिव यूज़र वर्कफ़्लो (जैसे, चेकआउट के समय पते की पुष्टि करना), जहां उपयोगकर्ता कुछ समय के लिए इंतज़ार कर सकते हैं.
HIGH	अधूरे, अनौपचारिक या जटिल पतों के लिए, पते की सटीक जानकारी पाने की सुविधा को बेहतर बनाता है. जवाब मिलने में ज़्यादा समय लग सकता है.	मुश्किल पतों के लिए 20 सेकंड तक	बैकग्राउंड में चल रही प्रोसेस, बैच जियोकोडिंग, लॉजिस्टिक डिस्पैच या चेकआउट के बाद पते को बेहतर बनाने की प्रोसेस.

ध्यान दें: MEDIUM और HIGH एफ़र्ट लेवल, Gemini मॉडल का इस्तेमाल करके मुश्किल पतों को प्रोसेस करते हैं और उनके बारे में साफ़ तौर पर जानकारी देते हैं. जवाब, एआई की मदद से जनरेट किए जाते हैं. इसलिए, इनमें गलतियां हो सकती हैं.

अनुरोध के उदाहरण

उन जगहों को खोजने के लिए जहां आपको जाना है (SearchDestinations)

https://geocode.googleapis.com/v4alpha/geocode/destinations को किए गए POST अनुरोध के JSON अनुरोध के मुख्य हिस्से में, effort फ़ील्ड को शामिल करें. effort पैरामीटर का असर मुख्य रूप से addressQuery रिज़ॉल्यूशन पर पड़ता है:

curl -X POST -d '{
  "addressQuery": {
    "addressQuery": "Flat 4B, Sunrise Apartments, opposite Central Mall, Andheri West, Mumbai"
  },
  "effort": "HIGH"
}' \
-H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: *" \
https://geocode.googleapis.com/v4alpha/geocode/destinations

किसी पते को जियोकोड करना (GeocodeAddress)

/v4alpha/ एंडपॉइंट पर किए जाने वाले GET अनुरोध में, effort पैरामीटर को यूआरएल क्वेरी पैरामीटर के तौर पर पास करें:

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
"https://geocode.googleapis.com/v4alpha/geocode/address/where+the+warriors+play,+sf?effort=MEDIUM"

इंतज़ार के समय के असर को कम करना

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

इंटरैक्टिव यूज़र फ़्लो (जैसे, चेकआउट या बुकिंग) पर इंतज़ार के समय के असर को कम करने के लिए, मल्टी-पास वर्कफ़्लो का इस्तेमाल किया जा सकता है:

1. पास 1 (इंटरैक्टिव): effort=LOW (या डिफ़ॉल्ट) के साथ सिंक्रोनस रिक्वेस्ट भेजें, ताकि एक सेकंड से भी कम समय में पते की पुष्टि की जा सके.
2. दूसरा चरण (बैकग्राउंड): effort=MEDIUM या effort=HIGH के साथ एसिंक्रोनस फ़ॉलो-अप अनुरोध भेजें. उदाहरण के लिए, चेकआउट के बाद या डिस्पैच से पहले. इससे उपयोगकर्ता को ब्लॉक किए बिना, मुश्किल पतों को सटीक निर्देशांकों, एंट्री पॉइंट, और नेविगेशन पॉइंट में बदला जा सकता है.

इस्तेमाल करने की सीमाएँ

एक्सपेरिमेंटल (v4alpha) लॉन्च स्टेज के दौरान, effort को MEDIUM या HIGH पर सेट करके किए गए अनुरोधों पर, स्टैंडर्ड (LOW) अनुरोधों की तुलना में अनुरोध संख्या सीमित करने की ज़्यादा पाबंदियां लागू होती हैं. अगर आपका ऐप्लिकेशन, अनुरोध संख्या सीमित करने की इन सीमाओं को पार कर जाता है, तो एपीआई RESOURCE_EXHAUSTED (HTTP 429) गड़बड़ी दिखाता है. अगर आपको HTTP 429 गड़बड़ियां मिलती हैं या आपको अपने इस्तेमाल के उदाहरण के लिए ज़्यादा कोटा चाहिए, तो सुझाव/राय देने या शिकायत करने के चैनल के ज़रिए हमसे संपर्क करें.

सुझाव/राय दें या शिकायत करें

यह Geocoding API की एक सुविधा है, जिसे फ़िलहाल एक्सपेरिमेंट के तौर पर उपलब्ध कराया गया है. हमें आपके सुझाव/राय/शिकायत का इंतज़ार रहेगा. इसके लिए, [e-mail] पर ईमेल भेजें.