Address Validation API का इस्तेमाल करते समय, पुष्टि के जवाब में पते को अंग्रेज़ी में बदलकर दिखाने का अनुरोध किया जा सकता है. इस सुविधा का इस्तेमाल तब करें, जब आपके सिस्टम को अंग्रेज़ी के अलावा किसी दूसरी भाषा में दिया गया पता, अंग्रेज़ी के आधार पर बने लैटिन वर्णों में बदलना हो. उदाहरण के लिए:
- ऐसा हो सकता है कि आपकी कंपनी दुनिया भर से शिपिंग के अनुरोधों को पूरा करे. साथ ही, सभी पतों को स्टैंडर्ड बनाने के लिए, अंग्रेज़ी और अंग्रेज़ी पर आधारित लैटिन वर्णों का इस्तेमाल करे.
- ऐसा हो सकता है कि आपका कारोबार, उस देश में शिपिंग करता हो जहां दी गई भाषा के बजाय, कोई दूसरी भाषा बोली जाती हो.
अंग्रेज़ी में पता लौटाने का तरीका
अंग्रेज़ी के बराबर के कॉम्पोनेंट के साथ पते की पुष्टि का अनुरोध करने के लिए, पुष्टि के अनुरोध के मुख्य हिस्से में ये चीज़ें जोड़ें:
"languageOptions": { "returnEnglishLatinAddress": "true" }
यहां दिए गए उदाहरण में, प्राडो म्यूज़ियम के पते की पुष्टि करते समय, अंग्रेज़ी के कॉम्पोनेंट का अनुरोध किया गया है:
curl -X POST -d '{
"address": {
"region_code" : "ES",
"address_lines": ["C. de Ruiz de Alarcón, 23, 28014 Madrid, Spain"],
},
"languageOptions": {returnEnglishLatinAddress: true}
}' \
-H 'Content-Type: application/json' \
-H 'X-Goog-Api-Key: API_KEY' \
'https://addressvalidation.googleapis.com/v1:validateAddress'
जवाब में, englishLatinAddress फ़ील्ड में अंग्रेज़ी में पता दिखता है. ज़्यादा जानकारी के लिए, यहां पते के कन्वर्ज़न का उदाहरण देखें. स्थानीय भाषा में दिखाए गए पते के हर कॉम्पोनेंट को, अंग्रेज़ी में सबसे बेहतर तरीके से बदला जाता है. बदले गए पते को एपीआई के इनपुट के तौर पर फिर से इस्तेमाल नहीं किया जा सकता.
englishLatinAddress फ़ील्ड में उसी पते का इस्तेमाल किया जाता है जिसका इस्तेमाल address फ़ील्ड में किया जाता है. हालांकि, इन मामलों में ऐसा नहीं होता:
ConfirmationLevelफ़ील्ड मौजूद नहीं हैunconfirmedComponentTypesफ़ील्ड मौजूद नहीं है
पते के कन्वर्ट होने की सुविधा कैसे काम करती है
Address Validation API, पते के हर कॉम्पोनेंट पर अंग्रेज़ी में बदलाव करता है. इसका मतलब है कि पते के administrative_area, locality, और अन्य घटकों को अलग-अलग माना जाता है. पते के कॉम्पोनेंट की सूची देखने के लिए, रेफ़रंस दस्तावेज़ में AddressComponent देखें.
यहां दिए गए डायग्राम में दिखाया गया है कि Calle Dueñas, 5, 41003 Sevilla, España पते के लिए, अंग्रेज़ी में बदला गया पता कैसा दिखेगा.
अंग्रेज़ी में कन्वर्ज़न के लिए जिन कॉम्पोनेंट का आकलन किया जाता है उनके लिए, यह सेवा नीचे दिए गए सेक्शन में बताई गई प्रोसेस का इस्तेमाल करती है.
जहां भी हो सके, पूरी तरह से अनुवाद की गई अंग्रेज़ी का इस्तेमाल करता है
हो सकता है कि पते के कुछ कॉम्पोनेंट का पूरा अनुवाद किया गया वर्शन इस्तेमाल के लिए उपलब्ध हो.
उदाहरण के लिए, स्पैनिश में España को Spain में बदल दिया जाएगा. ऐसे में, सेवा अंग्रेज़ी वर्शन का इस्तेमाल करती है. आम तौर पर, ऐसा country और administrative_area_level_1 जैसे बड़े पते के कॉम्पोनेंट के लिए होता है.
अगर अंग्रेज़ी उपलब्ध नहीं है, तो स्थानीय भाषा को लैटिन में बदलकर इस्तेमाल करता है
लैटिनाइज़ेशन का मतलब है कि ट्रांसक्रिप्शन का इस्तेमाल करके, स्थानीय भाषा को लैटिन स्क्रिप्ट में बदलना.
- अगर पते की स्थानीय भाषा में लैटिन वर्ण सेट का इस्तेमाल किया जाता है और पते के कॉम्पोनेंट के लिए अंग्रेज़ी में कोई मिलता-जुलता शब्द मौजूद नहीं है, तो यह सेवा स्थानीय भाषा के उन वर्णों को बदल देती है जो अंग्रेज़ी के नहीं हैं.
उदाहरण के लिए,
Calle DueñasकोCalle Duenasमें बदला जाता है, जहां ñ को n से बदला जाता है. - अगर पते की स्थानीय भाषा में, लैटिन-आधारित वर्ण सेट का इस्तेमाल नहीं किया जाता है और पते के कॉम्पोनेंट के लिए अंग्रेज़ी में कोई मिलता-जुलता शब्द मौजूद नहीं है, तो सेवा स्थानीय भाषा के लैटिन वर्शन का इस्तेमाल करती है. हालांकि, ऐसा तब ही होता है, जब स्थानीय भाषा का लैटिन वर्शन उपलब्ध हो.
उदाहरण के लिए, जैपनीज़ कन्वर्ज़न से जैपनीज़ का रोमनाइज़ेशन मिलता है.
अंग्रेज़ी और लैटिन भाषा के अलावा किसी और भाषा के वर्णों को अंग्रेज़ी के आधार पर बने लैटिन वर्णों से बदल दिया जाता है. उदाहरण के लिए: ３丁目 को 3-chome में बदल दिया जाता है.
- ध्यान दें कि झलक देखने की सुविधा के लिए, जैपनीज़ भाषा अभी चालू नहीं है
- अगर भाषा का लैटिन वर्शन उपलब्ध नहीं है, तो कॉम्पोनेंट को स्थानीय भाषा में दिखाया जाता है.
अंग्रेज़ी के बजाय लैटिन वर्णों का इस्तेमाल करता है
अंग्रेज़ी के अलावा किसी और भाषा के लैटिन वर्णों को, अंग्रेज़ी के उन वर्णों से बदल दिया जाता है जो उनसे मिलते-जुलते हों. उदाहरण के लिए, नीचे दिए गए हर वर्ण को "o" वर्ण से बदल दिया जाएगा: ð, ò, ó, ô, õ, ö, ø, ō, ŏ, ő, ơ, ṍ, ṏ, ṑ, ṓ, ọ, ỏ, ố, ồ, ổ, ỗ, ộ, ớ, ờ, ở, ỡ, और ợ. उदाहरण के लिए:
Calle de Ruiz de Alarcón को Calle de Ruiz de Alarcon में बदल दिया गया
पते के कन्वर्ज़न का उदाहरण
नीचे दिए गए उदाहरण में, स्पेन के Palacio de las Dueñas के लिए किए गए अनुरोध की पुष्टि का जवाब दिखाया गया है. इसमें englishLatinAddress को बोल्ड किया गया है. इस अनुरोध में, इनपुट में languageOptions पैरामीटर के फ़ील्ड returnEnglishLatinAddress का इस्तेमाल किया गया है.
"result": { "verdict": { "inputGranularity": "PREMISE", "validationGranularity": "PREMISE", "geocodeGranularity": "PREMISE", "addressComplete": true, "hasInferredComponents": true }, "address": { "formattedAddress": "Calle Dueñas, 5, 41003 Sevilla, España", "postalAddress": { "regionCode": "ES", "languageCode": "es", "postalCode": "41003", "administrativeArea": "Sevilla", "locality": "Sevilla", "addressLines": [ "C. Dueñas, 5" ] }, "addressComponents": [ { "componentName": { "text": "Calle Dueñas", "languageCode": "es" }, "componentType": "route", "confirmationLevel": "CONFIRMED" }, { "componentName": { "text": "5", "languageCode": "es" }, "componentType": "street_number", "confirmationLevel": "CONFIRMED" }, { "componentName": { "text": "41003" }, "componentType": "postal_code", "confirmationLevel": "CONFIRMED" }, { "componentName": { "text": "Sevilla", "languageCode": "es" }, "componentType": "locality", "confirmationLevel": "CONFIRMED" }, { "componentName": { "text": "España", "languageCode": "es" }, "componentType": "country", "confirmationLevel": "CONFIRMED" }, { "componentName": { "text": "Sevilla", "languageCode": "es" }, "componentType": "administrative_area_level_2", "confirmationLevel": "CONFIRMED", "inferred": true } ] }, "geocode": { "location": { "latitude": 37.394849, "longitude": -5.9893604 }, "plusCode": { "globalCode": "8C9P92V6+W7" }, "bounds": { "low": { "latitude": 37.3948098, "longitude": -5.9894249 }, "high": { "latitude": 37.3948882, "longitude": -5.9893025 } }, "featureSizeMeters": 7.174035, "placeId": "ChIJzRDYbgRsEg0RDDgHlF80UoI", "placeTypes": [ "premise" ] }, "metadata": { "business": true, "residential": false }, "englishLatinAddress": { "formattedAddress": "Calle Duenas, 5, 41003 Seville, Spain", "postalAddress": { "regionCode": "ES", "languageCode": "en", "postalCode": "41003", "administrativeArea": "Seville", "locality": "Seville", "addressLines": [ "C. Duenas, 5" ] }, "addressComponents": [ { "componentName": { "text": "Calle Duenas", "languageCode": "es" }, "componentType": "route", }, { "componentName": { "text": "5", "languageCode": "es" }, "componentType": "street_number", }, { "componentName": { "text": "41003" }, "componentType": "postal_code", }, { "componentName": { "text": "Seville", "languageCode": "en" }, "componentType": "locality", }, { "componentName": { "text": "Spain", "languageCode": "en" }, "componentType": "country", }, { "componentName": { "text": "Seville", "languageCode": "en" }, "componentType": "administrative_area_level_2", "inferred": true } ] } }, "responseId": "e874d263-7d0d-413f-9213-119a784765ed"
झलक वाली रिलीज़ के लिए सहायता के विकल्प
Google, सेवाओं के झलक वाले वर्शन, सुविधाओं या फ़ंक्शन के लिए सहायता नहीं देता. हालांकि, हम इन सेवाओं के डेवलपमेंट के अलग-अलग चरणों में, हर मामले के हिसाब से अनुरोधों पर विचार करते हैं.
GA से पहले के वर्शन के लिए, इन सुझावों का इस्तेमाल करें:
GA से पहले की सुविधाएं, Google Maps Platform के एसएलए के दायरे में नहीं आती हैं.
फ़ॉलबैक मैकेनिज्म का इस्तेमाल करें. ऐसा खास तौर पर तब करें, जब किसी प्रोडक्शन एनवायरमेंट में, GA से पहले की सुविधा का इस्तेमाल किया जा रहा हो. फ़ॉलबैक की स्थितियों के कुछ उदाहरण: कोटा खत्म हो गया है, रिस्पॉन्स कोड और इंतज़ार का समय अनचाहा है या मौजूदा व्यवहार की तुलना में अनचाहे रिस्पॉन्स मिले हैं.
नई सुविधाओं का अनुरोध करने या मौजूदा सुविधाओं में बदलाव करने का सुझाव देने के लिए, समस्या ट्रैकर का इस्तेमाल किया जा सकता है. अपने अनुरोध में यह जानकारी ज़रूर शामिल करें:
उस खास सुविधा या व्यवहार के बारे में बताएं जिसे आपको जोड़ना है. साथ ही, बताएं कि आपको यह सुविधा क्यों ज़रूरी है.
अगर हो सके, तो इस्तेमाल के उदाहरण और उन नए अवसरों के बारे में खास जानकारी शामिल करें जिनके लिए इस सुविधा का इस्तेमाल किया जा सकता है.
इस फ़ीडबैक या सुविधाओं के बारे में किसी भी अन्य सवाल के लिए, पते की पुष्टि करने वाली हॉटलाइन पर ईमेल भेजें: address-validation-hotline@google.com.