Exemples de bibliothèques clientes de l'API Address Validation

Cette page présente des exemples d'utilisation des bibliothèques clientes de l'API Address Validation pour appeler les services suivants:

Installer les bibliothèques clientes

Pour obtenir des instructions d'installation, consultez la page Bibliothèques clientes de l'API Address Validation.

Authentification

Lorsque vous utilisez des bibliothèques clientes, vous utilisez les identifiants par défaut de l'application (ADC) pour vous authentifier. Pour en savoir plus sur la configuration de ces identifiants, consultez la section Fournir des identifiants aux ADC. Pour en savoir plus sur l'utilisation des ADC avec les bibliothèques clientes, consultez la section S'authentifier à l'aide de bibliothèques clientes.

Vous pouvez également utiliser des clés API pour vous authentifier auprès des bibliothèques clientes, par exemple:

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();

Lorsque vous utilisez des clés API dans vos applications, assurez-vous qu'elles sont protégées lors du stockage et de la transmission. L'exposition publique de vos clés API peut entraîner des frais inattendus sur votre compte.

Les exemples de cette page utilisent les identifiants par défaut de l'application.

Exemples

validateAddress

Vous trouverez ci-dessous un exemple d'appel de validateAddress à l'aide de la bibliothèque cliente.

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}");
    }
}

Définissez un objet PostalAddress avec des champs d'adresses segmentés, tels que RegionCode, Locality et AddressLines. Lors de la création de l'exemple de requête, cette PostalAddress est utilisée pour créer un ValidateAddressRequest. La méthode ValidateAddressAsync est ensuite appelée pour effectuer la requête, et les détails de la réponse, tels que le ValidationGranularity et le FormattedAddress, sont affichés.

provideValidationFeedback

Vous trouverez ci-dessous un exemple d'appel de provideValidationFeedback à l'aide de la bibliothèque cliente.

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}");
    }
}

Créez un ProvideValidationFeedbackRequest pour envoyer des informations sur le résultat final d'une séquence de validation d'adresse. La requête nécessite un Conclusion pour spécifier si l'adresse d'origine de l'utilisateur ou l'adresse validée de Google a été utilisée. Surtout, vous devez également fournir le ResponseId obtenu à partir du ValidateAddressResponse initial pour associer les commentaires à la transaction appropriée.