ঠিকানা যাচাইকরণ 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 proto ব্যবহার করে যেমন 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丁目 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"
প্রিভিউ রিলিজের জন্য সমর্থন বিকল্প
যদিও Google পূর্বরূপ সংস্করণ, বৈশিষ্ট্য, বা পরিষেবাগুলির কার্যকারিতার জন্য সমর্থন প্রদান করে না, আমরা এই বিকাশমূলক পর্যায়ে অনুরোধগুলি কেস-বাই-কেস ভিত্তিতে বিবেচনা করি।
প্রাক-GA সংস্করণের জন্য এই সুপারিশগুলি ব্যবহার করুন:
প্রাক-GA বৈশিষ্ট্যগুলি Google মানচিত্র প্ল্যাটফর্ম SLA দ্বারা আচ্ছাদিত নয়৷
ফলব্যাক মেকানিজম ব্যবহার করুন, বিশেষ করে যদি আপনি প্রোডাকশন পরিবেশে একটি প্রাক-GA বৈশিষ্ট্য ব্যবহার করেন। ফলব্যাক পরিস্থিতির কিছু উদাহরণ হল: বিদ্যমান আচরণের তুলনায় কোটা অতিক্রম করা, অপ্রত্যাশিত প্রতিক্রিয়া কোড এবং বিলম্ব বা অপ্রত্যাশিত প্রতিক্রিয়া।
আপনি ইস্যু ট্র্যাকার ব্যবহার করে নতুন বৈশিষ্ট্যের অনুরোধ করতে পারেন বা বিদ্যমান বৈশিষ্ট্যগুলিতে পরিবর্তনের পরামর্শ দিতে পারেন। আপনার অনুরোধে নিম্নলিখিতগুলি অন্তর্ভুক্ত করতে ভুলবেন না:
আপনি যে নির্দিষ্ট বৈশিষ্ট্য বা আচরণ যোগ করতে চান তা বর্ণনা করুন, সেইসাথে আপনি যে কারণে এটি গুরুত্বপূর্ণ বলে মনে করেন তা বর্ণনা করুন।
যদি সম্ভব হয়, আপনার ব্যবহারের ক্ষেত্রে এবং বৈশিষ্ট্যটি যে নতুন সুযোগগুলির জন্য অনুমতি দেবে সে সম্পর্কে নির্দিষ্ট বিবরণ অন্তর্ভুক্ত করুন।
এই ফিডব্যাক বা ফিচারের অন্য কোন প্রশ্নের জন্য, ঠিকানা যাচাইকরণ হটলাইনে একটি ইমেল পাঠান: address-validation-hotline@google.com।