এই পৃষ্ঠাটি Cloud Translation API অনুবাদ করেছে।

একটি ঠিকানা যাচাই করুন

ঠিকানা যাচাইকরণ API ব্যবহার করে একটি ঠিকানা যাচাই করতে, validateAddress পদ্ধতি (REST) বা ValidateAddress পদ্ধতি (gRPC) কল করুন। এই ডকুমেন্টেশনটি এর উদাহরণগুলির জন্য REST ব্যবহার করে, কিন্তু পদ্ধতিটি gRPC এর সাথে একই রকম।

আপনি একটি ঠিকানা যাচাই করার পরে, আপনি ঐচ্ছিকভাবে provideValidationFeedback পদ্ধতি (REST) বা ProvideValidationFeedback পদ্ধতি (gRPC) কল করে ঠিকানা যাচাইকরণের ফলাফল সম্পর্কে তথ্য ফেরত দিতে পারেন৷ তথ্য এবং উদাহরণের জন্য, ঠিকানা যাচাইকরণ প্রতিক্রিয়া প্রদান দেখুন।

ঠিকানা বৈধতা অনুরোধ

validateAddress পদ্ধতিতে একটি POST অনুরোধ পাঠিয়ে একটি ঠিকানা যাচাই করুন:

https://addressvalidation.googleapis.com/v1:validateAddress?key=YOUR_API_KEY

বৈধ করার ঠিকানা সংজ্ঞায়িত করার অনুরোধে একটি JSON বডি পাস করুন:

curl -X POST -d '{
  "address": {
    "regionCode": "US",
    "locality": "Mountain View",
    "addressLines": ["1600 Amphitheatre Pkwy"]
  }
}' \
-H 'Content-Type: application/json' \
"https://addressvalidation.googleapis.com/v1:validateAddress?key=YOUR_API_KEY"

অনুরোধের অংশে address ক্ষেত্রে, পোস্টাল অ্যাড্রেস টাইপের, addressLines অন্তত একটি এন্ট্রি থাকতে হবে।

regionCode ক্ষেত্রটি ঐচ্ছিক। যদি বাদ দেওয়া হয়, API ঠিকানা থেকে অঞ্চলটি অনুমান করে। যাইহোক, সেরা পারফরম্যান্সের জন্য, আমরা সুপারিশ করি যে আপনি যদি এটি জানেন তবে regionCode অন্তর্ভুক্ত করুন। সমর্থিত অঞ্চলগুলির তালিকার জন্য, সমর্থিত অঞ্চলগুলি দেখুন।
address ক্ষেত্রের মোট দৈর্ঘ্য 280 অক্ষরের মধ্যে সীমাবদ্ধ।

একটি ঠিকানা যাচাই করার সময় ঐচ্ছিকভাবে CASS™ সক্ষম করুন৷

ইউনাইটেড স্টেটস পোস্টাল সার্ভিস® (USPS®) ¹ ঠিকানা বৈধতা প্রদানকারীদের সমর্থন ও প্রত্যয়িত করার জন্য কোডিং সঠিকতা সমর্থন সিস্টেম (CASS™) বজায় রাখে। একটি CASS সার্টিফাইড™ পরিষেবা, যেমন ঠিকানা যাচাইকরণ API, একটি ঠিকানা থেকে অনুপস্থিত তথ্য পূরণ করার, এটিকে মানককরণ করার এবং আপনাকে সবচেয়ে বর্তমান এবং সবচেয়ে সঠিক ঠিকানা দেওয়ার জন্য এটি আপডেট করার ক্ষমতার জন্য নিশ্চিত করা হয়েছে৷

শুধুমাত্র "US" এবং "PR" অঞ্চলের জন্য, আপনি অনুরোধের বডিতে enableUspsCass কে true সেট করে CASS প্রক্রিয়াকরণ সক্ষম করতে পারেন৷

CASS ব্যবহার করার সময় সেরা ফলাফলের জন্য, শহর, রাজ্য এবং জিপ কোড সহ রাস্তা এবং রাস্তার নম্বর অন্তর্ভুক্ত করে এমন একটি ঠিকানা দিন:

{
  "address": {
    "regionCode": "US",
    "locality": "Mountain View",
    "administrativeArea": "CA",
    "postalCode": "94043",
    "addressLines": ["1600 Amphitheatre Pkwy"]
  },
  "enableUspsCass": true
}

আপনি addressLines অ্যারেতে দুটি স্ট্রিং হিসাবে সম্পূর্ণ ঠিকানা নির্দিষ্ট করতে পারেন:

{
  "address": {
    "regionCode": "US",
    "addressLines": ["1600 Amphitheatre Pkwy", "Mountain View, CA, 94043"]
  },
  "enableUspsCass": true
}

ঠিকানা বৈধতা প্রতিক্রিয়া

অনুরোধ সফল হলে, সার্ভার একটি HTTP 200 OK স্ট্যাটাস কোড এবং বৈধ ঠিকানা সম্পর্কে তথ্য সম্বলিত একটি প্রতিক্রিয়া বডি দিয়ে সাড়া দেয়।

প্রতিক্রিয়ার result ক্ষেত্রে একটি ValidationResult অবজেক্ট রয়েছে। এই বস্তুর অন্তর্ভুক্ত:

একটি address ক্ষেত্র, ঠিকানা টাইপ, ঠিকানা সম্পর্কে বিস্তারিত তথ্য রয়েছে।
একটি geocode ক্ষেত্র, জিওকোড টাইপ, ঠিকানার জন্য জিওকোড তথ্য রয়েছে।
দ্রষ্টব্য: address এবং geocode মধ্যে পার্থক্য সম্পর্কে তথ্যের জন্য, ঠিকানা বনাম জিওকোড দেখুন।
একটি verdict ক্ষেত্র, Verdict টাইপের, যেখানে ঠিকানা যাচাইকরণ এবং জিওকোড ফলাফল রয়েছে৷
ঠিকানার মেটাডেটা ধারণ করে AddressMetadata টাইপের একটি metadata ক্ষেত্র।
একটি uspsData ক্ষেত্র, USPSData প্রকারের, যেখানে ঠিকানার জন্য USPS ডেটা থাকে। এই ডেটা শুধুমাত্র মার্কিন যুক্তরাষ্ট্র এবং পুয়ের্তো রিকোর ঠিকানাগুলির জন্য উপলব্ধ৷

কারণ নিম্নলিখিত প্রতিক্রিয়াটিতে addressComplete সেট করা আছে true , প্রতিক্রিয়াটি নির্দেশ করে যে এই ঠিকানাটি সম্পূর্ণ বৈধ, তাই আর কোনো বৈধতার প্রয়োজন নেই। যদি প্রতিক্রিয়া নির্দেশ করে যে ঠিকানার কিছু অংশ অবৈধ, আপনার ব্যবহারকারীকে তাদের ঠিকানা এন্ট্রি পরীক্ষা এবং নিশ্চিত করতে অনুরোধ করুন।

{
  "result": {
    "verdict": {
      "inputGranularity": "PREMISE",
      "validationGranularity": "PREMISE",
      "geocodeGranularity": "PREMISE",
      "addressComplete": true,
      "hasInferredComponents": true
    },
    "address": {
      "formattedAddress": "1600 Amphitheatre Parkway, Mountain View, CA 94043-1351, USA",
      "postalAddress": {
        "regionCode": "US",
        "languageCode": "en",
        "postalCode": "94043-1351",
        "administrativeArea": "CA",
        "locality": "Mountain View",
        "addressLines": [
          "1600 Amphitheatre Pkwy"
        ]
      },
      "addressComponents": [
        {
          "componentName": {
            "text": "1600",
            "languageCode": "en"
          },
          "componentType": "street_number",
          "confirmationLevel": "CONFIRMED"
        },
        {
          "componentName": {
            "text": "Amphitheatre Parkway",
            "languageCode": "en"
          },
          "componentType": "route",
          "confirmationLevel": "CONFIRMED"
        },
        {
          "componentName": {
            "text": "Mountain View",
            "languageCode": "en"
          },
          "componentType": "locality",
          "confirmationLevel": "CONFIRMED"
        },
        {
          "componentName": {
            "text": "USA",
            "languageCode": "en"
          },
          "componentType": "country",
          "confirmationLevel": "CONFIRMED"
        },
        {
          "componentName": {
            "text": "94043"
          },
          "componentType": "postal_code",
          "confirmationLevel": "CONFIRMED",
          "inferred": true
        },
        {
          "componentName": {
            "text": "CA",
            "languageCode": "en"
          },
          "componentType": "administrative_area_level_1",
          "confirmationLevel": "CONFIRMED",
          "inferred": true
        },
        {
          "componentName": {
            "text": "1351"
          },
          "componentType": "postal_code_suffix",
          "confirmationLevel": "CONFIRMED",
          "inferred": true
        }
      ]
    },
    "geocode": {
      "location": {
        "latitude": 37.4223878,
        "longitude": -122.0841877
      },
      "plusCode": {
        "globalCode": "849VCWC8+X8"
      },
      "bounds": {
        "low": {
          "latitude": 37.4220699,
          "longitude": -122.084958
        },
        "high": {
          "latitude": 37.4226618,
          "longitude": -122.0829302
        }
      },
      "featureSizeMeters": 116.538734,
      "placeId": "ChIJj38IfwK6j4ARNcyPDnEGa9g",
      "placeTypes": [
        "premise"
      ]
    },
    "metadata": {
      "business": false,
      "poBox": false
    },
    "uspsData": {
      "standardizedAddress": {
        "firstAddressLine": "1600 AMPHITHEATRE PKWY",
        "cityStateZipAddressLine": "MOUNTAIN VIEW CA 94043-1351",
        "city": "MOUNTAIN VIEW",
        "state": "CA",
        "zipCode": "94043",
        "zipCodeExtension": "1351"
      },
      "deliveryPointCode": "00",
      "deliveryPointCheckDigit": "0",
      "dpvConfirmation": "Y",
      "dpvFootnote": "AABB",
      "dpvCmra": "N",
      "dpvVacant": "N",
      "dpvNoStat": "Y",
      "carrierRoute": "C909",
      "carrierRouteIndicator": "D",
      "postOfficeCity": "MOUNTAIN VIEW",
      "postOfficeState": "CA",
      "fipsCountyCode": "085",
      "county": "SANTA CLARA",
      "elotNumber": "0103",
      "elotFlag": "A",
      "addressRecordType": "S"
    }
  },
  "responseId": "de22bed8-7f52-44cb-8526-faceac57150a"
}

একটি আপডেট ঠিকানা যাচাই করুন

কিছু ক্ষেত্রে, আপনাকে একটি ঠিকানার জন্য ঠিকানা যাচাইকরণ API এ একাধিক কল করতে হতে পারে। উদাহরণস্বরূপ, ব্যবহারকারী প্রথম বৈধতার ফলাফল দেখার পরে তাদের ঠিকানায় পরিবর্তন বা সংশোধন করতে পারে। আপনি তারপর আপডেট করা ঠিকানায় একটি দ্বিতীয় বৈধতা সঞ্চালন.

প্রতিটি ঠিকানা যাচাইকরণ API কল প্রতিক্রিয়ার responseId ক্ষেত্রে একটি অনন্য মান প্রদান করে। আপনি যাচাই করার চেষ্টা করছেন এমন একটি ঠিকানা যদি পুনরায় যাচাই করার প্রয়োজন হয়, তাহলে ঠিকানা যাচাইকরণ API-এ সমস্ত ফলো-আপ অনুরোধের জন্য previousResponseId ক্ষেত্রের প্রথম বৈধতা প্রতিক্রিয়া থেকে responseId পাস করুন।

নতুন অনুরোধে previousResponseId ক্ষেত্রটি অন্তর্ভুক্ত করে, আপনি API-এর সামগ্রিক নির্ভুলতা উন্নত করতে আমাদের সাহায্য করতে পারেন।

উদাহরণস্বরূপ, উপরে দেখানো প্রতিক্রিয়া responseId ক্ষেত্র অন্তর্ভুক্ত করে:

  "responseId": "de22bed8-7f52-44cb-8526-faceac57150a"

তারপরে আপনি 1600 থেকে 1500 পর্যন্ত রাস্তার নম্বরে পরিবর্তন করে ঠিকানাটি পুনরায় যাচাই করতে চান। আপনি যখন ঠিকানাটি পুনরায় যাচাই করবেন, প্রথম প্রতিক্রিয়া থেকে responseId মান সহ previousResponseId ক্ষেত্রটি অন্তর্ভুক্ত করুন:

{
  "address": {
    "regionCode" : "US",
    "locality" : "Mountain View",
    "addressLines" : ["1500 Amphitheatre Pkwy"]
  },
  "previousResponseId": "de22bed8-7f52-44cb-8526-faceac57150a"
}

CASS ব্যবহার করে একটি অনুরোধের জন্য:

{
  "address": {
    "regionCode" : "US",
    "locality" : "Mountain View",
    "addressLines" : ["1500 Amphitheatre Pkwy"]
  },
  "previousResponseId": "de22bed8-7f52-44cb-8526-faceac57150a",
  "enableUspsCass": true

}

প্রতিটি পরবর্তী কলের ফলাফল responseId ক্ষেত্রে একটি নতুন মান প্রদান করে। যাইহোক, ঠিকানার আপডেটের জন্য পরবর্তী সমস্ত কলগুলিতে previousResponseId ক্ষেত্রের প্রথম প্রতিক্রিয়া থেকে responseId মান পাস করা চালিয়ে যান।

ত্রুটি পরিচালনা

ঠিকানা যাচাইকরণ API একটি পদ্ধতি কলের প্রতিক্রিয়ার অংশ হিসাবে ত্রুটি বার্তা প্রদান করে। উদাহরণস্বরূপ, যদি আপনি অনুরোধ থেকে API কী বাদ দেন, পদ্ধতিটি ফিরে আসে:

{
  "error": {
    "code": 403,
    "message": "The request is missing a valid API key.",
    "status": "PERMISSION_DENIED"
  }
}

যদি আপনি একটি প্রয়োজনীয় বডি প্যারামিটার বাদ দেন, যেমন addressLines , পদ্ধতিটি ফিরে আসে:

{
  "error": {
    "code": 400,
    "message": "Address lines missing from request.",
    "status": "INVALID_ARGUMENT"
  }
}

ত্রুটি এবং ত্রুটি পরিচালনা সম্পর্কে আরও তথ্যের জন্য, ত্রুটিগুলি দেখুন।

Google মানচিত্র প্ল্যাটফর্ম হল ইউনাইটেড স্টেটস পোস্টাল সার্ভিস® এর একটি অ-এক্সক্লুসিভ লাইসেন্সধারী। নিম্নলিখিত ট্রেডমার্ক(গুলি) ইউনাইটেড স্টেটস পোস্টাল সার্ভিস® এর মালিকানাধীন এবং অনুমতি নিয়ে ব্যবহার করা হয়: ইউনাইটেড স্টেটস পোস্টাল সার্ভিস®, CASS™, CASS সার্টিফাইড™। ↩