ঠিকানা যাচাইকরণ API ব্যবহার করার সময়, আপনি অনুরোধ করতে পারেন যে একটি বৈধতা প্রতিক্রিয়া ইংরেজিতে রূপান্তরিত ঠিকানাটিও ফেরত দেয়। এই বৈশিষ্ট্যটি ব্যবহার করুন যখন আপনার সিস্টেমকে ইংরেজি-ভিত্তিক ল্যাটিন অক্ষরে ঠিকানা তথ্য প্রদান করার প্রয়োজন হয় যখন একটি অ-ইংরেজি ভাষায় উদ্ভূত ঠিকানা গ্রহণ করা হয়। এই ক্ষেত্রে:
- আপনার কোম্পানী সারা বিশ্ব থেকে শিপিং অনুরোধ পূরণ করতে পারে এবং সমস্ত ঠিকানা প্রমিত করতে ইংরেজি এবং ইংরেজি-ভিত্তিক ল্যাটিন অক্ষর ব্যবহার করতে পারে।
- আপনার ব্যবসা এমন একটি দেশে এবং সেখান থেকে চালান পরিচালনা করতে পারে যেটি প্রদত্ত ঠিকানার ভাষার চেয়ে ভিন্ন ভাষা ব্যবহার করে।
কিভাবে ইংরেজিতে একটি ঠিকানা ফেরত দিতে হয়
অন্তর্ভুক্ত ইংরেজি-সমতুল্য উপাদানগুলির সাথে একটি ঠিকানা যাচাইকরণের অনুরোধ করতে, যাচাইকরণ অনুরোধের বডিতে নিম্নলিখিতগুলি যুক্ত করুন:
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 ক্ষেত্রের ইংরেজি ঠিকানা প্রদান করে। বিস্তারিত জানার জন্য নীচের ঠিকানা রূপান্তর উদাহরণ দেখুন. প্রত্যাবর্তিত স্থানীয় ভাষার ঠিকানার প্রতিটি উপাদান যতটা সম্ভব ইংরেজিতে রূপান্তরিত হয়। রূপান্তরিত ঠিকানাটি API এ একটি ইনপুট হিসাবে পুনরায় ব্যবহারযোগ্য নয়।
englishLatinAddress ফিল্ড একই Address প্রোটো ব্যবহার করে যেমন address ফিল্ড ব্যবহার করে, নিম্নলিখিত ব্যতিক্রমগুলি সহ:
-
ConfirmationLevelক্ষেত্র নেই - কোন
unconfirmedComponentTypesক্ষেত্র
ঠিকানা রূপান্তর কিভাবে কাজ করে
ঠিকানা যাচাইকরণ 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 Alarcon হয়ে ওঠে 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"