src/third_party/libaddressinput/src/README.md

   1 # ![](https://github.com/googlei18n/libaddressinput/wiki/libaddressinput-icon-70x55.png) libaddressinput
   2
   3 [![Build Status](https://drone.io/github.com/googlei18n/libaddressinput/status.png)](https://drone.io/github.com/googlei18n/libaddressinput/latest)
   4
   5 The _libaddressinput_ project consists of two different libraries (one
   6 implemented in C++, one implemented in Java for Android) that use
   7 [address metadata](https://github.com/googlei18n/libaddressinput/wiki/AddressValidationMetadata)
   8 from
   9 [Google](https://developers.google.com/)'s
  10 [I18n Services](https://i18napis.appspot.com/)
  11 [Address Data Service](https://i18napis.appspot.com/address)
  12 to assist application developers in collecting and handling _postal addresses_
  13 from all over the world.
  14
  15 These libraries can provide information about what input fields are required for
  16 a correct address input form for any country in the world and can validate an
  17 address to highlight input errors like missing required fields or invalid
  18 values.
  19
  20 ## C++
  21
  22 The C++ library (in very portable C++03) of _libaddressinput_ is the backend for
  23 [requestAutocomplete()](http://www.html5rocks.com/en/tutorials/forms/requestautocomplete/)
  24 in [Chromium](http://www.chromium.org/Home). The source code for that is a good
  25 example of how to use this library to implement a complex feature in a real
  26 application:
  27
  28 https://src.chromium.org/viewvc/chrome/trunk/src/third_party/libaddressinput/
  29 https://chromium.googlesource.com/chromium/src/+/master/third_party/libaddressinput/
  30
  31 Video: [Easy International Checkout with Chrome](https://www.youtube.com/watch?v=ljYeHwGgzQk)
  32
  33 ## Java
  34
  35 The Java library of _libaddressinput_ is written for use in
  36 [Android](https://developer.android.com/) and includes an Android UI address
  37 input widget ready for use, but only the UI parts are tied to Android (all the
  38 non-UI unit tests can be readily run in Java SE, `ant junit`) and the rest of
  39 the library could easily be adapted to run in any Java environment.
  40
  41 ## Mailing List
  42
  43 Using and developing libaddressinput is discussed on this mailing list:
  44
  45 https://groups.google.com/forum/#!forum/libaddressinput-discuss