ঠিকানা যাচাইকরণ API ক্লায়েন্ট লাইব্রেরি উদাহরণ

নিম্নলিখিত পরিষেবাগুলিতে কল করার জন্য ঠিকানা যাচাইকরণ API ক্লায়েন্ট লাইব্রেরিগুলি কীভাবে ব্যবহার করবেন তার উদাহরণ এই পৃষ্ঠাটিতে রয়েছে:

• validateAddress
• provideValidationFeedback

ক্লায়েন্ট লাইব্রেরি ইনস্টল করুন

ইনস্টলেশন নির্দেশাবলীর জন্য ঠিকানা যাচাইকরণ API ক্লায়েন্ট লাইব্রেরি দেখুন।

প্রমাণীকরণ

আপনি যখন ক্লায়েন্ট লাইব্রেরি ব্যবহার করেন, আপনি প্রমাণীকরণের জন্য অ্যাপ্লিকেশন ডিফল্ট শংসাপত্র (ADC) ব্যবহার করেন। ADC সেট আপ সম্পর্কে তথ্যের জন্য, অ্যাপ্লিকেশন ডিফল্ট শংসাপত্রের জন্য প্রমাণপত্র সরবরাহ করুন দেখুন। ক্লায়েন্ট লাইব্রেরির সাথে ADC ব্যবহার সম্পর্কে তথ্যের জন্য, ক্লায়েন্ট লাইব্রেরি ব্যবহার করে প্রমাণীকরণ দেখুন।

আপনি ক্লায়েন্ট লাইব্রেরিতে প্রমাণীকরণ করতে API কী ব্যবহার করতে পারেন, উদাহরণস্বরূপ:

using Google.Maps.AddressValidation.V1;
using Google.Api.Gax.Grpc;
using Grpc.Core;
...
// Create settings to pass the API key as a header in every request.
var apiHeader = CallSettings.FromHeader("X-Goog-Api-Key", "API_KEY");
var defaultSettings = AddressValidationSettings.GetDefault();
var settings = new AddressValidationSettings
{
    ValidateAddressSettings = defaultSettings.ValidateAddressSettings.MergedWith(apiHeader),
    ProvideValidationFeedbackSettings = defaultSettings.ProvideValidationFeedbackSettings.MergedWith(apiHeader)
};
// Create a client builder with the custom settings.
AddressValidationClientBuilder builder = new AddressValidationClientBuilder
{
    Settings = settings,
    // Use SslCredentials to create a secure channel for API key authentication.
    ChannelCredentials = new SslCredentials()
};
AddressValidationClient client = await builder.BuildAsync();

আপনি যখন আপনার অ্যাপ্লিকেশানগুলিতে API কীগুলি ব্যবহার করেন, তখন নিশ্চিত করুন যে সেগুলি স্টোরেজ এবং ট্রান্সমিশনের সময় সুরক্ষিত রাখা হয়েছে৷ আপনার API কী সর্বজনীনভাবে প্রকাশ করলে আপনার অ্যাকাউন্টে অপ্রত্যাশিত চার্জ হতে পারে।

এই পৃষ্ঠার উদাহরণগুলি অ্যাপ্লিকেশন ডিফল্ট শংসাপত্র ব্যবহার করে৷

উদাহরণ

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

ক্লায়েন্ট লাইব্রেরি ব্যবহার করে কিভাবে validateAddress কল করতে হয় তার একটি উদাহরণ নিচে দেওয়া হল।

using Google.Maps.AddressValidation.V1;
using Google.Type;
...
private static async Task CallAddressValidation()
{
    // Create the Address Validation Client
    AddressValidationClient client = await AddressValidationClient.CreateAsync();
    // Define the request with the address to be validated
    var request = new ValidateAddressRequest
    {
        Address = new PostalAddress
        {
            RegionCode = "US",
            LanguageCode = "en",
            PostalCode = "94043",
            AdministrativeArea = "CA",
            Locality = "Mountain View",
            AddressLines = { "1600 Amphitheatre Parkway" }
        }
    };
    try
    {
        // Call the API asynchronously
        ValidateAddressResponse response = await client.ValidateAddressAsync(request);
        // Process the results
        Console.WriteLine($"Validation Granularity: {response.Result.Verdict.ValidationGranularity}");
        Console.WriteLine($"Formatted Address: {response.Result.Address.FormattedAddress}");
        Console.WriteLine($"Response ID: {response.ResponseId}");
    }
    catch (Exception ex)
    {
        Console.WriteLine($"An error occurred: {ex.Message}");
    }
}

RegionCode , Locality , এবং AddressLines মত কম্পোনেন্টাইজড অ্যাড্রেস ফিল্ড সহ একটি PostalAddress অবজেক্টকে সংজ্ঞায়িত করুন৷ উদাহরণের অনুরোধ তৈরি করার সময়, এই PostalAddress একটি ValidateAddressRequest তৈরি করতে ব্যবহার করা হয়। তারপরে অনুরোধ করার জন্য ValidateAddressAsync পদ্ধতিতে ডাকা হয়, এবং প্রতিক্রিয়া থেকে বিবরণ যেমন ValidationGranularity এবং FormattedAddress আউটপুট হয়।

যাচাইকরণ প্রতিক্রিয়া প্রদান করুন

ক্লায়েন্ট লাইব্রেরি ব্যবহার করে কিভাবে provideValidationFeedback কল করতে হয় তার একটি উদাহরণ নিচে দেওয়া হল।

using Google.Maps.AddressValidation.V1;
...
private static async Task ProvideValidationFeedback()
{
    AddressValidationClient client = await AddressValidationClient.CreateAsync();

    var feedbackRequest = new ProvideValidationFeedbackRequest
    {
        // Set the conclusion based on the user's choice. This exampels uses ValidatedVersionUsed
        Conclusion = ProvideValidationFeedbackRequest.Types.ValidationConclusion.ValidatedVersionUsed,
        // Provide the ID from the validation response.
        ResponseId = "Response_ID"
    };
    try
    {
        Console.WriteLine("Sending feedback to the API");
        // This call returns an empty response on success.
        await client.ProvideValidationFeedbackAsync(feedbackRequest);
        Console.WriteLine(" -> Feedback sent successfully!");
    }
    catch (Exception ex)
    {
        Console.WriteLine($"An error occurred: {ex.Message}");
    }
}

ঠিকানা যাচাইকরণের চূড়ান্ত ফলাফল সম্পর্কে তথ্য পাঠাতে একটি ProvideValidationFeedbackRequest তৈরি করুন। ব্যবহারকারীর আসল ঠিকানা বা Google এর বৈধ ঠিকানা ব্যবহার করা হয়েছে কিনা তা উল্লেখ করার জন্য অনুরোধটির জন্য একটি Conclusion প্রয়োজন। গুরুত্বপূর্ণভাবে, আপনাকে অবশ্যই সঠিক লেনদেনের সাথে প্রতিক্রিয়া লিঙ্ক করতে প্রাথমিক ValidateAddressResponse থেকে প্রাপ্ত ResponseId প্রদান করতে হবে।