Phonenumbers

Code changes:
- Doc fix for PhoneNumberOfflineGeocoder to explain the cases where an empty
string might be returned.
Metadata changes:
- Updated phone metadata for region code(s):
AG, AI, AS, BB, BF, BM, BQ, BS, BW, CA, DM, DO, ES, GD, GU, HK, HR, IN, JM,
JO, KN, KY, LC, ME, MP, MS, MX, PH, PR, SR, SX, TC, TH, TT, US, VC, VG, VI
- Updated short number metadata for region code(s): ES, HR
- Updated geocoding data for country calling code(s):
34 (en, es), 84 (vi), 91 (en)
- New carrier data for country calling code(s): 264 (en)
- Updated carrier data for country calling code(s):
55 (en), 63 (en), 66 (en), 91 (en), 233 (en), 599 (en)

Metadata changes:
- Updated phone metadata for region code(s): BS, CI, HT, IL, IN, IS, KE, SK
- Updated short number metadata for region code(s): KE
- Updated geocoding data for country calling code(s): 254 (en)
- Updated carrier data for country calling code(s):
91 (en), 225 (en), 254 (en), 354 (en), 509 (en), 1242 (en)

Code changes:
- Making getNationalSignificantNumber more robust in the face of malicious
input. This now ignores the number_of_leading_zeros if they are less than
zero.
Metadata changes:
- New alternate formatting data for country calling code(s): 39
- Updated phone metadata for region code(s): BS, VN
- Updated geocoding data for country calling code(s):
62 (en, id), 84 (en), 374 (en, hy)
- Updated carrier data for country calling code(s): 7 (ru), 91 (en), 1242 (en)
- Updated / refreshed time zone meta data.

Code changes:
- Added two new enum values to ValidationResult - IS_POSSIBLE_LOCAL_ONLY and
INVALID_LENGTH. Added more documentation to the existing values; see the
javadoc for when these are going to be used. Note that the API for
IsPossibleNumberWithReason has not yet been changed to return these values.
IS_POSSIBLE_LOCAL_ONLY will be returned for some values which currently
return IS_POSSIBLE, and INVALID_LENGTH will be returned for some values which
currently return TOO_LONG.
- Fix for isNumberMatch to ignore the numberOfLeadingZeros field when comparing
numbers unless hasItalianLeadingZero is true, and to consider default values
to match the same value when explicitly set for these two fields. This fix
shouldn't be needed for anyone correctly creating phone numbers using "parse"
as recommended.
- C++ only: Fix for ExactlySameAs when comparing phone numbers to include
comparison of the number_of_leading_zeros field.
- C++ only: Updating maximum length for NSN to be 17 (matches Java and JS)
Metadata changes:
- Updated phone metadata for region code(s): IN, MU, RE, TG, TJ, TT, US
- New geocoding data for country calling code(s):
218 (en), 972 (iw), 1283 (en), 1442 (en), 1458 (en), 1470 (en), 1475 (en),
1531 (en), 1534 (en), 1539 (en), 1680 (en), 1681 (en), 1762 (en)
- Updated geocoding data for country calling code(s):
1206 (en), 1253 (en), 1360 (en), 1425 (en), 1509 (en)
- Updated carrier data for country calling code(s):
57 (en), 91 (en), 297 (en), 992 (en), 1868 (en)

Code changes:
- Made normalizeDiallableCharsOnly() API in PhoneNumberUtil (Java) public. This
method is already public in the C++ implementation. It has also now been
added to the Javascript implementation.
Metadata changes:
- Updated alternate formatting data for country calling code(s): 91
- Updated phone metadata for region code(s):
AU, AX, BY, BZ, FR, GY, IN, MC, NA, SJ, TG, TT, VN
- Updated short number metadata for region code(s): HR, TG
- Armenia geocoding data that is in Armenian language is moved to right language
code (hy).
- Updated geocoding data for country calling code(s): 91 (en), 374 (en, ru)
- Updated carrier data for country calling code(s): 91 (en)

Code changes:
- Introduced new isCarrierSpecificForRegion() API in ShortNumberInfo class.
This determines whether the provided short code is carrier-specific or
not when dialed from the given region.
Metadata changes:
- New alternate formatting data for country calling code(s): 52
- Updated alternate formatting data for country calling code(s): 62
- Updated phone metadata for region code(s):
AR, DJ, GB, GG, GH, ID, IM, IN, JE, MA, MQ, MZ, RO, ZA
- Updated short number metadata for region code(s): ZA
- Updated geocoding data for country calling code(s): 27 (en)
- Updated carrier data for country calling code(s):
91 (en), 93 (en, fa), 233 (en), 253 (en), 258 (en)