ঠিকানাগুলিকে ইংরেজিতে রূপান্তর করুন

অ্যাড্রেস ভ্যালিডেশন এপিআই ব্যবহার করার সময়, আপনি অনুরোধ করতে পারেন যেন ভ্যালিডেশন রেসপন্সের সাথে ঠিকানাটিকে ইংরেজিতে রূপান্তরিত করেও ফেরত পাঠানো হয়। যখন আপনার সিস্টেমকে ইংরেজি ছাড়া অন্য কোনো ভাষা থেকে আসা ঠিকানা গ্রহণ করার পর ইংরেজি-ভিত্তিক ল্যাটিন অক্ষরে ঠিকানার তথ্য সরবরাহ করতে হয়, তখন এই ফিচারটি ব্যবহার করুন। উদাহরণস্বরূপ:

  • আপনার কোম্পানি সারা বিশ্ব থেকে আসা শিপিং অনুরোধগুলো পূরণ করতে পারে এবং সমস্ত ঠিকানা প্রমিত করার জন্য ইংরেজি ও ইংরেজি-ভিত্তিক ল্যাটিন অক্ষর ব্যবহার করতে পারে।
  • আপনার ব্যবসা এমন কোনো দেশে পণ্য আদান-প্রদান করতে পারে, যে দেশের ভাষা প্রদত্ত ঠিকানার ভাষা থেকে ভিন্ন।

How to return an address in English

ইংরেজি-সমতুল্য উপাদানসহ ঠিকানা যাচাইয়ের অনুরোধ করতে, যাচাইকরণ অনুরোধের মূল অংশে নিম্নলিখিতটি যোগ করুন:

"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 ফিল্ডের ব্যবহৃত Address প্রোটোটিই ব্যবহার করে, তবে নিম্নলিখিত ব্যতিক্রমগুলো রয়েছে:

জাপানি ঠিকানা রূপান্তরের মান উন্নত করুন

জাপানি ঠিকানা ইংরেজিতে রূপান্তর করার জন্য জমা দেওয়ার সময়, ঠিকানার নিম্নলিখিত অংশগুলির মধ্যে একটি স্পেস বা বিভাজক (যেমন, '-') অন্তর্ভুক্ত করুন:

  • ভবন নম্বর (প্রাঙ্গণ) এবং ভবনের নাম ।
  • ভবন নম্বর (প্রাঙ্গণ) এবং উপ-প্রাঙ্গণ / ইউনিট নম্বর ।
  • The building name and subpremise .

উদাহরণস্বরূপ:

  • 東京都渋谷区渋谷 ３−２１−３ 渋谷ストリーム ５階 (প্রস্তাবিত)
  • 東京都渋谷区渋谷３−２１−３渋谷ストリーム５階 (প্রস্তাবিত নয়)

ভবনের নাম না থাকলে তার উদাহরণ:

  • 東京都渋谷区渋谷３丁目２１−３ ５階 (প্রস্তাবিত)
  • 東京都渋谷区渋谷３丁目２１−３−５階 (প্রস্তাবিত)
  • 東京都渋谷区渋谷３丁目２１−３５階 (প্রস্তাবিত নয়)

How address conversion works

অ্যাড্রেস ভ্যালিডেশন এপিআই ঠিকানার প্রতিটি উপাদানে ইংরেজি রূপান্তর প্রয়োগ করে। এর মানে হলো, ঠিকানার 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"

প্রিভিউ রিলিজের জন্য সাপোর্ট অপশন

যদিও গুগল সার্ভিসগুলোর প্রিভিউ সংস্করণ, ফিচার বা কার্যকারিতার জন্য কোনো সহায়তা প্রদান করে না, আমরা এই উন্নয়নমূলক পর্যায়ে থাকা অনুরোধগুলো ক্ষেত্রবিশেষে বিবেচনা করে থাকি।

প্রি-জিএ সংস্করণগুলির জন্য এই সুপারিশগুলি ব্যবহার করুন:

  • প্রি-জিএ ফিচারগুলো গুগল ম্যাপস প্ল্যাটফর্ম এসএলএ- এর আওতাভুক্ত নয়।

  • ফলব্যাক মেকানিজম ব্যবহার করুন, বিশেষ করে যদি আপনি প্রোডাকশন এনভায়রনমেন্টে কোনো প্রি-জিএ ফিচার ব্যবহার করেন। ফলব্যাক পরিস্থিতির কিছু উদাহরণ হলো: কোটা অতিক্রম করা, অপ্রত্যাশিত রেসপন্স কোড ও ল্যাটেন্সি, অথবা বিদ্যমান আচরণের তুলনায় অপ্রত্যাশিত রেসপন্স।

আপনি নতুন ফিচারের অনুরোধ জানাতে বা বিদ্যমান ফিচারে পরিবর্তনের পরামর্শ দিতে ইস্যু ট্র্যাকার ব্যবহার করতে পারেন। আপনার অনুরোধে নিম্নলিখিত বিষয়গুলো অবশ্যই অন্তর্ভুক্ত করবেন:

  • আপনি যে নির্দিষ্ট বৈশিষ্ট্য বা বৈশিষ্ট্যটি যুক্ত দেখতে চান, তার বর্ণনা দিন এবং কেন এটি গুরুত্বপূর্ণ বলে মনে করেন, সেই কারণগুলোও উল্লেখ করুন।

  • সম্ভব হলে, আপনার ব্যবহারের ক্ষেত্র এবং এই ফিচারটির মাধ্যমে সৃষ্ট নতুন সুযোগগুলো সম্পর্কে সুনির্দিষ্ট বিবরণ দিন।

এই মতামত বা ফিচার সম্পর্কিত অন্য কোনো প্রশ্নের জন্য, ইস্যু ট্র্যাকারে একটি বাগ ফাইল করুন।