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

ঠিকানা যাচাইকরণ 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 ক্ষেত্রে ইংরেজি ঠিকানাটি ফেরত পাঠায়। বিস্তারিত জানার জন্য নীচে ঠিকানা রূপান্তরের উদাহরণ দেখুন। স্থানীয় ভাষার ঠিকানার প্রতিটি উপাদান যথাসম্ভব ইংরেজিতে রূপান্তরিত হয়। রূপান্তরিত ঠিকানাটি API-তে ইনপুট হিসাবে পুনরায় ব্যবহারযোগ্য নয়।

englishLatinAddress ক্ষেত্রটি address ক্ষেত্রটির মতো একই ঠিকানা প্রোটো ব্যবহার করে, নিম্নলিখিত ব্যতিক্রমগুলি ছাড়া:

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

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

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

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

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

যখন কোনও ভবনের নাম নেই তার উদাহরণ:

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

ঠিকানা রূপান্তর কীভাবে কাজ করে

ঠিকানা যাচাইকরণ 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

ঠিকানা রূপান্তরের উদাহরণ

নিম্নলিখিত উদাহরণটি স্পেনের প্যালাসিও দে লাস ডুয়েনাসের জন্য একটি অনুরোধের বৈধতা প্রতিক্রিয়া দেখায়, যেখানে 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 বৈশিষ্ট্য ব্যবহার করেন। ফলব্যাক পরিস্থিতির কিছু উদাহরণ হল: কোটা অতিক্রম করা, অপ্রত্যাশিত প্রতিক্রিয়া কোড এবং বিলম্ব, অথবা বিদ্যমান আচরণের সাথে তুলনা করলে অপ্রত্যাশিত প্রতিক্রিয়া।

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

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

  • যদি সম্ভব হয়, তাহলে আপনার ব্যবহারের ক্ষেত্রে এবং বৈশিষ্ট্যটি যে নতুন সুযোগগুলি প্রদান করবে সে সম্পর্কে সুনির্দিষ্ট বিবরণ অন্তর্ভুক্ত করুন।

এই প্রতিক্রিয়া বা বৈশিষ্ট্য সম্পর্কে অন্য কোনও প্রশ্নের জন্য, ঠিকানা যাচাইকরণ হটলাইনে একটি ইমেল পাঠান: address-validation-hotline@google.com।