Phonenumbers

Metadata changes:
- Updated phone metadata for region code(s):
AL, AR, AT, AU, AX, AZ, BO, BR, CN, CO, DE, EG, FI, GB, GL, GW, ID, IE, IL,
IM, IN, JP, KI, KR, KW, LB, LI, LU, MV, MW, NA, NE, NG, PK, PY, SE, SI, SK,
SO, SR, TJ, TW, UA, UG, US, VN, ZW
- Updated short number metadata for region code(s): KR
- New geocoding data for country calling code(s): 380 (en), 1838 (en)
- Updated geocoding data for country calling code(s): 84 (en, vi), 686 (en)
- Updated carrier data for country calling code(s):
60 (en), 380 (en), 597 (en), 686 (en)

Code changes:
- Improve parsing logic to be smarter about national-prefix detection &
stripping based on possible-lengths (IS_POSSIBLE_LOCAL_ONLY and
INVALID_LENGTH). Enables e.g. adding Iran short-codes starting with "096"
without the need to hack IR's national prefix parsing config.
- Logging changes: Don't log client-provided phone numbers.
- Add constants for C++ PhoneNumberUtil enums' max values.
Metadata changes:
- Updated phone metadata for region code(s):
AX, BF, BG, DM, EG, FI, IN, IR, KY, KZ, LC, MT, NI, PL, RU, SZ, TH, US, VC
- Updated short number metadata for region code(s): BA, IR, PL, RU, TH, ZA
- New geocoding data for country calling code(s): 52 (es), 1986 (en)
- Updated geocoding data for country calling code(s): 52 (en), 268 (en)
- New carrier data for country calling code(s): 1345 (en)
- Updated carrier data for country calling code(s):
20 (en), 226 (en), 268 (en), 356 (en), 505 (en), 1441 (en), 1758 (en),
1767 (en), 1784 (en)

Code changes:
- Documentation fix for getNumberType
Metadata changes:
- Updated phone metadata for region code(s):
AG, AM, BJ, BO, CL, EE, EG, GD, HK, IN, KE, KW, LK, US
- Updated short number metadata for region code(s): BJ, EE, EG, IN, KW
- New geocoding data for country calling code(s): 1564 (en)
- New carrier data for country calling code(s): 1268 (en)
- Updated carrier data for country calling code(s):
56 (en), 254 (en), 374 (en), 852 (en, zh, zh_Hant), 1473 (en)
- Updated / refreshed time zone meta data.

Code changes:
- New method getSupportedCallingCodes() API to return all the calling codes
that the library considers valid, both for geographical and non-geographical
entities.
- Added isSmsServiceForRegion(PhoneNumber, RegionCode) API in C++ and Java
short number info libraries. An SMS service is where the primary or only
intended usage is to receive and/or send text messages (SMSs). This includes
MMS as MMS numbers downgrade to SMS if the other party isn't MMS-capable. The
is_sms_service metadata is also serialized for the first time. JS is not
affected because it doesn't have short numbers.
- Documentation update for private variables VALID_PUNCTUATION and
SINGLE_INTERNATIONAL_PREFIX, also renaming the latter from
UNIQUE_INTERNATIONAL_PREFIX.
- [Java only] Changing public APIs that take in strings representing phone
numbers or parts of phone numbers to take in CharSequence instead. Updating
some of the internal methods to do the same. This affects ShortNumberInfo and
PhoneNumberUtil, namely the following methods:
- parse & parseAndKeepRawInput
- formatWithCarrierCode & formatWithPreferredCarrierCode
- isNumberMatch
- isPossibleNumber
- isAlphaNumber
- normalizeDigitsOnly & normalizeDiallableCharsOnly
- [C++ only] Removing most of the "using std::*" statements in
phonenumberutil.h file, leaving only using std::string. Changing the .cc and
test files to prefix "std::" where this was missing.
Metadata changes:
- New alternate formatting data for country calling code(s): 856
- Updated phone metadata for region code(s):
BF, FI, GG, HK, IM, JE, KG, LA, MX, MY, PS, SA, VN, ZW
- New short number metadata for region code(s): PS
- Updated short number metadata for region code(s): TR, ZA
- New geocoding data for country calling code(s): 52 (en), 976 (en)
- Updated geocoding data for country calling code(s):
84 (en, vi), 223 (en), 358 (en, fi, sv)
- Updated carrier data for country calling code(s):
40 (en), 44 (en), 91 (en), 226 (en), 966 (en), 996 (en)
- Updated / refreshed time zone meta data.

Code changes:
- Removing leading_zero_possible from the metadata and all the places it is
referenced in the build and prod code. Will be removed from the metadata
proto itself in a subsequent release. This should not affect users of the
library - the only place it was used was FormatInOriginalFormat, and only
initially to try and avoid modifying the input number by removing/adding
digits inadvertently. Now this is checked at the end of the method anyway.
However slight formatting differences with this method on invalid numbers
starting with 0s may be noticed in some countries.
- Bug fix for Javascript: getNationalSignificantNumber used to print the string
"null" for empty phone number objects, now it returns an empty string.
- Updated the documentation for the isNumberGeographical API.
- Small comment improvements for parse() method to point users at
parseAndKeepRawInput().
- Added a new enum for CountryCodeSource called UNSPECIFIED. This is used as a
default value, and will be returned if someone calls parse() and then
getCountryCodeSource() on the result. If users want an actual value for this
then they should call parseAndKeepRawInput() instead; the values that were
previously returned after calling this method will not change.
- Deletion of the possible number pattern in the phonemetadata.proto file and
all generated code. This has not been used for a long time.
Metadata changes:
- Updated phone metadata for region code(s): AU, IL, IM, IN, KE, MM, PM, UA
- Updated geocoding data for country calling code(s): 95 (en)
- New carrier data for country calling code(s): 508 (en)
- Updated carrier data for country calling code(s):
95 (en), 254 (en), 972 (en)

Metadata changes:
- New alternate formatting data for country calling code(s): 64
- Updated phone metadata for region code(s):
AL, AX, BR, CM, FI, GE, GI, IE, IN, IR, JO, LA, LR, MK, NZ, PK, SI, TL, UA
- Updated short number metadata for region code(s): IR, TH, ZA
- New carrier data for country calling code(s): 503 (en)
- Updated carrier data for country calling code(s):
91 (en), 213 (en), 386 (en), 389 (en), 509 (en), 995 (en)