पते की पुष्टि करने वाले एपीआई का इस्तेमाल करते समय, यह अनुरोध किया जा सकता है कि पुष्टि करने वाले रिस्पॉन्स से पते को अंग्रेज़ी में बदला भी जाए. इस सुविधा का इस्तेमाल तब करें, जब आपके सिस्टम को किसी गैर-अंग्रेज़ी भाषा में मूल पता पाने वाला पता अंग्रेज़ी-आधारित लैटिन वर्णों में देना ज़रूरी हो. उदाहरण के लिए:
- आपकी कंपनी दुनिया भर के शिपिंग अनुरोधों को पूरा कर सकती है. साथ ही, सभी पतों के स्टैंडर्ड तय करने के लिए, अंग्रेज़ी और अंग्रेज़ी वाले लैटिन वर्णों का इस्तेमाल कर सकती है.
- ऐसा हो सकता है कि आपका कारोबार ऐसे देश से भेजे जाने वाले और वहां से भेजे जाने वाले शिपमेंट को मैनेज करता हो जहां की भाषा, दिए गए पते की भाषा से अलग हो.
पता वापस करने का तरीका अंग्रेज़ी में बताएं
अंग्रेज़ी में मिलते-जुलते कॉम्पोनेंट शामिल करके, पते की पुष्टि का अनुरोध करने के लिए, पुष्टि के अनुरोध के मुख्य हिस्से में यह जोड़ें:
languageOptions: { returnEnglishLatinAddress: "true" }.
इस उदाहरण में, प्राडो म्यूज़ियम के पते की पुष्टि करते समय, अंग्रेज़ी वाले कॉम्पोनेंट का अनुरोध किया गया है:
curl -X POST -d '{
"regionCode" : ["ES"],
"addressLines": ["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丁目 बदलकर 3-चोम हो जाता है.
- ध्यान दें कि जैपनीज़ में झलक देखने की सुविधा अभी तक उपलब्ध नहीं है
- अगर भाषा का लैटिन भाषा में अनुवाद करने वाला वर्शन उपलब्ध नहीं है, तो कॉम्पोनेंट को स्थानीय भाषा में दिखाया जाता है.
लैटिन वर्णों को अंग्रेज़ी में नहीं छोड़ता है
अगर कोई लैटिन वर्ण अंग्रेज़ी में नहीं है, तो उसे उनके अंग्रेज़ी वर्ण से बदल दिया जाता है. उदाहरण के लिए, नीचे दिए गए हर वर्ण को "o": ò, ò, ó, ô, ios, ö, ø, ō, ø, ø, Customer, ṍ, ṏ, ṑ, ṓ, ọ, ỏ, ỡ ỡ ổ ổ, ợ जैसे वर्ण से जगह के तौर पर इस्तेमाल किया जाएगा. उदाहरण के लिए:
काले दे रुइज़ दे आलारकॉन, कैले दे रुइज़ दे आलारकॉन बन गया
पते के कन्वर्ज़न का उदाहरण
नीचे दिए गए उदाहरण में, स्पेन के 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"