[Payments] Normalize addresses before passing them to merchants.

third_party/libaddressinput/chromium/chrome_address_validator.h

 // Copyright 2014 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 #ifndef THIRD_PARTY_LIBADDRESSINPUT_CHROMIUM_CHROME_ADDRESS_VALIDATOR_H_
 #define THIRD_PARTY_LIBADDRESSINPUT_CHROMIUM_CHROME_ADDRESS_VALIDATOR_H_
 
 #include <stddef.h>
 
 #include <map>
@@ skipping 117 matching lines @@
   // Suggestion:
   //   [{dependent_locality: "Zongyang Xian",
   //     locality: "Anqing Shi",
   //     administrative_area: "Anhui Sheng"}]
   virtual Status GetSuggestions(
       const ::i18n::addressinput::AddressData& user_input,
       ::i18n::addressinput::AddressField focused_field,
       size_t suggestion_limit,
       std::vector< ::i18n::addressinput::AddressData>* suggestions) const;
 
-  // Canonicalizes the administrative area in |address_data|. For example,
-  // "texas" changes to "TX". Returns true on success, otherwise leaves
-  // |address_data| alone and returns false.
-  virtual bool CanonicalizeAdministrativeArea(
+  // Normalizes the |address_data|. For example, "texas" changes to "TX".
+  // Returns true on success, otherwise leaves |address_data| alone and returns
+  // false.
+  virtual bool NormalizeAddress(
       ::i18n::addressinput::AddressData* address) const;
 
+  // Returns whether the rules associated with the |region_code| are loaded.
+  virtual bool AreRulesLoadedForRegion(const std::string& region_code);
+
  protected:
   // Constructor used only for MockAddressValidator.
   AddressValidator();
 
   // Returns the period of time to wait between the first attempt's failure and
   // the second attempt's initiation to load rules. Exposed for testing.
   virtual base::TimeDelta GetBaseRetryPeriod() const;
 
  private:
   // Verifies that |validator_| succeeded. Invoked by |validated_| callback.
@@ skipping 41 matching lines @@
   // any WeakPtrs to AddressValidator are invalidated before its members
   // variable's destructors are executed, rendering them invalid.
   base::WeakPtrFactory<AddressValidator> weak_factory_;
 
   DISALLOW_COPY_AND_ASSIGN(AddressValidator);
 };
 
 }  // namespace autofill
 
 #endif  // THIRD_PARTY_LIBADDRESSINPUT_CHROMIUM_CHROME_ADDRESS_VALIDATOR_H_