- एचटीटीपी अनुरोध
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- PostalAddress
- LanguageOptions
- ValidationResult
- फ़ैसला
- जानकारी का स्तर
- पता
- AddressComponent
- ComponentName
- ConfirmationLevel
- जियोकोड
- LatLng
- PlusCode
- व्यूपोर्ट
- AddressMetadata
- UspsData
- UspsAddress
पते की पुष्टि करता है.
एचटीटीपी अनुरोध
POST https://addressvalidation.googleapis.com/v1:validateAddress
यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.
अनुरोध का मुख्य भाग
अनुरोध के मुख्य हिस्से में, इस तरह का डेटा शामिल होता है:
जेएसओएन के काेड में दिखाना |
---|
{ "address": { object ( |
फ़ील्ड | |
---|---|
address |
ज़रूरी है. पते की पुष्टि की जा रही है. फ़ॉर्मैट नहीं किए गए पते, इस इनपुट में फ़ील्ड की कुल लंबाई 280 वर्णों से ज़्यादा नहीं होनी चाहिए. इन देशों और इलाकों की जानकारी यहां देखी जा सकती है. इनपुट पते में पते की पुष्टि करने वाला एपीआई, |
previousResponseId |
पते की पुष्टि करने के पहले अनुरोध के लिए, यह फ़ील्ड खाली होना चाहिए. अगर किसी एक पते की पूरी तरह से पुष्टि करने के लिए ज़्यादा अनुरोधों की ज़रूरत हो (उदाहरण के लिए, अगर उपयोगकर्ता शुरुआती पुष्टि के बाद किए गए बदलावों की फिर से पुष्टि करना ज़रूरी है), तो हर फ़ॉलोअप अनुरोध को इस फ़ील्ड में पुष्टि के क्रम में सबसे पहले जवाब से ही |
enableUspsCass |
USPS CASS के साथ काम करने वाले मोड को चालू करता है. इससे सिर्फ़ हमारा सुझाव है कि आप कॉम्पोनेंट के तौर पर मौजूद |
languageOptions |
ज़रूरी नहीं. झलक: यह सुविधा, झलक (प्री-GA) में है. ऐसा हो सकता है कि Pre-GA प्रॉडक्ट और सुविधाएं सीमित तौर पर काम करें. साथ ही, Pre-GA प्रॉडक्ट और सुविधाओं में किए गए बदलाव भी शायद Pre-GA वर्शन के साथ काम न करें. Pre-GA ऑफ़र के लिए Google Maps Platform की सेवा की खास शर्तें लागू होती हैं. ज़्यादा जानकारी के लिए, लॉन्च के चरण की जानकारी देखें. जवाब में अतिरिक्त जानकारी शामिल करने के लिए, पते की पुष्टि करने वाले एपीआई को चालू करता है. |
sessionToken |
ज़रूरी नहीं. वह स्ट्रिंग जो बिलिंग के मकसद से, ऑटोकंप्लीट सेशन की पहचान करती है. यह एक यूआरएल और फ़ाइल नाम वाली सेफ़ base64 स्ट्रिंग होनी चाहिए, जिसमें ज़्यादा से ज़्यादा 36 ASCII वर्ण हों. अगर ऐसा नहीं होता है, तो एक INVALID_LABEL गड़बड़ी मिलती है. सेशन तब शुरू होता है, जब उपयोगकर्ता अपने-आप पूरी होने वाली क्वेरी करता है. इसके बाद, जब कोई उपयोगकर्ता किसी जगह को चुनता है और जगह की जानकारी के लिए कॉल करता है या पते की पुष्टि करता है, तब यह सेशन खत्म होता है. हर सेशन में, अपने-आप पूरी होने वाली कई क्वेरी हो सकती हैं. इसके बाद, जगह की जानकारी या पते की पुष्टि करने का एक अनुरोध हो सकता है. किसी सेशन में हर अनुरोध के लिए इस्तेमाल किए जाने वाले क्रेडेंशियल, एक ही Google Cloud Console प्रोजेक्ट से जुड़े होने चाहिए. सेशन खत्म होने के बाद, टोकन मान्य नहीं रहता. आपके ऐप्लिकेशन को हर सेशन के लिए नया टोकन जनरेट करना होगा. अगर ध्यान दें: पते की पुष्टि करने की सुविधा का इस्तेमाल, सिर्फ़ ऑटोकंप्लीट (नया) एपीआई वाले सेशन में किया जा सकता है, ऑटोकंप्लीट एपीआई वाले सेशन में नहीं. ज़्यादा जानकारी के लिए, https://developers.google.com/maps/documentation/places/web-service/session-pricing पर जाएं. |
जवाब का मुख्य भाग
पते की पुष्टि करने के अनुरोध का जवाब.
अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.
जेएसओएन के काेड में दिखाना |
---|
{
"result": {
object ( |
फ़ील्ड | |
---|---|
result |
पते की पुष्टि से मिला नतीजा. |
responseId |
वह यूयूआईडी जो इस रिस्पॉन्स की पहचान करता है. अगर पते की दोबारा पुष्टि करने की ज़रूरत है, तो नए अनुरोध के साथ यह यूयूआईडी ज़रूरी है. |
PostalAddress
डाक पता दिखाता है. जैसे, डाक पता या पेमेंट के पते के लिए. डाक पते के आधार पर, डाक सेवा किसी परिसर, पी॰ओ॰ बॉक्स या ऐसे ही किसी स्टोर पर सामान डिलीवर कर सकती है. यह भौगोलिक जगहों (सड़कों, कस्बों, पहाड़ों) को मॉडल करने के लिए नहीं बनाया गया है.
सामान्य इस्तेमाल में पता, उपयोगकर्ता के इनपुट या मौजूदा डेटा को इंपोर्ट करके बनाया जाएगा. यह इस पर निर्भर करता है कि प्रोसेस किस तरह की है.
पता इनपुट / बदलाव के बारे में सलाह: - https://github.com/google/libaddressinput जैसे अंतरराष्ट्रीय के लिए तैयार पता विजेट का इस्तेमाल करें - उपयोगकर्ताओं को उन देशों के बाहर फ़ील्ड में इनपुट या बदलाव करने के लिए यूज़र इंटरफ़ेस (यूआई) एलिमेंट का इस्तेमाल नहीं किया जाना चाहिए जहां उस फ़ील्ड का इस्तेमाल किया जाता है.
इस स्कीमा का इस्तेमाल करने के तरीके के बारे में ज़्यादा जानकारी के लिए, कृपया यह देखें: https://support.google.com/business/answer/6397478
जेएसओएन के काेड में दिखाना |
---|
{ "revision": integer, "regionCode": string, "languageCode": string, "postalCode": string, "sortingCode": string, "administrativeArea": string, "locality": string, "sublocality": string, "addressLines": [ string ], "recipients": [ string ], "organization": string } |
फ़ील्ड | |
---|---|
revision |
|
regionCode |
ज़रूरी नहीं. पते के देश/इलाके का CLDR क्षेत्रीय कोड. ज़्यादा जानकारी के लिए, https://cldr.unicode.org/ और https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html पर जाएं. उदाहरण: स्विट्ज़रलैंड के लिए "CH". अगर क्षेत्र का कोड नहीं दिया गया है, तो इसका अनुमान पते से लगाया जाएगा. सबसे अच्छी परफ़ॉर्मेंस के लिए, हमारा सुझाव है कि अगर आपको इलाके का कोड पता है, तो उसे भी शामिल करें. अलग-अलग या दोहराए गए क्षेत्रों की वजह से परफ़ॉर्मेंस खराब हो सकती है. उदाहरण के लिए, अगर |
languageCode |
इनपुट पते में दिया गया भाषा कोड आने वाले समय में इस्तेमाल के लिए रिज़र्व है और आज उसे अनदेखा कर दिया जाता है. एपीआई, पते की सही भाषा में पता दिखाता है. |
postalCode |
ज़रूरी नहीं. पते का पिन कोड. सभी देश पिन कोड का इस्तेमाल नहीं करते या उनके लिए पिन कोड की ज़रूरत नहीं होती. हालांकि, जहां भी इन देशों का इस्तेमाल किया जाता है वहां पते के अन्य हिस्सों के साथ इनकी पुष्टि अलग से की जा सकती है (उदाहरण के लिए, अमेरिका में राज्य/पिन कोड की पुष्टि करना). |
sortingCode |
ज़रूरी नहीं. अतिरिक्त, देश के हिसाब से, क्रम से लगाने का कोड. ज़्यादातर इलाकों में इसका इस्तेमाल नहीं किया जाता. जहां इसका इस्तेमाल किया जाता है वहां वैल्यू या तो "CEDEX" जैसी स्ट्रिंग होती है. इसके बाद, कोई संख्या (जैसे कि "CEDEX 7") या सिर्फ़ एक संख्या होती है. यह "सेक्टर कोड" (जमैका), "डिलीवरी क्षेत्र इंडिकेटर" (मलावी) या "पोस्ट ऑफ़िस इंडिकेटर" (उदाहरण के लिए, आइवरी कोस्ट) को दिखाती है. |
administrativeArea |
ज़रूरी नहीं. सबसे बड़ा प्रशासनिक उपविभाग, जिसका इस्तेमाल किसी देश या क्षेत्र के डाक पतों के लिए किया जाता है. उदाहरण के लिए, यह कोई राज्य, प्रांत, ओब्लास्ट या प्रीफ़ेक्चर हो सकता है. खास तौर पर, स्पेन के लिए यह प्रांत है न कि स्वायत्त समुदाय (जैसे कि "बार्सीलोनिया" न कि "कैटलोनिया"). कई देश डाक पतों में राज्य का इस्तेमाल नहीं करते हैं. उदाहरण के लिए, स्विट्ज़रलैंड में इसे खाली छोड़ देना चाहिए. |
locality |
ज़रूरी नहीं. आम तौर पर, पते के शहर/कस्बे वाले हिस्से का मतलब होता है. उदाहरण: अमेरिका का शहर, आईटी कम्यून, यूनाइटेड किंगडम पोस्ट टाउन. दुनिया के जिन क्षेत्रों में क्षेत्रों की अच्छी तरह से व्याख्या नहीं की गई है या जो इस संरचना में फ़िट नहीं होते हैं, वहां क्षेत्र को खाली छोड़ें और पतालाइन का इस्तेमाल करें. |
sublocality |
ज़रूरी नहीं. पते का मोहल्ला. उदाहरण के लिए, ये आस-पास, नगर, ज़िले हो सकते हैं. |
addressLines[] |
ज़रूरी है. पते के निचले लेवल के बारे में बताने वाली अनस्ट्रक्चर्ड लाइन. |
recipients[] |
कृपया यह फ़ील्ड सेट न करें. फ़िलहाल, पते की पुष्टि करने वाला एपीआई इसका इस्तेमाल नहीं करता है. हालांकि, फ़िलहाल एपीआई इस फ़ील्ड सेट वाले अनुरोधों को अस्वीकार नहीं करेगा, लेकिन जानकारी को खारिज कर दिया जाएगा और जवाब में उसे वापस नहीं किया जाएगा. |
organization |
कृपया यह फ़ील्ड सेट न करें. फ़िलहाल, पते की पुष्टि करने वाला एपीआई इसका इस्तेमाल नहीं करता है. हालांकि, फ़िलहाल एपीआई इस फ़ील्ड सेट वाले अनुरोधों को अस्वीकार नहीं करेगा, लेकिन जानकारी को खारिज कर दिया जाएगा और जवाब में उसे वापस नहीं किया जाएगा. |
LanguageOptions
झलक: यह सुविधा, झलक (प्री-GA) में है. ऐसा हो सकता है कि Pre-GA प्रॉडक्ट और सुविधाएं सीमित तौर पर काम करें. साथ ही, Pre-GA प्रॉडक्ट और सुविधाओं में किए गए बदलाव भी शायद Pre-GA वर्शन के साथ काम न करें. Pre-GA ऑफ़र के लिए Google Maps Platform की सेवा की खास शर्तें लागू होती हैं. ज़्यादा जानकारी के लिए, लॉन्च के चरण की जानकारी देखें.
जवाब में अतिरिक्त जानकारी शामिल करने के लिए, पते की पुष्टि करने वाले एपीआई को चालू करता है.
जेएसओएन के काेड में दिखाना |
---|
{ "returnEnglishLatinAddress": boolean } |
फ़ील्ड | |
---|---|
returnEnglishLatinAddress |
झलक: अंग्रेज़ी में |
ValidationResult
किसी पते की पुष्टि करने से क्या होता है.
जेएसओएन के काेड में दिखाना |
---|
{ "verdict": { object ( |
फ़ील्ड | |
---|---|
verdict |
नतीजों के कुल फ़्लैग |
address |
जियोकोड के विपरीत पते के बारे में जानकारी. |
geocode |
उस जगह और जगह के बारे में जानकारी जहां पते को जियोकोड किया गया. |
metadata |
डिलीवरी से जुड़ी अन्य जानकारी. इस बात की कोई गारंटी नहीं है कि पते की पुष्टि करने वाले एपीआई को भेजे गए हर पते के लिए, |
uspsData |
यूएसपीएस से मिले ज़्यादा डिलीवरी फ़्लैग. सिर्फ़ |
englishLatinAddress |
झलक: यह सुविधा, झलक (प्री-GA) में है. ऐसा हो सकता है कि Pre-GA प्रॉडक्ट और सुविधाएं सीमित तौर पर काम करें. साथ ही, Pre-GA प्रॉडक्ट और सुविधाओं में किए गए बदलाव भी शायद Pre-GA वर्शन के साथ काम न करें. Pre-GA ऑफ़र के लिए Google Maps Platform की सेवा की खास शर्तें लागू होती हैं. ज़्यादा जानकारी के लिए, लॉन्च के चरण की जानकारी देखें. पते का अनुवाद अंग्रेज़ी में किया गया. अनुवाद किए गए पतों को एपीआई इनपुट के तौर पर फिर से इस्तेमाल नहीं किया जा सकता. यह सेवा उन्हें इसलिए देती है, ताकि उपयोगकर्ता मूल रूप से दिए गए पते की पुष्टि की पुष्टि या उसे अस्वीकार करने के लिए, अपनी मूल भाषा का इस्तेमाल कर सकें. अगर पते के किसी हिस्से का अंग्रेज़ी में अनुवाद नहीं है, तो सेवा उस हिस्से को वैकल्पिक भाषा में दिखाती है. इस भाषा में लैटिन स्क्रिप्ट का इस्तेमाल होता है. दूसरी भाषा चुनने का तरीका जानने के लिए यहां देखें. अगर पते के किसी हिस्से का अनुवाद या ट्रांसलिट्रेशन, लैटिन लिपि का इस्तेमाल करने वाली किसी भाषा में नहीं है, तो सेवा उस हिस्से को पते से जुड़ी स्थानीय भाषा में दिखाती है.
ध्यान दें: |
नतीजा
पते की पुष्टि के नतीजे और जियोकोड के बारे में खास जानकारी.
जेएसओएन के काेड में दिखाना |
---|
{ "inputGranularity": enum ( |
फ़ील्ड | |
---|---|
inputGranularity |
इनपुट पते की जानकारी का लेवल. यह इनपुट पते को पार्स करने का नतीजा है और पुष्टि करने के लिए कोई सिग्नल नहीं देता. पुष्टि करने से जुड़े सिग्नल के लिए, नीचे उदाहरण के लिए, अगर इनपुट पते में कोई अपार्टमेंट नंबर शामिल है, तो यहां दिया गया |
validationGranularity |
जानकारी का वह लेवल जिसके लिए एपीआई, पते की पूरी validate कर सकता है. उदाहरण के लिए, पते के हिसाब से कॉम्पोनेंट की पुष्टि का नतीजा |
geocodeGranularity |
यह कभी-कभी ऊपर दिए गए |
addressComplete |
अगर कोई ऐसा टोकन नहीं है जिसे हल न किया गया हो, तो उसे 'पूरा हुआ' के तौर पर मार्क किया जाता है. साथ ही, यह भी माना जाता है कि पते का कोई ऐसा कॉम्पोनेंट मौजूद नहीं है जिसकी उम्मीद न की गई हो या जो मौजूद नहीं है. अगर यह नीति सेट नहीं है, तो इससे पता चलता है कि वैल्यू |
hasUnconfirmedComponents |
पते के कम से कम एक कॉम्पोनेंट को कैटगरी में नहीं बांटा जा सकता या उसकी पुष्टि नहीं की जा सकती. ज़्यादा जानकारी के लिए, |
hasInferredComponents |
पते का कम से कम एक कॉम्पोनेंट जोड़ा गया था (जोड़ा गया), जो इनपुट में शामिल नहीं है. ज़्यादा जानकारी के लिए |
hasReplacedComponents |
पते का कम से कम एक कॉम्पोनेंट बदला गया. ज़्यादा जानकारी के लिए, |
जानकारी का स्तर
किसी पते या जियोकोड के अलग-अलग विवरण. जब किसी पते की जानकारी के स्तर को दिखाने के लिए इसका इस्तेमाल किया जाता है, तो इन वैल्यू से पता चलता है कि वह पता, डाक से भेजे जाने वाले पते की कितनी सटीक पहचान करता है. उदाहरण के लिए, "123 Main Street, Redwood City, CA, 94061" जैसे पते से PREMISE
की पहचान होती है, जबकि "Redwood City, CA, 94061" जैसे पते से LOCALITY
की पहचान होती है. हालांकि, अगर हम रेडवुड सिटी में "123 मेन स्ट्रीट" का जियोकोड खोजने में असमर्थ रहते हैं, तो पता ज़्यादा विस्तृत होने के बावजूद, हो सकता है कि जियोकोड किया गया जियोकोड, LOCALITY
विवरण का स्तर हो.
Enums | |
---|---|
GRANULARITY_UNSPECIFIED |
डिफ़ॉल्ट मान. इस वैल्यू का इस्तेमाल नहीं किया गया है. |
SUB_PREMISE |
बिल्डिंग के लेवल से कम नतीजे, जैसे कि कोई अपार्टमेंट. |
PREMISE |
बिल्डिंग-लेवल का नतीजा. |
PREMISE_PROXIMITY |
ऐसा जियोकोड जो पते के बिल्डिंग-लेवल की जगह का अनुमान लगाता है. |
BLOCK |
पता या जियोकोड, ब्लॉक को दिखाता है. इसे सिर्फ़ उन इलाकों में इस्तेमाल किया जाता है जहां ब्लॉक-लेवल के पते की सुविधा उपलब्ध है. जैसे, जापान. |
ROUTE |
जियोकोड या पता से रास्ते की जानकारी मिलती है, जैसे कि सड़क, सड़क या हाइवे. |
OTHER |
अन्य सभी विस्तृत, जिन्हें एक साथ बकेट में रखा जाता है, क्योंकि वे डिलीवर नहीं किए जा सकते. |
पता
प्रोसेस होने के बाद वाले पते की जानकारी. पोस्ट-प्रोसेसिंग में, पते के गलत स्पेलिंग वाले हिस्सों को ठीक करना, गलत हिस्सों को बदलना, और छूटे हुए हिस्सों का पता लगाना शामिल होता है.
जेएसओएन के काेड में दिखाना |
---|
{ "formattedAddress": string, "postalAddress": { object ( |
फ़ील्ड | |
---|---|
formattedAddress |
प्रोसेस होने के बाद वाला पता, जिसे एक लाइन वाले पते के तौर पर फ़ॉर्मैट किया जाता है. इसे उस इलाके के पते के फ़ॉर्मैट से जुड़े नियमों के मुताबिक बनाया जाता है जहां पता मौजूद है. |
postalAddress |
प्रोसेस होने के बाद का पता, डाक पते के तौर पर दिखाया जाता है. |
addressComponents[] |
बिना क्रम वाली सूची. पुष्टि करने की जानकारी के साथ, फ़ॉर्मैट किए गए और सही किए गए पते के अलग-अलग कॉम्पोनेंट. इससे अलग-अलग कॉम्पोनेंट की पुष्टि की स्थिति के बारे में जानकारी मिलती है. पते के कॉम्पोनेंट किसी खास तरीके से क्रम में नहीं लगाए जाते. सूची में पते के कॉम्पोनेंट के क्रम पर कोई अनुमान न लगाएं. |
missingComponentTypes[] |
ऐसे कॉम्पोनेंट जो सही तरीके से फ़ॉर्मैट किए गए डाक पते में मौजूद होने की उम्मीद थी, लेकिन इनपुट में नहीं मिले और उनका अनुमान नहीं लगाया जा सका. इस तरह के कॉम्पोनेंट |
unconfirmedComponentTypes[] |
ऐसे कॉम्पोनेंट के टाइप जो |
unresolvedTokens[] |
इनपुट में ऐसा कोई भी टोकन जो रिज़ॉल्व नहीं हो सका. यह एक ऐसा इनपुट हो सकता है जिसे पते के मान्य हिस्से के तौर पर पहचाना नहीं जा सका. उदाहरण के लिए, "123235253253 पैसेंजर "123235253253 मेन सेंट, सैन फ़्रांसिस्को, CA, 94105" जैसे इनपुट में, हल न हुए टोकन |
AddressComponent
पते के कॉम्पोनेंट के बारे में बताता है. जैसे, सड़क, शहर या राज्य.
जेएसओएन के काेड में दिखाना |
---|
{ "componentName": { object ( |
फ़ील्ड | |
---|---|
componentName |
इस कॉम्पोनेंट का नाम. |
componentType |
पता कॉम्पोनेंट का टाइप. संभावित प्रकारों की सूची के लिए टेबल 2: Places सेवा से लौटाए गए अतिरिक्त प्रकार देखें. |
confirmationLevel |
इससे पता चलता है कि कॉम्पोनेंट सही है या नहीं. |
inferred |
इससे पता चलता है कि कॉम्पोनेंट, इनपुट का हिस्सा नहीं था, लेकिन हमने इसका अनुमान इस पते के लिए लगाया है. साथ ही, हमें लगता है कि यह कॉम्पोनेंट, पूरे पते के लिए दिया जाना चाहिए. |
spellCorrected |
यह कॉम्पोनेंट के नाम में गलत स्पेलिंग को सही करता है. एपीआई हमेशा स्पेलिंग के एक वैरिएंट से दूसरे में होने वाले बदलावों को फ़्लैग नहीं करता. जैसे, "सेंटर" को "सेंटर" में बदलते समय. यह हमेशा सामान्य स्पेलिंग को फ़्लैग नहीं करता, जैसे कि "एंफ़ीथिएटर Pkwy" को "एंफ़ीथिएटर Pkwy" में बदलते समय. |
replaced |
इससे पता चलता है कि कॉम्पोनेंट का नाम किसी दूसरे पिन कोड से बदल दिया गया है. उदाहरण के लिए, किसी गलत पिन कोड को पते के सही पिन कोड से बदल दिया गया है. यह कोई कॉस्मेटिक बदलाव नहीं है. इनपुट कॉम्पोनेंट को किसी दूसरे में बदला गया है. |
unexpected |
इससे पता चलता है कि किसी इलाके के डाक पते में इसके मौजूद होने की उम्मीद नहीं की जाती है. हमने इसका रखरखाव सिर्फ़ इसलिए किया है, क्योंकि यह इनपुट का हिस्सा था. |
ComponentName
कॉम्पोनेंट के नाम के लिए एक रैपर.
जेएसओएन के काेड में दिखाना |
---|
{ "text": string, "languageCode": string } |
फ़ील्ड | |
---|---|
text |
नाम का टेक्स्ट. उदाहरण के लिए, सड़क के नाम के लिए "5th Avenue" या सड़क के नंबर के लिए "1253". |
languageCode |
BCP-47 भाषा कोड. अगर कॉम्पोनेंट का नाम किसी भाषा से नहीं जुड़ा है, जैसे कि सड़क का नंबर, तो यह फ़ील्ड नहीं दिखेगा. |
ConfirmationLevel
पुष्टि के लेवल के लिए, अलग-अलग संभावित वैल्यू.
Enums | |
---|---|
CONFIRMATION_LEVEL_UNSPECIFIED |
डिफ़ॉल्ट मान. इस वैल्यू का इस्तेमाल नहीं किया गया है. |
CONFIRMED |
हम इस बात की पुष्टि कर पाए हैं कि यह कॉम्पोनेंट मौजूद है और बाकी पते के हिसाब से सही है. |
UNCONFIRMED_BUT_PLAUSIBLE |
इस कॉम्पोनेंट की पुष्टि नहीं की जा सकी. हालांकि, इसके मौजूद होने की संभावना है. उदाहरण के लिए, किसी सड़क पर मौजूद नंबरों की मान्य रेंज में मौजूद कोई सड़क नंबर, जहां किसी घर के नंबर की जानकारी नहीं है. |
UNCONFIRMED_AND_SUSPICIOUS |
इस कॉम्पोनेंट की पुष्टि नहीं हुई थी और हो सकता है कि यह गलत हो. उदाहरण के लिए, कोई ऐसा आस-पड़ोस जो पते के बाकी हिस्से में फ़िट नहीं होता. |
जियोकोड
इसमें उस जगह की जानकारी होती है जहां इनपुट जियोकोड किया गया था.
जेएसओएन के काेड में दिखाना |
---|
{ "location": { object ( |
फ़ील्ड | |
---|---|
location |
इनपुट का जियोकोड किया गया स्थान. पते, अक्षांश/देशांतर निर्देशांक या प्लस कोड के इस्तेमाल के बजाय, जगह के आईडी के इस्तेमाल को प्राथमिकता दी जाती है. ड्राइविंग दिशा-निर्देशों को रूट करते समय या गिनती करते समय निर्देशांकों का इस्तेमाल करने पर, पॉइंट को हमेशा उन निर्देशांकों के सबसे नज़दीकी सड़क पर स्नैप किया जाएगा. यह कोई ऐसी सड़क नहीं हो सकती जो इस जगह तक तुरंत या सुरक्षित तरीके से पहुंच जाए. साथ ही, हो सकता है कि यह सड़क प्रॉपर्टी के ऐक्सेस पॉइंट के पास न हो. इसके अलावा, जब किसी जगह का जियोकोड किया जाता है, तो इस बात की कोई गारंटी नहीं होती कि वापस किया गया पता मूल पते से मेल खाएगा. |
plusCode |
|
bounds |
जियोकोड की गई जगह के दायरे. |
featureSizeMeters |
जियोकोड की गई जगह का साइज़, मीटर में. यह जियोकोड की गई जगह की अस्पष्टता का एक और माप है, लेकिन सिमैंटिक मतलब के बजाय भौतिक आकार में. |
placeId |
उस जगह का प्लेसमेंट आईडी जहां यह इनपुट जियोकोड करता है. जगह के आईडी के बारे में ज़्यादा जानकारी के लिए यहां देखें. |
placeTypes[] |
जगह के वे टाइप जहां इनपुट जियोकोड किया गया. उदाहरण के लिए, |
LatLng
ऐसा ऑब्जेक्ट जो अक्षांश/देशांतर के जोड़े को दिखाता है. डिग्री अक्षांश और डिग्री देशांतर को दर्शाने के लिए, इसे दो जोड़ों के रूप में दिखाया जाता है. जब तक अलग से न बताया गया हो, तब तक यह ऑब्जेक्ट WGS84 मानक के मुताबिक होना चाहिए. वैल्यू, सामान्य रेंज के अंदर होनी चाहिए.
जेएसओएन के काेड में दिखाना |
---|
{ "latitude": number, "longitude": number } |
फ़ील्ड | |
---|---|
latitude |
डिग्री में अक्षांश. यह [-90.0, +90.0] की रेंज में होना चाहिए. |
longitude |
डिग्री में देशांतर. यह [-180.0, +180.0] की रेंज में होना चाहिए. |
PlusCode
प्लस कोड (http://plus.codes) दो फ़ॉर्मैट वाली, जगह की जानकारी का रेफ़रंस होता है: एक ग्लोबल कोड जो 14mx14m (डिग्री का 1/8000वां) या छोटा रेक्टैंगल तय करता है. साथ ही, कंपाउंड कोड, प्रीफ़िक्स की जगह रेफ़रंस ले लेता है.
जेएसओएन के काेड में दिखाना |
---|
{ "globalCode": string, "compoundCode": string } |
फ़ील्ड | |
---|---|
globalCode |
जगह का ग्लोबल (फ़ुल) कोड, जैसे कि "9FWM33GV+HQ", 1/8000 गुणा 1/8000 डिग्री क्षेत्र (~14 गुणा 14 मीटर) को दर्शाता है. |
compoundCode |
जगह का कंपाउंड कोड, जैसे कि "33GV+HQ, Ramberg, Norway" जिसमें ग्लोबल कोड का सफ़िक्स शामिल है और प्रीफ़िक्स को किसी रेफ़रंस इकाई के फ़ॉर्मैट किए गए नाम से बदला गया है. |
व्यूपोर्ट
अक्षांश-देशांतर व्यूपोर्ट, जिसे low
और high
पॉइंट के सामने दो तिरछे तरीके से दिखाया जाता है. व्यूपोर्ट को बंद क्षेत्र माना जाता है, यानी इसमें इसकी सीमा शामिल है. अक्षांश की सीमाएं -90 से 90 डिग्री के बीच होनी चाहिए और देशांतर की सीमाएं -180 से 180 डिग्री के बीच होनी चाहिए. ऐसे कई मामले हैं:
अगर
low
=high
है, तो व्यूपोर्ट में वह एक पॉइंट शामिल होता है.अगर
low.longitude
>high.longitude
है, तो देशांतर की रेंज उलटी होती है (व्यूपोर्ट 180 डिग्री देशांतर की लाइन को पार करता है).अगर
low.longitude
= -180 डिग्री औरhigh.longitude
= 180 डिग्री है, तो व्यूपोर्ट में सभी देशांतर शामिल होते हैं.अगर
low.longitude
= 180 डिग्री औरhigh.longitude
= -180 डिग्री है, तो देशांतर की सीमा खाली होगी.अगर
low.latitude
>high.latitude
है, तो अक्षांश की रेंज खाली होती है.
low
और high
, दोनों में जानकारी भरी जानी चाहिए. साथ ही, दिखाया गया बॉक्स खाली नहीं छोड़ा जा सकता (जैसा कि ऊपर दी गई परिभाषाओं में बताया गया है). व्यूपोर्ट खाली रखने से गड़बड़ी होगी.
उदाहरण के लिए, यह व्यूपोर्ट न्यूयॉर्क शहर को पूरी तरह से घेरता है:
{ "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } }
जेएसओएन के काेड में दिखाना |
---|
{ "low": { object ( |
फ़ील्ड | |
---|---|
low |
ज़रूरी है. व्यूपोर्ट का निचला पॉइंट. |
high |
ज़रूरी है. व्यूपोर्ट का हाई पॉइंट. |
AddressMetadata
पते के लिए मेटाडेटा. इस बात की कोई गारंटी नहीं है कि पते की पुष्टि करने वाले एपीआई को भेजे गए हर पते के लिए, metadata
की जानकारी पूरी तरह से अपने-आप भर जाएगी.
जेएसओएन के काेड में दिखाना |
---|
{ "business": boolean, "poBox": boolean, "residential": boolean } |
फ़ील्ड | |
---|---|
business |
इससे पता चलता है कि यह कारोबार का पता है. अगर यह नीति सेट नहीं है, तो इसका मतलब है कि वैल्यू के बारे में जानकारी नहीं है. |
poBox |
इससे पीओ बॉक्स का पता पता चलता है. अगर यह नीति सेट नहीं है, तो इसका मतलब है कि वैल्यू के बारे में जानकारी नहीं है. |
residential |
इससे पता चलता है कि यह घर का पता है. अगर यह नीति सेट नहीं है, तो इसका मतलब है कि वैल्यू के बारे में जानकारी नहीं है. |
UspsData
पते के लिए USPS डेटा. इस बात की कोई गारंटी नहीं है कि पते की पुष्टि करने वाले एपीआई को भेजे गए हर अमेरिका या पीआर पते के लिए, uspsData
की जानकारी पूरी तरह से अपने-आप भर जाएगी. अगर जवाब के मुख्य हिस्से के तौर पर uspsData का इस्तेमाल किया जाता है, तो हमारा सुझाव है कि आप बैकअप पते के फ़ील्ड को जवाब में इंटिग्रेट करें.
जेएसओएन के काेड में दिखाना |
---|
{
"standardizedAddress": {
object ( |
फ़ील्ड | |
---|---|
standardizedAddress |
यूएसपीएस का स्टैंडर्ड पता. |
deliveryPointCode |
दो अंकों का डिलीवरी पॉइंट कोड |
deliveryPointCheckDigit |
डिलीवरी पॉइंट की जांच करने वाला अंक. यांत्रिक रूप से स्कैन किए गए मेल के लिए, इस नंबर को Delivery_point_barcode के आखिर में जोड़ दिया जाता है. Delivery_point_barcode, DeliveryPointCheckDigit, पिन कोड, और ZIP+4 के सभी अंक एक साथ जोड़ने पर, ऐसी संख्या मिलनी चाहिए जिसे 10 से भाग दिया जा सके. |
dpvConfirmation |
DPV की पुष्टि के लिए संभावित वैल्यू. एक वर्ण दिखाता है या कोई वैल्यू नहीं दिखाता.
|
dpvFootnote |
डिलीवरी पॉइंट की पुष्टि से जुड़े फ़ुटनोट. एक ही स्ट्रिंग में कई फ़ुटनोट एक साथ जुड़े हो सकते हैं.
|
dpvCmra |
इससे पता चलता है कि क्या पता CMRA (कमर्शियल मेल रिसीविंग एजेंसी)--क्लाइंट के लिए मेल पाने वाला निजी कारोबार है. सिर्फ़ एक वर्ण दिखाता है.
|
dpvVacant |
क्या यह जगह खाली है? सिर्फ़ एक वर्ण दिखाता है.
|
dpvNoStat |
क्या यह कोई आंकड़ा नहीं है या सक्रिय पता है? कोई भी आंकड़े वे पते नहीं होते जिन पर लगातार कब्ज़ा नहीं रहता है या जिन पतों पर यूएसपीएस सेवा नहीं देता है. सिर्फ़ एक वर्ण दिखाता है.
|
dpvNoStatReasonCode |
NoStat टाइप को दिखाता है. वजह के कोड को पूर्णांक के तौर पर दिखाता है.
|
dpvDrop |
फ़्लैग से यह पता चलता है कि किसी साइट पर मेल सिर्फ़ एक व्यक्ति को भेजा जा सकता है. सिर्फ़ एक वर्ण दिखाता है.
|
dpvThrowback |
इससे पता चलता है कि मोहल्ले के पते पर मेल नहीं भेजा गया है. सिर्फ़ एक वर्ण दिखाता है.
|
dpvNonDeliveryDays |
फ़्लैग बताता है कि मेल डिलीवरी हफ़्ते के हर दिन नहीं की जाती है. सिर्फ़ एक वर्ण दिखाता है.
|
dpvNonDeliveryDaysValues |
डिलीवर नहीं किए गए दिनों की पहचान करने वाली पूर्णांक. बिट फ़्लैग का इस्तेमाल करके पूछताछ की जा सकती है: 0x40 – रविवार डिलीवरी नहीं करने वाला दिन है 0x20 – सोमवार, डिलीवरी नहीं करने वाला दिन है 0x10 – मंगलवार एक डिलीवरी नहीं करने वाला दिन है 0x08 – बुधवार, डिलीवरी न करने वाला दिन है 0x04 – गुरुवार एक डिलीवरी न करने वाला दिन है 0x02 – शुक्रवार गैर-डिलीवरी दिन है 0x01 |
dpvNoSecureLocation |
फ़्लैग से पता चलता है कि दरवाज़ा ऐक्सेस किया जा सकता है, लेकिन सुरक्षा की वजहों से पैकेज को वहां से नहीं हटाया जाएगा. सिर्फ़ एक वर्ण दिखाता है.
|
dpvPbsa |
इससे पता चलता है कि पता, PBSA रिकॉर्ड से मैच हुआ था. सिर्फ़ एक वर्ण दिखाता है.
|
dpvDoorNotAccessible |
फ़्लैग उन पतों को दिखाता है जहां USPS डाक डिलीवर करने के लिए दरवाज़ा नहीं खोल सकता. सिर्फ़ एक वर्ण दिखाता है.
|
dpvEnhancedDeliveryCode |
इससे यह पता चलता है कि पते के लिए एक से ज़्यादा DPV कोड मान्य हैं. सिर्फ़ एक वर्ण दिखाता है.
|
carrierRoute |
कैरियर का रूट कोड. चार वर्ण का कोड, जिसमें एक अक्षर का प्रीफ़िक्स और तीन डिजिट का रूट डिज़ाइनर होता है. प्रीफ़िक्स:
|
carrierRouteIndicator |
कैरियर के रूट की जानकारी को क्रम से लगाने का इंडिकेटर. |
ewsNoMatch |
डिलीवरी के पते को मैच किया जा सकता है. हालांकि, EWS फ़ाइल से पता चलता है कि एग्ज़ैक्ट मैच वाला ईमेल जल्द ही उपलब्ध होगा. |
postOfficeCity |
मुख्य पोस्ट ऑफ़िस का शहर. |
postOfficeState |
मुख्य डाकघर राज्य. |
abbreviatedCity |
छोटे नाम में शहर. |
fipsCountyCode |
एफ़आईपीएस काउंटी का कोड. |
county |
काउंटी का नाम. |
elotNumber |
यात्रा की बेहतर सुविधा (ईएलओटी) नंबर. |
elotFlag |
eLOT आरोही/घटते हुए फ़्लैग (A/D). |
lacsLinkReturnCode |
LACSLink का रिटर्न कोड. |
lacsLinkIndicator |
LACSLink इंडिकेटर. |
poBoxOnlyPostalCode |
सिर्फ़ पीओ बॉक्स का पिन कोड. |
suitelinkFootnote |
किसी सड़क या ऊंची इमारत के रिकॉर्ड से लेकर सुइट की जानकारी तक, मिलते-जुलते फ़ुटनोट. अगर कारोबार के नाम का मिलान होता है, तो दूसरा नंबर दिखाया जाता है.
|
pmbDesignator |
पीएमबी (प्राइवेट मेल बॉक्स) यूनिट के लिए पदनाम. |
pmbNumber |
पीएमबी (प्राइवेट मेल बॉक्स) नंबर; |
addressRecordType |
पता रिकॉर्ड का वह टाइप जो इनपुट पते से मेल खाता है.
|
defaultAddress |
इस बात का संकेत कि डिफ़ॉल्ट पता मिला था, लेकिन कुछ और पते मौजूद हैं. |
errorMessage |
USPS डेटा वापस पाने के लिए गड़बड़ी का मैसेज. आर्टिफ़िशियल तरीके से बनाए गए पतों का पता लगने की वजह से यूएसपीएस की प्रोसेसिंग निलंबित होने पर, यह अपने-आप भर जाती है. यह गड़बड़ी होने पर, हो सकता है कि USPS डेटा फ़ील्ड में जानकारी न भरी जाए. |
cassProcessed |
इस बात की जानकारी कि अनुरोध को सीएएसएस प्रोसेस किया जा चुका है. |
UspsAddress
इसमें अमेरिका का पता दिखाया गया है.
जेएसओएन के काेड में दिखाना |
---|
{ "firstAddressLine": string, "firm": string, "secondAddressLine": string, "urbanization": string, "cityStateZipAddressLine": string, "city": string, "state": string, "zipCode": string, "zipCodeExtension": string } |
फ़ील्ड | |
---|---|
firstAddressLine |
पते की पहली पंक्ति. |
firm |
फ़र्म का नाम. |
secondAddressLine |
दूसरी पता पंक्ति. |
urbanization |
प्योर्तो रिकन शहरीकरण का नाम. |
cityStateZipAddressLine |
शहर + राज्य + पिन कोड. |
city |
शहर का नाम. |
state |
दो अक्षर वाला राज्य कोड. |
zipCode |
पिन कोड, जैसे कि 10009. |
zipCodeExtension |
चार अंकों का पिन कोड एक्सटेंशन, उदाहरण के लिए, 5023. |