1May 05, 2022: v8.12.48 2Metadata changes: 3 - Updated phone metadata for region code(s): 4 AG, AI, AS, BB, BM, BR, BS, CA, DM, DO, EE, GD, GF, GP, GU, IS, JM, KN, KY, 5 LC, MN, MP, MS, NL, NP, PM, PR, SI, SX, SY, TC, TT, UG, US, VC, VG, VI, YT 6 - New geocoding data for country calling code(s): 7 1263 (en), 1468 (en), 1584 (en), 1656 (en), 1948 (en) 8 - Updated carrier data for country calling code(s): 9 354 (en), 370 (en), 372 (en), 503 (en), 963 (en), 977 (en) 10 - Updated / refreshed time zone meta data. 11 12Apr 19, 2022: v8.12.47 13Metadata changes: 14 - Updated phone metadata for region code(s): 15 AO, BB, FR, GB, GE, GG, HR, JE, MT, NC, PA, SE 16 - Updated carrier data for country calling code(s): 17 33 (en), 41 (en), 46 (en), 244 (en), 351 (en), 385 (en), 420 (en), 974 (en), 18 995 (en), 1246 (en), 1345 (en) 19 20Mar 31, 2022: v8.12.46 21Metadata changes: 22 - Updated phone metadata for region code(s): BJ, JM, PW, SA 23 - Updated short number metadata for region code(s): HU 24 - Updated carrier data for country calling code(s): 25 36 (en), 51 (en), 61 (en), 90 (en), 229 (en), 254 (en), 680 (en), 966 (en) 26 27Mar 10, 2022: v8.12.45 28Metadata changes: 29 - Updated phone metadata for region code(s): BF, EE, JM, RE, SE, US 30 - New geocoding data for country calling code(s): 1464 (en) 31 - Updated carrier data for country calling code(s): 32 46 (en), 55 (en), 226 (en), 262 (en), 353 (en), 372 (en), 373 (en), 33 1345 (en) 34 - Updated / refreshed time zone meta data. 35 36Feb 23, 2022: v8.12.44 37Metadata changes: 38 - Updated phone metadata for region code(s): 39 AG, AI, AS, BB, BM, BS, CA, CV, DM, DO, GD, GU, JM, KN, KY, LC, MP, MS, PR, 40 SC, SX, TC, TT, US, VC, VG, VI 41 - Updated short number metadata for region code(s): BE, PT, SC, SE, US 42 - Updated geocoding data for country calling code(s): 43 61 (en), 238 (en), 1345 (en) 44 - Updated carrier data for country calling code(s): 238 (en), 248 (en) 45 46Feb 09, 2022: v8.12.43 47Metadata changes: 48 - Updated phone metadata for region code(s): 49 BJ, CL, GA, IS, KR, KW, LI, PA, SG, SL 50 - Updated short number metadata for region code(s): MS 51 - Updated geocoding data for country calling code(s): 56 (en, es) 52 - Updated carrier data for country calling code(s): 53 32 (en), 229 (en), 354 (en), 502 (en), 507 (en) 54 55Jan 27, 2022: v8.12.42 56Metadata changes: 57 - Updated phone metadata for region code(s): 58 BG, BI, CF, DZ, GF, GP, HK, IR, MA, MQ, MW, PK, PL, PM, QA, TJ 59 - Updated short number metadata for region code(s): 60 AG, AI, AS, BB, BM, BS, CA, DM, DO, GD, GU, JM, KN, KY, LC, MP, MS, PR, SX, 61 TC, TT, US, VC, VG, VI 62 - Updated geocoding data for country calling code(s): 61 (en), 213 (en) 63 - Updated carrier data for country calling code(s): 64 45 (en), 48 (en), 57 (en), 98 (en, fa), 236 (en), 243 (en), 257 (en), 65 420 (en), 421 (en), 508 (en), 675 (en), 852 (en, zh), 974 (en), 992 (en) 66 67Jan 11, 2022: v8.12.41 68Metadata changes: 69 - Updated phone metadata for region code(s): EH, IL, KE, LA, MA, OM, SG 70 - Updated short number metadata for region code(s): PY 71 - Updated carrier data for country calling code(s): 72 33 (en), 65 (en), 358 (en), 383 (en), 420 (en), 502 (en), 856 (en), 966 (en), 73 968 (en), 974 (en) 74 75Dec 23, 2021: v8.12.40 76Metadata changes: 77 - Updated phone metadata for region code(s): GP, GY, MK, VU 78 - Updated geocoding data for country calling code(s): 389 (en) 79 - Updated carrier data for country calling code(s): 60 (en), 592 (en) 80 81Dec 07, 2021: v8.12.39 82Metadata changes: 83 - Updated phone metadata for region code(s): CO, EH, HK, MA, MU, ZM 84 - Updated carrier data for country calling code(s): 85 57 (en), 81 (en), 852 (en, zh) 86 87Nov 25, 2021: v8.12.38 88Metadata changes: 89 - Updated phone metadata for region code(s): 90 883, AT, BI, BW, CG, EE, EH, HN, HU, LI, LK, MA, PA, PH, SG, TH, TJ 91 - Updated geocoding data for country calling code(s): 61 (en), 504 (en) 92 - Updated carrier data for country calling code(s): 93 51 (en), 65 (en), 370 (en), 992 (en) 94 - Updated / refreshed time zone meta data. 95 96Nov 11, 2021: v8.12.37 97Metadata changes: 98 - Updated phone metadata for region code(s): 99 AU, BD, CC, CX, GB, IT, LI, MQ, SG, US, VA 100 - Updated geocoding data for country calling code(s): 880 (en) 101 - Updated carrier data for country calling code(s): 102 65 (en), 81 (en), 356 (en), 423 (en) 103 104Oct 26, 2021: v8.12.36 105Metadata changes: 106 - Updated phone metadata for region code(s): AZ, GA, HK, JM, KW, RO, TJ, UY 107 - Updated geocoding data for country calling code(s): 994 (en) 108 - Updated carrier data for country calling code(s): 109 40 (en), 41 (en), 252 (en), 852 (en, zh), 965 (en) 110 111Oct 12, 2021: v8.12.35 112Metadata changes: 113 - Updated phone metadata for region code(s): AU, AZ, CC, CO, CX, EH, HN, MA 114 - Updated carrier data for country calling code(s): 994 (en) 115 116Oct 06, 2021: v8.12.34 117Metadata changes: 118 - Updated phone metadata for region code(s): AR, BD, DE, MX, VI 119 - Updated geocoding data for country calling code(s): 120 55 (en), 420 (en), 880 (en), 1340 (en) 121 122Sep 22, 2021: v8.12.33 123Metadata changes: 124 - Updated phone metadata for region code(s): 125 CG, CZ, GE, GF, GR, KR, MT, PA, TH, UG, UZ 126 - Updated geocoding data for country calling code(s): 420 (en) 127 - Updated carrier data for country calling code(s): 128 46 (en), 420 (en), 966 (en) 129 130Sep 09, 2021: v8.12.32 131Metadata changes: 132 - Updated phone metadata for region code(s): CI, GE, RO, SG, US, YT 133 - New geocoding data for country calling code(s): 1582 (en) 134 - Updated carrier data for country calling code(s): 135 40 (en), 65 (en), 262 (en), 356 (en), 503 (en), 995 (en) 136 - Updated / refreshed time zone meta data. 137 138Aug 24, 2021: v8.12.31 139Metadata changes: 140 - Updated phone metadata for region code(s): CO, EE, GB, PH, US 141 - New geocoding data for country calling code(s): 1771 (en) 142 - Updated geocoding data for country calling code(s): 57 (en), 225 (en) 143 - Updated carrier data for country calling code(s): 144 63 (en), 252 (en), 372 (en), 389 (en) 145 - Updated / refreshed time zone meta data. 146 147Aug 17, 2021: v8.12.30 148Metadata changes: 149 - Updated phone metadata for region code(s): 800, AM, GL, KW, SG, SO, SY 150 - Updated carrier data for country calling code(s): 151 55 (en), 65 (en), 252 (en), 263 (en), 963 (en) 152 - Updated / refreshed time zone meta data. 153 154Aug 06, 2021: v8.12.29 155Code changes: 156 - Updated As-You-Type-Formatter to exclude patterns where some digits would be dropped in the output. This also fixes the bug where an extra country code is added in some cases to the user's output. b/183053929 157Metadata changes: 158 - Updated phone metadata for region code(s): BE, GE, IR, MO, MX, QA, SN 159 - Updated geocoding data for country calling code(s): 52 (en) 160 - Updated carrier data for country calling code(s): 161 32 (en), 221 (en), 995 (en) 162 - Updated / refreshed time zone meta data. 163 164Jul 20, 2021: v8.12.28 165Metadata changes: 166 - Updated phone metadata for region code(s): 167 CO, EH, GF, HK, KZ, MA, MO, MU, MX, NG, OM, PH, RU, SG, TO, UG 168 - Updated geocoding data for country calling code(s): 52 (en) 169 - Updated carrier data for country calling code(s): 170 34 (en), 57 (en), 63 (en), 65 (en), 229 (en), 234 (en), 676 (en), 171 852 (en, zh), 968 (en) 172 - Updated / refreshed time zone meta data. 173 174Jul 07, 2021: v8.12.27 175Metadata changes: 176 - Updated phone metadata for region code(s): BW, MG, MW, PL, RO, TO, ZW 177 - Updated short number metadata for region code(s): BW, HU 178 - Updated carrier data for country calling code(s): 179 36 (en), 48 (en), 261 (en), 263 (en), 676 (en) 180 181Jun 23, 2021: v8.12.26 182Metadata changes: 183 - Updated phone metadata for region code(s): DZ, EH, GB, MA, PH, QA 184 - Updated geocoding data for country calling code(s): 212 (en) 185 186Jun 09, 2021: v8.12.25 187Metadata changes: 188 - Updated phone metadata for region code(s): 189 BZ, GB, GH, HN, JM, LU, TJ, US, VU 190 - New geocoding data for country calling code(s): 1448 (en) 191 - Updated geocoding data for country calling code(s): 678 (en) 192 - Updated carrier data for country calling code(s): 193 233 (en), 678 (en), 1876 (en) 194 - Updated / refreshed time zone meta data. 195 196May 26, 2021: v8.12.24 197Code changes: 198 - Changes formatOutOfCountryCallingNumber to always use preferred intl prefix if present, not just for numbers with a non-unique IDD. This means we will output "8~10" as the prefix if calling formatOutOfCountryCallingNumber instead of "810" for some regions that have this tilde in their prefix [designates that the user should wait before continuing to dial]. 199Metadata changes: 200 - Updated phone metadata for region code(s): 201 883, AX, FI, GE, IR, PA, PG, PH, SG, SL, UZ 202 - Updated carrier data for country calling code(s): 203 33 (en), 63 (en), 65 (en), 98 (en, fa), 358 (en), 507 (en), 675 (en), 204 995 (en) 205 206May 11, 2021: v8.12.23 207Metadata changes: 208 - Updated phone metadata for region code(s): BF, CI, RW, SG, UG, US, UZ 209 - Updated short number metadata for region code(s): DZ 210 - New geocoding data for country calling code(s): 1572 (en) 211 - Updated geocoding data for country calling code(s): 225 (en) 212 - Updated carrier data for country calling code(s): 213 65 (en), 225 (en), 226 (en), 250 (en), 256 (en), 998 (en) 214 - Updated / refreshed time zone meta data. 215 216Apr 29, 2021: v8.12.22 217Metadata changes: 218 - Updated phone metadata for region code(s): 219 BL, CA, CD, CI, GP, IR, JP, LI, MF, MY, PH, PT, RE 220 - Updated short number metadata for region code(s): FI, PS 221 - New geocoding data for country calling code(s): 1368 (en) 222 - Updated geocoding data for country calling code(s): 49 (de, en), 52 (es) 223 - Updated carrier data for country calling code(s): 224 46 (en), 60 (en), 63 (en), 225 (en), 229 (en), 243 (en), 252 (en), 262 (en), 225 351 (en), 423 (en), 590 (en) 226 - Updated / refreshed time zone meta data. 227 228Apr 05, 2021: v8.12.21 229Metadata changes: 230 - Updated phone metadata for region code(s): 231 BL, EH, GB, GF, GP, MA, MF, MQ, PF, PM, SG, SS, WF 232 - Updated short number metadata for region code(s): DE 233 - Updated carrier data for country calling code(s): 234 65 (en), 211 (en), 212 (en) 235 - Updated / refreshed time zone meta data. 236 237Mar 16, 2021: v8.12.20 238Metadata changes: 239 - Updated phone metadata for region code(s): 240 AR, CA, CL, CM, EH, IM, JP, LB, MA, MC, MY, SG, US 241 - New geocoding data for country calling code(s): 242 961 (en), 1447 (en), 1474 (en), 1840 (en) 243 - Updated geocoding data for country calling code(s): 1854 (en) 244 - Updated carrier data for country calling code(s): 245 56 (en), 60 (en), 65 (en), 84 (en) 246 - Updated / refreshed time zone meta data. 247 248Mar 01, 2021: v8.12.19 249Metadata changes: 250 - Updated phone metadata for region code(s): 251 882, AU, BJ, BW, CC, CX, EH, KZ, MA, MQ, MU, NO, RE, SG, SJ, SL, TJ, TT, US, 252 YT 253 - New geocoding data for country calling code(s): 1945 (en) 254 - Updated geocoding data for country calling code(s): 61 (en), 267 (en) 255 - Updated carrier data for country calling code(s): 256 7 (en), 41 (en), 65 (en), 221 (en), 229 (en), 230 (en), 232 (en), 262 (en), 257 592 (en), 596 (en), 882 (en), 992 (en), 1868 (en) 258 - Updated / refreshed time zone meta data. 259 260Feb 08, 2021: v8.12.18 261Metadata changes: 262 - Updated alternate formatting data for country calling code(s): 676 263 - Updated phone metadata for region code(s): CI, IR, SG, TO 264 - Updated geocoding data for country calling code(s): 225 (en) 265 - Updated carrier data for country calling code(s): 266 65 (en), 225 (en), 676 (en) 267 268Jan 27, 2021: v8.12.17 269Metadata changes: 270 - Updated phone metadata for region code(s): CI, GR, MO, TR, VU 271 - Updated geocoding data for country calling code(s): 225 (en) 272 - Updated carrier data for country calling code(s): 853 (en) 273 274Jan 12, 2021: v8.12.16 275Metadata changes: 276 - Updated phone metadata for region code(s): 277 870, AL, AR, BA, BW, CO, DE, DM, DO, GB, GI, HK, KW, MK, MO, MY, OM, SG, SL, 278 TH 279 - Updated short number metadata for region code(s): AR 280 - Updated geocoding data for country calling code(s): 44 (en) 281 - Updated carrier data for country calling code(s): 282 41 (en), 46 (en), 57 (en), 60 (en), 61 (en), 65 (en), 66 (en), 227 (en), 283 232 (en), 267 (en), 350 (en), 351 (en), 356 (en), 389 (en), 420 (en), 284 852 (en, zh), 853 (en) 285 286Dec 15, 2020: v8.12.15 287Metadata changes: 288 - Updated phone metadata for region code(s): GN, KE, MU, SG 289 - Updated carrier data for country calling code(s): 290 65 (en), 224 (en), 230 (en), 254 (en) 291 292Dec 02, 2020: v8.12.14 293Metadata changes: 294 - Updated phone metadata for region code(s): 295 BA, BW, CG, CO, EH, FO, HN, IL, KE, MA, NZ, SN, TJ, UY 296 - Updated geocoding data for country calling code(s): 57 (en), 504 (en) 297 - Updated carrier data for country calling code(s): 298 46 (en), 212 (en), 221 (en), 242 (en), 254 (en), 298 (en), 972 (en), 299 992 (en) 300 301Nov 12, 2020: v8.12.13 302Metadata changes: 303 - Updated phone metadata for region code(s): 304 CL, DE, FR, GQ, IL, IR, KG, KW, MU, NG, PW, SN, TZ 305 - Updated carrier data for country calling code(s): 306 7 (en), 33 (en), 221 (en), 230 (en), 234 (en), 240 (en), 255 (en), 680 (en), 307 886 (en), 972 (en) 308 309Oct 29, 2020: v8.12.12 310Metadata changes: 311 - Updated phone metadata for region code(s): 312 AG, AI, AS, BB, BM, BS, CA, CI, DM, DO, GB, GD, GG, GU, IR, JE, JM, JP, KE, 313 KN, KY, LC, MP, MS, NP, PK, PR, SA, SX, TC, TT, US, VC, VG, VI, VN, WS 314 - Updated short number metadata for region code(s): JP 315 - Updated geocoding data for country calling code(s): 81 (en, ja) 316 - New carrier data for country calling code(s): 81 (en) 317 - Updated carrier data for country calling code(s): 318 44 (en), 98 (en, fa), 225 (en), 685 (en), 966 (en) 319 - Updated / refreshed time zone meta data. 320 321Oct 07, 2020: v8.12.11 322Metadata changes: 323 - Updated phone metadata for region code(s): CM, HK, ID, LK, PA, PY, TJ, UZ 324 - Updated carrier data for country calling code(s): 325 94 (en), 852 (en, zh), 992 (en), 998 (en) 326 - Updated / refreshed time zone meta data. 327 328Sep 20, 2020: v8.12.10 329Metadata changes: 330 - Updated phone metadata for region code(s): 331 EH, IL, JO, MA, NG, PA, PG, PY, UY 332 - Updated short number metadata for region code(s): SA 333 - Updated geocoding data for country calling code(s): 598 (en) 334 - Updated carrier data for country calling code(s): 335 212 (en), 234 (en), 507 (en), 595 (en), 675 (en), 972 (en) 336 337Aug 30, 2020: v8.12.9 338Metadata changes: 339 - Updated phone metadata for region code(s): CO, GB, IL, SG 340 - Updated short number metadata for region code(s): SA 341 - Updated geocoding data for country calling code(s): 57 (en) 342 - Updated carrier data for country calling code(s): 65 (en), 972 (en) 343 344Aug 12, 2020: v8.12.8 345Metadata changes: 346 - Updated phone metadata for region code(s): HU, NE, PL, SG, SI, TR 347 - Updated short number metadata for region code(s): ID, NE 348 - Updated carrier data for country calling code(s): 349 65 (en), 226 (en), 227 (en) 350 351Jul 20, 2020: v8.12.7 352Metadata changes: 353 - Updated phone metadata for region code(s): ET, HN, KN, NA, SG, US, 354 HK, IR, LI, MU, TR, VN 355 - New geocoding data for country calling code(s): 1326 (en), 1839 (en) 356 - Updated geocoding data for country calling code(s): 380 (en), 504 (en) 357 - Updated carrier data for country calling code(s): 358 65 (en), 234 (en), 1869 (en), 98 (en, fa), 243 (en), 423 (en), 852 (en, zh) 359 - Updated / refreshed time zone meta data. 360 - Note: You will find commit with same release tag on Jul 02, 2020. 361 As that release blocked immediately, we started over new release with same tag. 362 363Code changes: 364 - [Java only] Added metadata/ folder to only GitHub devleopment version; this 365 will not be part of the release artifacts untill it is complete and ready 366 for usage. More details in its README file. 367 368 369Jun 17, 2020: v8.12.6 370Code changes: 371 - [Java only] Use protobuf API v2 for PhoneMetadata only, mark old methods as deprecated. 372 373Metadata changes: 374 - Updated phone metadata for region code(s): HN, KE, MY, ZA 375 - Updated carrier data for country calling code(s): 48 (en), 60 (en), 65 (en) 376 377Jun 03, 2020: v8.12.5 378Metadata changes: 379 - Updated phone metadata for region code(s): ES, GB, GG, JE, KR, RE, TJ, UZ 380 - Updated geocoding data for country calling code(s): 81 (en) 381 - Updated carrier data for country calling code(s): 382 34 (en), 82 (en, ko), 262 (en), 992 (en), 998 (en) 383 384May 19, 2020: v8.12.4 385Metadata changes: 386 - Updated phone metadata for region code(s): 387 AU, BR, CC, CX, HK, MM, PH, PL, TN 388 - Updated short number metadata for region code(s): FI, GB, TH 389 - Updated geocoding data for country calling code(s): 1242 (en), 1867 (en) 390 - Updated carrier data for country calling code(s): 391 61 (en), 63 (en), 95 (en), 216 (en), 852 (en, zh) 392 393May 06, 2020: v8.12.3 394Metadata changes: 395 - Updated phone metadata for region code(s): 396 AR, AU, CC, CX, GB, GG, GR, JE, MY, SG, SL, SR, TH 397 - Updated short number metadata for region code(s): AR, AU 398 - Updated geocoding data for country calling code(s): 61 (en), 66 (en, th) 399 - Updated carrier data for country calling code(s): 400 60 (en), 61 (en), 65 (en), 232 (en), 597 (en) 401 - Updated / refreshed time zone meta data. 402 403Apr 22, 2020: v8.12.2 404Metadata changes: 405 - Updated phone metadata for region code(s): 406 AL, AR, AU, CC, CX, ET, GE, GH, JM, JP, LA, MM, NZ, QA, SG, ZA 407 - Updated short number metadata for region code(s): AR 408 - New geocoding data for country calling code(s): 995 (en) 409 - Updated geocoding data for country calling code(s): 54 (en), 64 (en) 410 - Updated carrier data for country calling code(s): 411 64 (en), 65 (en), 95 (en), 995 (en), 1876 (en) 412 - Updated / refreshed time zone meta data. 413 414Mar 30, 2020: v8.12.1 415Metadata changes: 416 - Updated phone metadata for region code(s): 417 AG, AI, AS, BB, BD, BM, BS, BW, CA, CL, DM, DO, GB, GD, GU, IL, IR, JM, JO, 418 KN, KY, KZ, LC, MA, MC, MN, MP, MS, NG, NZ, PE, PH, PR, PW, SG, SS, SX, TC, 419 TT, US, VC, VG, VI, VN 420 - New short number metadata for region code(s): SS 421 - New geocoding data for country calling code(s): 63 (en), 1340 (en) 422 - Updated geocoding data for country calling code(s): 423 7 (en, ru), 44 (en), 56 (en, es), 212 (en, fr), 234 (en), 880 (en), 424 1242 (en), 1345 (en), 1659 (en) 425 - New carrier data for country calling code(s): 426 1340 (en), 1659 (en), 1664 (en), 1670 (en) 427 - Updated carrier data for country calling code(s): 428 7 (en, ru), 51 (en), 56 (en), 63 (en), 84 (en), 98 (en, fa), 211 (en), 429 234 (en), 267 (en), 972 (en), 976 (en), 1246 (en), 1264 (en), 1268 (en), 430 1284 (en), 1345 (en), 1441 (en), 1649 (en), 1684 (en), 1758 (en), 1767 (en), 431 1784 (en), 1868 (en), 1869 (en), 1876 (en) 432 - Updated / refreshed time zone meta data. 433 434Mar 18, 2020: v8.12.0 435Code changes: 436 - [JS only] Updates some closure annotations in `phonenumberutil.js` to indicate non-nullable parameters 437Metadata changes: 438 - Updated phone metadata for region code(s): 439 800, 808, 881, 882, 979, AR, AZ, CL, CN, HK, HN, JO, JP, KE, KP, LA, LR, MK, 440 ML, MN, MV, MY, MZ, NP, NZ, PS, SV, SY, TT, TZ, UZ, YE 441 - Updated short number metadata for region code(s): AC, JO, MK, MN, NP, SV, TZ 442 - New geocoding data for country calling code(s): 443 850 (en), 963 (en), 967 (en), 970 (en) 444 - Updated geocoding data for country calling code(s): 445 60 (en), 389 (en), 504 (en), 962 (en) 446 - New carrier data for country calling code(s): 447 247 (en), 500 (en), 504 (en), 850 (en), 881 (en), 882 (en) 448 - Updated carrier data for country calling code(s): 449 56 (en), 60 (en), 64 (en), 86 (en, zh), 223 (en), 231 (en), 258 (en), 450 267 (en), 389 (en), 503 (en), 852 (en, zh, zh_Hant), 856 (en), 960 (en), 451 962 (en), 963 (en), 964 (en), 970 (en), 992 (en), 994 (en), 998 (en), 452 1868 (en) 453 - Updated / refreshed time zone meta data. 454 455Mar 02, 2020: v8.11.5 456Metadata changes: 457 - Updated alternate formatting data for country calling code(s): 595 458 - Updated phone metadata for region code(s): 459 AD, BE, BQ, BW, CA, CI, CM, CR, EC, EE, EG, FM, FO, GL, GN, IL, KI, LK, LT, 460 ME, MO, MT, MW, NE, NF, NR, OM, PA, PF, PG, PK, PY, RO, RW, SC, SD, SG, SK, 461 SL, SO, TL, TM, TO, TV, UG, VE, VU, WS, ZM 462 - Updated short number metadata for region code(s): 463 GN, KI, LK, LT, OM, PK, RO, RW, SH, TM, TR, WS 464 - New geocoding data for country calling code(s): 465 92 (en), 236 (en), 593 (en), 595 (en), 598 (en), 670 (en), 672 (en), 466 678 (en), 685 (en), 689 (en), 690 (en), 993 (en), 1367 (en) 467 - Updated geocoding data for country calling code(s): 468 43 (en), 58 (en, es), 94 (en), 221 (en), 224 (en), 225 (en), 233 (en), 469 252 (en), 264 (en), 290 (en, fr), 352 (de, en), 370 (en), 374 (en, hy, ru), 470 421 (en), 599 (en), 686 (en) 471 - New carrier data for country calling code(s): 472 246 (en), 266 (en), 290 (en), 291 (en), 377 (en), 378 (en), 672 (en), 473 676 (en), 681 (en), 683 (en), 687 (en), 690 (en), 691 (en), 692 (en) 474 - Updated carrier data for country calling code(s): 475 40 (en), 43 (en), 48 (en), 65 (en), 92 (en), 222 (en), 225 (en), 227 (en), 476 229 (en), 230 (en), 232 (en), 233 (en), 236 (en), 256 (en), 265 (en), 477 267 (en), 268 (en), 298 (en), 370 (en), 372 (en), 376 (en), 381 (en), 478 383 (en), 421 (en), 502 (en), 506 (en), 507 (en), 592 (en), 593 (en), 479 598 (en), 599 (en), 670 (en), 674 (en), 675 (en), 678 (en), 685 (en), 480 686 (en), 853 (en), 968 (en), 972 (en), 993 (en) 481 - Updated / refreshed time zone meta data. 482 483Feb 12, 2020: v8.11.4 484Metadata changes: 485 - Updated phone metadata for region code(s): 486 AZ, BJ, CL, ET, GB, MA, MM, PW, RE, SG 487 - Updated geocoding data for country calling code(s): 680 (en) 488 - Updated carrier data for country calling code(s): 489 56 (en), 95 (en), 229 (en), 262 (en), 680 (en), 994 (en) 490 491Jan 28, 2020: v8.11.3 492Metadata changes: 493 - Updated phone metadata for region code(s): GB, GG, JE, MM, MU, US 494 - New geocoding data for country calling code(s): 1659 (en) 495 - Updated carrier data for country calling code(s): 95 (en) 496 - Updated / refreshed time zone meta data. 497 498Jan 14, 2020: v8.11.2 499Metadata changes: 500 - Updated phone metadata for region code(s): 501 BF, CA, EH, GM, KR, MA, ML, NG, NZ, SE, SG, TJ, TR, TT 502 - New geocoding data for country calling code(s): 1672 (en) 503 - Updated geocoding data for country calling code(s): 220 (en) 504 - Updated carrier data for country calling code(s): 505 65 (en), 212 (en), 220 (en), 226 (en), 234 (en), 992 (en), 1868 (en) 506 - Updated / refreshed time zone meta data. 507 508Dec 10, 2019: v8.11.1 509Metadata changes: 510 - Updated phone metadata for region code(s): 511 AR, DO, DZ, FR, GA, GE, GI, IL, KW, LB, MA, RO, SG, ZA 512 - Updated short number metadata for region code(s): FR 513 - Updated geocoding data for country calling code(s): 33 (en, fr), 54 (en) 514 - Updated carrier data for country calling code(s): 515 27 (en), 33 (en), 36 (en), 65 (en), 213 (en), 961 (en), 972 (en), 995 (en) 516 517Nov 26, 2019: v8.11.0 518Metadata changes: 519 - Updated alternate formatting data for country calling code(s): 91 520 - Updated phone metadata for region code(s): 521 AF, AL, AR, AX, AZ, BA, BE, BH, BI, BL, BN, CK, CO, CU, CV, DK, EH, ET, FI, 522 FR, GA, GB, GF, GH, GI, GP, GR, HR, IE, IN, IR, IS, JO, KG, KM, KR, KW, LI, 523 LY, MA, MD, MF, MM, MQ, NO, PT, QA, RE, SG, TW, YT, ZM, ZW 524 - Updated short number metadata for region code(s): 525 AF, AW, BE, CN, CO, DE, ET, GR, KR, MD, NO, PT, SG, TW 526 - New geocoding data for country calling code(s): 527 386 (en), 673 (en), 679 (en), 682 (en), 971 (en) 528 - Updated geocoding data for country calling code(s): 529 34 (en, es), 46 (en), 47 (en), 91 (en), 216 (en), 218 (en), 241 (en), 530 251 (en), 353 (en), 354 (en), 886 (en, zh), 996 (en) 531 - New carrier data for country calling code(s): 532 46 (en), 82 (en, ko), 218 (en), 501 (en), 682 (en) 533 - Updated carrier data for country calling code(s): 534 30 (en), 31 (en), 32 (en), 34 (en), 39 (en), 41 (en), 44 (en), 45 (en), 535 47 (en), 49 (en), 53 (en), 55 (en), 57 (en), 65 (en), 66 (en), 91 (en), 536 95 (en), 98 (en, fa), 212 (en), 226 (en), 233 (en), 235 (en), 237 (en), 537 241 (en), 242 (en), 243 (en), 262 (en), 297 (en), 350 (en), 351 (en), 538 353 (en), 354 (en), 358 (en), 359 (en), 373 (en), 385 (en), 386 (en), 539 420 (en), 423 (en), 508 (en), 590 (en), 673 (en), 855 (en), 886 (en), 540 966 (en), 973 (en), 974 (en), 994 (en), 996 (en) 541 - Updated / refreshed time zone meta data. 542 543Nov 13, 2019: v8.10.23 544Metadata changes: 545 - Updated phone metadata for region code(s): AL, AR, XK 546 - Updated carrier data for country calling code(s): 383 (en) 547 548Oct 29, 2019: v8.10.22 549Metadata changes: 550 - Updated phone metadata for region code(s): DM, DO, MM, OM, VN, ZM 551 - Updated short number metadata for region code(s): GR 552 - Updated carrier data for country calling code(s): 553 95 (en), 260 (en), 968 (en) 554 555Oct 16, 2019: v8.10.21 556Metadata changes: 557 - Updated phone metadata for region code(s): 558 BF, CI, HN, KW, MM, MY, SG, SI, TJ, ZW 559 - Updated geocoding data for country calling code(s): 52 (en), 95 (en) 560 - Updated carrier data for country calling code(s): 561 60 (en), 65 (en), 225 (en), 226 (en), 386 (en), 992 (en) 562 563Oct 02, 2019: v8.10.20 564Metadata changes: 565 - Updated phone metadata for region code(s): 566 AU, BO, CC, CX, DM, GM, HN, PH, US 567 - New geocoding data for country calling code(s): 1341 (en) 568 - Updated carrier data for country calling code(s): 220 (en) 569 - Updated / refreshed time zone meta data. 570 571Sep 17, 2019: v8.10.19 572Metadata changes: 573 - Updated phone metadata for region code(s): EH, GE, GR, HU, IL, IR, MA, US 574 - Updated short number metadata for region code(s): ET 575 - New geocoding data for country calling code(s): 1689 (en) 576 - Updated carrier data for country calling code(s): 31 (en), 995 (en) 577 - Updated / refreshed time zone meta data. 578 579Sep 03, 2019: v8.10.18 580Metadata changes: 581 - Updated phone metadata for region code(s): BR, HU, KG, KR, MV, SG, VN 582 - Updated short number metadata for region code(s): BR, IL 583 - Updated carrier data for country calling code(s): 65 (en), 996 (en) 584 585Aug 15, 2019: v8.10.17 586Metadata changes: 587 - MX numbering authority has changed dialling patterns to be more 588 uniform i.e additional domestic (01 and 044) and international 589 mobile tokens (1) are abolished now. The parsing and formatting 590 changes were done as part of this release. We recommend to 591 follow the steps mentioned in our announcement for same: 592 https://groups.google.com/forum/#!topic/libphonenumber-discuss/pecTIo_HpVE 593 - Updated phone metadata for region code(s): AM, MM, MX 594 - Updated short number metadata for region code(s): TH 595 - Updated carrier data for country calling code(s): 596 86 (en, zh, zh_Hant), 95 (en), 374 (en, ru) 597For users who depend on JavaScript port: 598 - Please patch in PR #2380 to fix AYTF output that otherwise 599 swallows the entered old mobile token (1) at the last step. 600Code changes: 601 - AsYouTypeFormatter changed to ensure that the output never adds new digits or swallows digits. 602 - MX mobile token no longer returned by getCountryMobileToken 603 604Aug 01, 2019: v8.10.16 605Metadata changes: 606 - Updated alternate formatting data for country calling code(s): 676 607 - Updated phone metadata for region code(s): 608 AU, CC, CL, CX, GB, IL, KW, MK, NE, TJ, TT, TW, VI 609 - Updated carrier data for country calling code(s): 610 56 (en), 61 (en), 65 (en), 227 (en), 972 (en), 992 (en), 1868 (en) 611 612Jul 15, 2019: v8.10.15 613Metadata changes: 614 - Updated alternate formatting data for country calling code(s): 676 615 - Updated phone metadata for region code(s): 616 AM, BG, EH, IR, IT, MA, MM, MT, SL, TO, UG, VA, VN 617 - New geocoding data for country calling code(s): 676 (en) 618 - Updated geocoding data for country calling code(s): 619 95 (en), 212 (en, fr), 232 (en), 374 (en, hy, ru) 620 - Updated carrier data for country calling code(s): 621 95 (en), 212 (en), 232 (en), 256 (en), 356 (en) 622 623Jun 13, 2019: v8.10.14 624Metadata changes: 625 - Updated phone metadata for region code(s): 626 BF, BJ, BR, IM, KE, KZ, MN, MX, PH, RE, VN 627 - Updated short number metadata for region code(s): FR 628 - Updated geocoding data for country calling code(s): 55 (en) 629 - Updated carrier data for country calling code(s): 630 7 (en, ru), 44 (en), 63 (en), 226 (en), 229 (en), 254 (en), 262 (en), 631 976 (en) 632 633May 29, 2019: v8.10.13 634Metadata changes: 635 - Updated phone metadata for region code(s): AU, CC, CI, CX, DE, HK 636 - Updated carrier data for country calling code(s): 61 (en), 225 (en) 637 638May 10, 2019: v8.10.12 639Metadata changes: 640 - Updated phone metadata for region code(s): CL, HK, MU, NE 641 - Updated carrier data for country calling code(s): 230 (en) 642 643Apr 30, 2019: v8.10.11 644Metadata changes: 645 - Updated phone metadata for region code(s): CU, EH, MA 646 - Updated short number metadata for region code(s): CU 647 - Updated geocoding data for country calling code(s): 53 (en) 648 649Apr 15, 2019: v8.10.10 650Metadata changes: 651 - Updated phone metadata for region code(s): 652 BW, CL, DE, ET, IN, NG, PF, TW, VN 653 - Updated short number metadata for region code(s): KI 654 - Updated geocoding data for country calling code(s): 655 251 (en), 267 (en), 886 (en, zh, zh_Hant) 656 - Updated carrier data for country calling code(s): 234 (en), 689 (en) 657 - Updated / refreshed time zone meta data. 658 659Apr 02, 2019: v8.10.9 660Metadata changes: 661 - Updated alternate formatting data for country calling code(s): 380, 44, 49 662 - Updated phone metadata for region code(s): AU, BD, CC, CN, CX, EC, ID, PE 663 - Updated carrier data for country calling code(s): 51 (en), 593 (en) 664 665Mar 19, 2019: v8.10.8 666* Code changes 667 - Making the application of alternate formats when finding phone numbers in 668 text in strict-grouping and exact-match mode depend on the leading digits 669 for each rule. This was always assumed but never actually done. This means 670 that the false positive rate will decrease but also that more valid numbers 671 are skipped. A subsequent CL will update patterns to increase recall. 672Metadata changes: 673 - Updated alternate formatting data for country calling code(s): 674 255, 27, 31, 34, 351, 352, 358, 359, 36, 372, 380, 381, 385, 39, 43, 44, 49, 675 506, 52, 54, 55, 595, 61, 62, 64, 66, 675, 676, 679, 7, 81, 84, 856, 90, 91, 676 94, 95, 971, 972, 995 677 - Updated phone metadata for region code(s): 678 AC, AU, CC, CN, CX, EH, GE, JM, JP, KE, KG, MA, NO, PH, SJ, UA, UZ, ZW 679 - Updated short number metadata for region code(s): TW 680 - New carrier data for country calling code(s): 1658 (en) 681 - Updated carrier data for country calling code(s): 682 65 (en), 380 (en, uk), 996 (en), 1876 (en) 683 684Mar 06, 2019: v8.10.7 685Metadata changes: 686 - Updated phone metadata for region code(s): BD, BH, HN, MM, PH, ZW 687 - Updated geocoding data for country calling code(s): 90 (en, tr), 95 (en) 688 - Updated carrier data for country calling code(s): 63 (en), 64 (en) 689 690Feb 21, 2019: v8.10.6 691Metadata changes: 692 - Updated phone metadata for region code(s): 693 CN, IR, JM, KE, KR, KZ, LI, VN 694 - Updated geocoding data for country calling code(s): 86 (en, zh) 695 - Updated carrier data for country calling code(s): 696 84 (en), 86 (en, zh, zh_Hant), 423 (en) 697 - Updated / refreshed time zone meta data. 698 699Feb 06, 2019: v8.10.5 700Metadata changes: 701 - Updated phone metadata for region code(s): 702 AE, AG, AI, AM, AR, AS, AT, AU, AZ, BA, BB, BE, BG, BM, BO, BR, BS, BT, BW, 703 BY, CG, CH, CL, CO, DE, DM, DZ, ES, FI, FR, GB, GD, GE, GR, GU, HN, HR, IE, 704 IL, IN, IT, JM, JO, JP, KG, KN, KP, KR, KY, LC, LI, LK, LT, LU, MA, MC, MD, 705 MG, MM, MP, MS, MU, MV, MW, MX, MY, NA, NC, NE, NF, NL, NO, NZ, PE, PH, PL, 706 PY, RO, RU, SA, SB, SC, SE, SG, SI, SK, SM, SN, SO, SR, SX, TC, TJ, TM, TO, 707 TR, TT, TZ, UG, UY, VC, VG, VI, VN, XK, ZM, ZW 708 - Updated short number metadata for region code(s): BR, TH 709 - Updated geocoding data for country calling code(s): 54 (en), 55 (en, pt) 710 - Updated carrier data for country calling code(s): 55 (en) 711 - Updated / refreshed time zone meta data. 712 713Jan 24, 2019: v8.10.4 714Metadata changes: 715 - Updated phone metadata for region code(s): 716 AR, AT, BH, BI, CL, CN, CW, CZ, DE, FI, FM, HK, KR, LA, LU, ML, NC, NE, PA, 717 SB, TT, ZW 718 - Updated short number metadata for region code(s): AR, KR 719 - Updated geocoding data for country calling code(s): 54 (en, es), 686 (en) 720 - Updated carrier data for country calling code(s): 721 254 (en), 507 (en), 599 (en), 880 (en) 722 723Jan 08, 2019: v8.10.3 724Code changes: 725 - Better documentation for getLengthOfNationalDestinationCode to emphasise that 726 not every number has one. 727 - Removed unused code in the AsYouTypeFormatter: We no longer have numbers in 728 formatting matching patterns, only \d. 729Metadata changes: 730 - Updated phone metadata for region code(s): 731 EG, GM, HK, LR, MM, NG, SD, UZ, VN, VU 732 - Updated geocoding data for country calling code(s): 249 (en) 733 - Updated carrier data for country calling code(s): 734 84 (en), 95 (en), 220 (en), 231 (en), 852 (en, zh, zh_Hant), 965 (ar) 735 - Updated / refreshed time zone meta data. 736 737Dec 06, 2018: v8.10.2 738Metadata changes: 739 - Updated phone metadata for region code(s): 740 882, AE, AL, AR, BD, BR, CN, ID, IN, JM, LK, MG, MU, MX, OM, SI, UA, ZW 741 - Updated short number metadata for region code(s): IN, MG, MX, SI 742 - Updated geocoding data for country calling code(s): 52 (en, es), 261 (en) 743 - Updated carrier data for country calling code(s): 744 66 (en), 91 (en), 386 (en), 968 (en) 745 - Updated / refreshed time zone meta data. 746 747Nov 21, 2018: v8.10.1 748Metadata changes: 749 - Updated phone metadata for region code(s): 750 AE, AL, AT, AX, BW, BY, CC, CL, CN, CX, DE, FI, FR, GB, GG, HN, IM, IN, IR, 751 JE, LA, LI, LT, MM, MN, MY, NZ, PK, SE, SK, SM, UZ, VN, ZM, ZW 752 - Updated short number metadata for region code(s): 753 AT, AX, BY, CF, CL, DE, ER, FI, FM, FR, GA, IN, IR, LI, LT, MM, MN, MY, NE, 754 NZ, OM, PK, SE, SM, UZ, ZA, ZM, ZW 755 - Updated geocoding data for country calling code(s): 756 33 (en), 43 (de, en), 49 (en), 52 (en), 60 (en), 64 (en), 91 (en), 263 (en), 757 358 (en, sv), 370 (en) 758 - Updated carrier data for country calling code(s): 759 44 (en), 56 (en), 60 (en), 64 (en), 84 (en), 91 (en), 92 (en), 95 (en), 760 98 (en, fa), 260 (en), 267 (en), 358 (en), 370 (en), 423 (en), 976 (en), 761 998 (en) 762 - Updated / refreshed time zone meta data. 763 764Oct 31, 2018: v8.10.0 765Code changes: 766 - AsYouTypeFormatter changed to better choose between rules when dialling 767 locally; previously we used the international rules when the national prefix 768 was present since this would exclude the local-only rules. However, there are 769 some numbers that are not internationally diallable that *do* use the 770 national prefix, and this logic precluded formatting them correctly. 771Metadata changes: 772 - Updated phone metadata for region code(s): 773 AU, BB, BD, BO, CC, CO, CR, CU, CX, EC, EG, ER, ET, FO, GB, GE, GG, GH, GQ, 774 HR, HU, IE, IL, IM, IN, IQ, JE, KE, KG, KH, KI, KP, KZ, LA, LI, LK, LR, LU, 775 LY, MC, ME, MK, ML, MM, MU, NE, NF, NG, NO, NP, PE, PF, PG, PH, PL, PS, PY, 776 RS, RU, SA, SD, SE, SI, SJ, SL, SO, SY, TJ, TM, TR, TW, UA, UG, UY, VA, VE, 777 VN, VU, YE, ZM 778 - Updated short number metadata for region code(s): 779 AU, BB, BD, BO, CC, CO, CR, CU, CX, EC, EG, ER, ET, FO, GB, GE, GG, GH, HR, 780 HU, IE, IL, IM, IQ, JE, KE, KG, KH, KI, KP, KZ, LA, LK, LU, LY, ME, MK, ML, 781 MU, NE, NF, NG, NO, NP, PE, PF, PG, PH, PL, PS, PY, RS, RU, SA, SD, SI, SJ, 782 SL, SO, SY, TJ, TR, TW, UA, UG, UY, VE, YE 783 - Updated geocoding data for country calling code(s): 784 7 (en, ru), 44 (en), 47 (en), 58 (en, es), 61 (en), 90 (en, tr), 94 (en), 785 218 (en), 223 (en), 227 (en), 230 (en), 233 (en), 240 (en), 249 (en), 786 251 (en), 252 (en), 254 (en), 352 (de, en, fr), 380 (en, uk), 382 (en), 787 675 (en), 880 (en), 886 (en, zh, zh_Hant), 992 (en), 996 (en) 788 - Updated carrier data for country calling code(s): 789 7 (en, ru), 44 (en), 51 (en), 57 (en), 61 (en), 63 (en), 90 (en), 223 (en), 790 230 (en), 232 (en), 233 (en), 234 (en), 240 (en), 252 (en), 254 (en), 791 256 (en), 260 (en), 352 (en), 385 (en), 386 (en), 389 (en), 506 (en), 792 593 (en), 595 (en), 886 (en), 963 (en), 972 (en), 992 (en), 995 (en), 793 996 (en) 794 - Updated / refreshed time zone meta data. 795 796Oct 16, 2018: v8.9.16 797Metadata changes: 798 - Updated phone metadata for region code(s): 799 AF, AO, BA, BB, BG, BM, BS, BT, CA, CN, DM, DO, GD, GU, HN, ID, IL, JM, KE, 800 KR, KY, LC, MP, TT, US, VG, VI 801 - Updated short number metadata for region code(s): 802 AC, AG, AI, AO, AS, BA, BB, BG, BH, BM, BS, BT, CA, CH, DM, DO, EE, GD, GI, 803 GU, ID, IS, JM, KN, KY, LC, MP, MS, PR, SX, TC, TH, TT, US, VC, VG, VI 804 - Updated geocoding data for country calling code(s): 805 62 (en), 244 (en, pt), 247 (en), 359 (bg, en), 387 (bs, en, sr), 1 (en) 806 - New carrier data for country calling code(s): 380 (uk) 807 - Updated carrier data for country calling code(s): 808 62 (en), 91 (en), 387 (en), 975 (en), 1 (en) 809 - Updated / refreshed time zone meta data. 810 811Oct 03, 2018: v8.9.15 812Metadata changes: 813 - Updated phone metadata for region code(s): 814 AE, AF, AL, AM, AX, AZ, BE, CD, CH, CL, EH, FI, GQ, HN, JO, JP, LB, LR, MW, 815 NL, OM, RE, RO, SE, TZ, VA, YT, ZA, ZW 816 - Updated short number metadata for region code(s): AE, AF, AL, AM, AZ 817 - Updated geocoding data for country calling code(s): 818 263 (en), 355 (en), 374 (en, hy, ru), 380 (en) 819 - Updated carrier data for country calling code(s): 820 32 (en), 84 (en), 240 (en), 374 (en, ru), 994 (en) 821 822Sep 18, 2018: v8.9.14 823Metadata changes: 824 - Updated phone metadata for region code(s): 825 AO, EE, HN, IL, IN, MY, SB, UG, VN 826 - Updated carrier data for country calling code(s): 827 IN, RO, SB, TZ 828 - Updated / refreshed time zone meta data. 829 830Sep 05, 2018: v8.9.13 831Metadata changes: 832 - Updated phone metadata for region code(s): 833 BD, BE, CZ, KR, MU, NA, NL, PG, VN 834 - Updated carrier data for country calling code(s): 835 32 (en), 60 (en), 62 (en), 84 (en), 241 (en), 264 (en), 357 (en), 675 (en), 836 678 (en), 973 (en) 837 838Aug 21, 2018: v8.9.12 839Code changes: 840 - Support Russian extension character "доб" as a valid one while parsing 841 the numbers. 842Metadata changes: 843 - Updated phone metadata for region code(s): 844 AU, BD, CC, CL, CX, FR, GI, IN, MY, NL, SA, US, VN 845 - Updated short number metadata for region code(s): MY 846 - New geocoding data for country calling code(s): 1640 (en) 847 - Updated geocoding data for country calling code(s): 880 (en) 848 - Updated carrier data for country calling code(s): 849 33 (en), 84 (en), 91 (en), 350 (en), 880 (en) 850 851Jul 25, 2018: v8.9.11 852Metadata changes: 853 - Updated phone metadata for region code(s): 854 AU, CC, CX, HK, IT, KE, KW, MM, NL, LU, VA 855 - Updated short number metadata for region code(s): 856 HK 857 - New geocoding data for country calling code(s): 1975 (en) 858 - Updated geocoding data for country calling code(s): 39 (en, it) 859 - Updated carrier data for country calling code(s): 860 254 (en), 351 (en), 852 (en, zh, zh_Hant) 861 862Jul 10, 2018: v8.9.10 863Metadata changes: 864 - Updated phone metadata for region code(s): AT, GB, IN, KE, MM, VN 865 - Updated short number metadata for region code(s): EE, IN, ZW 866 - Updated geocoding data for country calling code(s): 95 (en) 867 - Updated carrier data for country calling code(s): 91 (en), 254 (en) 868 - Updated / refreshed time zone meta data. 869 870Jun 26, 2018: v8.9.9 871Metadata changes: 872 - Updated phone metadata for region code(s): KG, NU, SE, VN 873 - Updated short number metadata for region code(s): AL, AR, EE, FR, NU, ZW 874 - New geocoding data for country calling code(s): 996 (en) 875 - Updated geocoding data for country calling code(s): 52 (es) 876 - Updated carrier data for country calling code(s): 58 (en), 996 (en) 877 - Updated / refreshed time zone meta data. 878 879Jun 13, 2018: v8.9.8 880Metadata changes: 881 - Updated phone metadata for region code(s): 882 AG, AI, AS, BB, BL, BM, BS, CA, CI, DM, DO, GD, GF, GP, GU, IL, JM, KN, KY, 883 LC, MF, MP, MQ, MS, PR, SE, SX, TC, TT, US, VC, VG, VI, VN 884 - Updated short number metadata for region code(s): 885 AL, AU, FR, KE, NZ, TH, UA, ZA 886 - New geocoding data for country calling code(s): 385 (en), 880 (en) 887 - Updated geocoding data for country calling code(s): 27 (en), 225 (en) 888 - Updated carrier data for country calling code(s): 889 84 (en), 225 (en), 380 (en), 385 (en), 886 (en), 972 (en) 890 891May 29, 2018: v8.9.7 892Metadata changes: 893 - Updated phone metadata for region code(s): 894 AX, BI, FI, HK, IR, ME, MO, NL, RE, UG, YT 895 - Updated short number metadata for region code(s): AR, ME, PM, ZA 896 - New geocoding data for country calling code(s): 60 (en), 380 (uk), 382 (en) 897 - Updated geocoding data for country calling code(s): 898 267 (en), 380 (en), 504 (en) 899 - Updated carrier data for country calling code(s): 900 257 (en), 262 (en), 380 (en), 852 (en, zh, zh_Hant), 853 (en) 901 902May 15, 2018: v8.9.6 903Metadata changes: 904 - Updated phone metadata for region code(s): IL, IN, NO, TR 905 - Updated short number metadata for region code(s): FR, TR 906 - New geocoding data for country calling code(s): 1445 (en) 907 - Updated geocoding data for country calling code(s): 1345 (en) 908 - Updated carrier data for country calling code(s): 909 91 (en), 972 (en), 1869 (en) 910 911May 02, 2018: v8.9.5 912Metadata changes: 913 - Updated phone metadata for region code(s): 914 AD, AR, EC, FR, HK, IN, KG, LA, ML, PA, SD, SL, TH, TN, US, VI, WS 915 - Updated short number metadata for region code(s): HK, WS 916 - New geocoding data for country calling code(s): 1820 (en) 917 - Updated geocoding data for country calling code(s): 54 (en, es) 918 - Updated carrier data for country calling code(s): 919 30 (en), 91 (en), 93 (fa), 223 (en), 232 (en), 249 (en), 374 (ru), 685 (en), 920 852 (en, zh, zh_Hant), 995 (en), 996 (en), 1649 (en) 921 922Apr 17, 2018: v8.9.4 923Code changes: 924 - Update formatNumberForMobileDialing() to return international format instead of national format for Uzbek phone numbers. 925Metadata changes: 926 - Updated phone metadata for region code(s): 927 AG, AM, BR, CN, EC, GE, IN, IS, MX, MY, NE, PA, PY, SZ, TO, VC, ZW 928 - Updated short number metadata for region code(s): BD 929 - Updated geocoding data for country calling code(s): 268 (en) 930 - Updated carrier data for country calling code(s): 931 91 (en), 354 (en), 507 (en), 593 (en), 595 (en), 995 (en), 1268 (en), 932 1284 (en) 933 934Apr 04, 2018: v8.9.3 935Metadata changes: 936 - Updated phone metadata for region code(s): 937 AF, AM, BE, BF, CG, DE, EH, GP, IN, IR, KE, MA, ML, MV, TG, TR, TV 938 - Updated short number metadata for region code(s): BE 939 - New carrier data for country calling code(s): 688 (en) 940 - Updated carrier data for country calling code(s): 941 91 (en), 93 (en), 212 (en), 223 (en), 226 (en), 254 (en), 385 (en) 942 943Mar 13, 2018: v8.9.2 944Metadata changes: 945 - Updated phone metadata for region code(s): CA, IN, KG, PA, SL 946 - Updated carrier data for country calling code(s): 947 91 (en), 232 (en), 996 (en) 948 949Mar 06, 2018: v8.9.1 950Metadata changes: 951 - Updated phone metadata for region code(s): CL, FR, HK, IN, MU, MY 952 - Updated carrier data for country calling code(s): 953 91 (en), 225 (en), 230 (en) 954 955Feb 20, 2018: v8.9.0 956Code changes: 957 - Ported ShortNumberInfo to Javascript. 958Metadata changes: 959 - Updated phone metadata for region code(s): 960 BD, BJ, CI, CN, IN, KW, SD, TG, TR, US 961 - New geocoding data for country calling code(s): 1279 (en) 962 - Updated carrier data for country calling code(s): 963 90 (en), 91 (en), 225 (en), 228 (en), 229 (en), 249 (en), 976 (en) 964 - Updated / refreshed time zone meta data. 965 966Feb 06, 2018: v8.8.11 967Metadata changes: 968 - New phone metadata for region code(s): XK 969 - Updated phone metadata for region code(s): BE, CV, ET, GW, HK, IN, MW, TT 970 - New short number metadata for region code(s): XK 971 - Updated short number metadata for region code(s): IS, ZA 972 - New geocoding data for country calling code(s): 383 (en, sq, sr) 973 - New carrier data for country calling code(s): 383 (en) 974 - Updated carrier data for country calling code(s): 975 32 (en), 91 (en), 238 (en), 245 (en), 251 (en) 976 977Jan 23, 2018: v8.8.10 978Metadata changes: 979 - Updated phone metadata for region code(s): 980 BJ, DE, HK, IN, IR, MM, MY, PW, SA, SI 981 - New geocoding data for country calling code(s): 680 (en) 982 - Updated geocoding data for country calling code(s): 966 (ar, en) 983 - New carrier data for country calling code(s): 34 (en), 680 (en) 984 - Updated carrier data for country calling code(s): 985 41 (en), 91 (en), 95 (en), 98 (en, fa), 229 (en), 250 (en), 381 (en), 986 386 (en), 852 (en, zh, zh_Hant) 987 988Jan 09, 2018: v8.8.9 989Metadata changes: 990 - Updated phone metadata for region code(s): 991 AG, AI, AS, AX, BA, BB, BL, BM, BS, CA, CC, CN, CX, DM, DO, FI, FJ, GD, GF, 992 GP, GR, GU, HK, ID, IN, IS, JM, KN, KY, LC, MF, MK, MP, MQ, MS, NL, NP, NZ, 993 PM, PR, RE, RO, SX, TC, TG, TT, US, VC, VG, VI, YT, ZM, ZW 994 - Updated short number metadata for region code(s): GB, GG, JE, ZW 995 - New geocoding data for country calling code(s): 387 (bs, en, hr, sr) 996 - Updated geocoding data for country calling code(s): 997 31 (en, nl), 61 (en), 263 (en), 381 (sr) 998 - New carrier data for country calling code(s): 502 (en) 999 - Updated carrier data for country calling code(s): 1000 30 (en), 40 (en), 86 (en, zh, zh_Hant), 91 (en), 228 (en), 262 (en), 1001 354 (en), 355 (en), 359 (en), 386 (en), 387 (en), 389 (en), 508 (en), 1002 590 (en), 594 (en), 596 (en), 977 (en) 1003 1004Dec 06, 2017: v8.8.8 1005Metadata changes: 1006 - Updated phone metadata for region code(s): JM, MY 1007 - Updated short number metadata for region code(s): US, ZA 1008 - Updated carrier data for country calling code(s): 1009 86 (en, zh, zh_Hant), 98 (en, fa) 1010 1011Nov 28, 2017: v8.8.7 1012Build changes: 1013 - C++ library can now be built as 32- and 64-bit RPMs (#643). 1014Metadata changes: 1015 - Updated phone metadata for region code(s): 1016 AX, CC, CX, EH, FI, GU, HK, IN, IR, MA, SM, ZM 1017 - Updated short number metadata for region code(s): AU, HR 1018 - Updated carrier data for country calling code(s): 1019 7 (en, ru), 27 (en), 91 (en), 212 (en), 852 (en, zh, zh_Hant) 1020 1021Nov 14, 2017: v8.8.6 1022Metadata changes: 1023 - Updated alternate formatting data for country calling code(s): 1024 34, 62, 91, 94, 971, 972 1025 - Updated phone metadata for region code(s): 1026 AE, AR, AU, BB, BN, BR, BW, BY, BZ, CC, CL, CW, CX, DE, EC, EG, ET, GB, GE, 1027 GG, GP, HK, HR, ID, IE, IL, IN, JO, KH, LK, LU, LV, LY, MG, MO, MR, MY, NL, 1028 NR, OM, PH, PK, PM, PS, RE, RU, RW, SA, SE, SG, SH, SK, SM, TH, TJ, UZ, VN, 1029 ZM, ZW 1030 - New geocoding data for country calling code(s): 61 (en) 1031 - Updated geocoding data for country calling code(s): 20 (en) 1032 - New carrier data for country calling code(s): 674 (en) 1033 - Updated carrier data for country calling code(s): 1034 61 (en), 91 (en), 234 (en), 593 (en), 1246 (en) 1035 - Updated / refreshed time zone meta data. 1036 1037Oct 30, 2017: v8.8.5 1038Metadata changes: 1039 - Updated phone metadata for region code(s): AW, CA, CN, MV, NL, TR, UG 1040 - Updated short number metadata for region code(s): TR 1041 - Updated carrier data for country calling code(s): 1042 86 (en, zh, zh_Hant), 297 (en) 1043 1044Oct 16, 2017: v8.8.4 1045Build changes: 1046 - C++ geocoding build tools now use readdir, since readdir_r is deprecated. 1047 - Update the protobuf-java dependency used to build the C++ metadata from 2.5.0 1048 to 3.0.0. This is an internal change and does not affect the users of the 1049 library. 1050Metadata changes: 1051 - Updated phone metadata for region code(s): AL, BS, FJ, JM, PH, US 1052 - Updated short number metadata for region code(s): KZ 1053 - New geocoding data for country calling code(s): 1726 (en) 1054 - Updated geocoding data for country calling code(s): 1242 (en) 1055 - Updated carrier data for country calling code(s): 1056 20 (en), 679 (en), 1242 (en) 1057 1058Oct 03, 2017: v8.8.3 1059Metadata changes: 1060 - Updated phone metadata for region code(s): BS, FJ, IR, KR 1061 - Updated short number metadata for region code(s): KR 1062 - Updated carrier data for country calling code(s): 1063 380 (en), 381 (en), 679 (en), 1242 (en) 1064 1065Sep 19, 2017: v8.8.2 1066Metadata changes: 1067 - Updated phone metadata for region code(s): 1068 CA, CR, EG, FI, HN, IS, KM, KR, LU, MV, PA, TW, UG, US, VN 1069 - Updated short number metadata for region code(s): IE, IR, KE, TR 1070 - New geocoding data for country calling code(s): 1223 (en) 1071 - Updated geocoding data for country calling code(s): 84 (en, vi) 1072 - Updated carrier data for country calling code(s): 20 (en) 1073 1074Sep 05, 2017: v8.8.1 1075Metadata changes: 1076 - Updated phone metadata for region code(s): 1077 AL, AR, AT, AU, AX, AZ, BO, BR, CN, CO, DE, EG, FI, GB, GL, GW, ID, IE, IL, 1078 IM, IN, JP, KI, KR, KW, LB, LI, LU, MV, MW, NA, NE, NG, PK, PY, SE, SI, SK, 1079 SO, SR, TJ, TW, UA, UG, US, VN, ZW 1080 - Updated short number metadata for region code(s): KR 1081 - New geocoding data for country calling code(s): 380 (en), 1838 (en) 1082 - Updated geocoding data for country calling code(s): 84 (en, vi), 686 (en) 1083 - Updated carrier data for country calling code(s): 1084 60 (en), 380 (en), 597 (en), 686 (en) 1085 1086Aug 21, 2017: v8.8.0 1087Code changes: 1088 - Improve parsing logic to be smarter about national-prefix detection & 1089 stripping based on possible-lengths (IS_POSSIBLE_LOCAL_ONLY and 1090 INVALID_LENGTH). Enables e.g. adding Iran short-codes starting with "096" 1091 without the need to hack IR's national prefix parsing config. 1092 - Logging changes: Don't log client-provided phone numbers. 1093 - Add constants for C++ PhoneNumberUtil enums' max values. 1094Metadata changes: 1095 - Updated phone metadata for region code(s): 1096 AX, BF, BG, DM, EG, FI, IN, IR, KY, KZ, LC, MT, NI, PL, RU, SZ, TH, US, VC 1097 - Updated short number metadata for region code(s): BA, IR, PL, RU, TH, ZA 1098 - New geocoding data for country calling code(s): 52 (es), 1986 (en) 1099 - Updated geocoding data for country calling code(s): 52 (en), 268 (en) 1100 - New carrier data for country calling code(s): 1345 (en) 1101 - Updated carrier data for country calling code(s): 1102 20 (en), 226 (en), 268 (en), 356 (en), 505 (en), 1441 (en), 1758 (en), 1103 1767 (en), 1784 (en) 1104 1105Aug 02, 2017: v8.7.1 1106Code changes: 1107 - Documentation fix for getNumberType 1108Metadata changes: 1109 - Updated phone metadata for region code(s): 1110 AG, AM, BJ, BO, CL, EE, EG, GD, HK, IN, KE, KW, LK, US 1111 - Updated short number metadata for region code(s): BJ, EE, EG, IN, KW 1112 - New geocoding data for country calling code(s): 1564 (en) 1113 - New carrier data for country calling code(s): 1268 (en) 1114 - Updated carrier data for country calling code(s): 1115 56 (en), 254 (en), 374 (en), 852 (en, zh, zh_Hant), 1473 (en) 1116 - Updated / refreshed time zone meta data. 1117 1118Jul 18, 2017: v8.7.0 1119Code changes: 1120 - New method getSupportedCallingCodes() API to return all the calling codes 1121 that the library considers valid, both for geographical and non-geographical 1122 entities. 1123 - Added isSmsServiceForRegion(PhoneNumber, RegionCode) API in C++ and Java 1124 short number info libraries. An SMS service is where the primary or only 1125 intended usage is to receive and/or send text messages (SMSs). This includes 1126 MMS as MMS numbers downgrade to SMS if the other party isn't MMS-capable. The 1127 is_sms_service metadata is also serialized for the first time. JS is not 1128 affected because it doesn't have short numbers. 1129 - Documentation update for private variables VALID_PUNCTUATION and 1130 SINGLE_INTERNATIONAL_PREFIX, also renaming the latter from 1131 UNIQUE_INTERNATIONAL_PREFIX. 1132 - [Java only] Changing public APIs that take in strings representing phone 1133 numbers or parts of phone numbers to take in CharSequence instead. Updating 1134 some of the internal methods to do the same. This affects ShortNumberInfo and 1135 PhoneNumberUtil, namely the following methods: 1136 - parse & parseAndKeepRawInput 1137 - formatWithCarrierCode & formatWithPreferredCarrierCode 1138 - isNumberMatch 1139 - isPossibleNumber 1140 - isAlphaNumber 1141 - normalizeDigitsOnly & normalizeDiallableCharsOnly 1142 - [C++ only] Removing most of the "using std::*" statements in 1143 phonenumberutil.h file, leaving only using std::string. Changing the .cc and 1144 test files to prefix "std::" where this was missing. 1145Metadata changes: 1146 - New alternate formatting data for country calling code(s): 856 1147 - Updated phone metadata for region code(s): 1148 BF, FI, GG, HK, IM, JE, KG, LA, MX, MY, PS, SA, VN, ZW 1149 - New short number metadata for region code(s): PS 1150 - Updated short number metadata for region code(s): TR, ZA 1151 - New geocoding data for country calling code(s): 52 (en), 976 (en) 1152 - Updated geocoding data for country calling code(s): 1153 84 (en, vi), 223 (en), 358 (en, fi, sv) 1154 - Updated carrier data for country calling code(s): 1155 40 (en), 44 (en), 91 (en), 226 (en), 966 (en), 996 (en) 1156 - Updated / refreshed time zone meta data. 1157 1158Jul 04, 2017: v8.6.0 1159Code changes: 1160 - Removing leading_zero_possible from the metadata and all the places it is 1161 referenced in the build and prod code. Will be removed from the metadata 1162 proto itself in a subsequent release. This should not affect users of the 1163 library - the only place it was used was FormatInOriginalFormat, and only 1164 initially to try and avoid modifying the input number by removing/adding 1165 digits inadvertently. Now this is checked at the end of the method anyway. 1166 However slight formatting differences with this method on invalid numbers 1167 starting with 0s may be noticed in some countries. 1168 - Bug fix for Javascript: getNationalSignificantNumber used to print the string 1169 "null" for empty phone number objects, now it returns an empty string. 1170 - Updated the documentation for the isNumberGeographical API. 1171 - Small comment improvements for parse() method to point users at 1172 parseAndKeepRawInput(). 1173 - Added a new enum for CountryCodeSource called UNSPECIFIED. This is used as a 1174 default value, and will be returned if someone calls parse() and then 1175 getCountryCodeSource() on the result. If users want an actual value for this 1176 then they should call parseAndKeepRawInput() instead; the values that were 1177 previously returned after calling this method will not change. 1178 - Deletion of the possible number pattern in the phonemetadata.proto file and 1179 all generated code. This has not been used for a long time. 1180Metadata changes: 1181 - Updated phone metadata for region code(s): AU, IL, IM, IN, KE, MM, PM, UA 1182 - Updated geocoding data for country calling code(s): 95 (en) 1183 - New carrier data for country calling code(s): 508 (en) 1184 - Updated carrier data for country calling code(s): 1185 95 (en), 254 (en), 972 (en) 1186 1187Jun 20, 2017: v8.5.2 1188Metadata changes: 1189 - New alternate formatting data for country calling code(s): 64 1190 - Updated phone metadata for region code(s): 1191 AL, AX, BR, CM, FI, GE, GI, IE, IN, IR, JO, LA, LR, MK, NZ, PK, SI, TL, UA 1192 - Updated short number metadata for region code(s): IR, TH, ZA 1193 - New carrier data for country calling code(s): 503 (en) 1194 - Updated carrier data for country calling code(s): 1195 91 (en), 213 (en), 386 (en), 389 (en), 509 (en), 995 (en) 1196 1197Jun 06, 2017: v8.5.1 1198Metadata changes: 1199 - Updated phone metadata for region code(s): 1200 BA, BL, GB, GF, GP, GU, KW, MF, PG, PL, RE, VN, YT, ZW 1201 - Updated short number metadata for region code(s): IR, PG 1202 - Updated geocoding data for country calling code(s): 1203 84 (en, vi), 263 (en), 675 (en) 1204 - New carrier data for country calling code(s): 262 (en), 590 (en), 594 (en) 1205 - Updated carrier data for country calling code(s): 1206 48 (en), 387 (en), 675 (en), 1 (en) 1207 1208May 23, 2017: v8.5.0 1209Code changes: 1210 - Add canBeInternationallyDialled() public API in Java and C++ PhoneNumberUtil. 1211 This was already in JS. 1212Build changes: 1213 - When compiling binary metadata from XML metadata, we no longer set the 1214 national number pattern to "NA" for non-existent data. 1215Metadata changes: 1216 - Updated phone metadata for region code(s): BF, GB, IL, IM, MQ, SL, US, VN 1217 - Updated short number metadata for region code(s): BO, BR 1218 - Updated geocoding data for country calling code(s): 1 (en), 84 (en, vi) 1219 - New carrier data for country calling code(s): 596 (en) 1220 - Updated carrier data for country calling code(s): 232 (en), 972 (en) 1221 1222May 10, 2017: v8.4.3 1223Metadata changes: 1224 - Updated phone metadata for region code(s): 1225 AX, BF, CG, FI, GG, GH, GI, IM, IR, JE, JM, VN 1226 - Updated short number metadata for region code(s): AX, BR, FI, GI, HK 1227 - Updated geocoding data for country calling code(s): 84 (en), 233 (en) 1228 - Updated carrier data for country calling code(s): 1229 233 (en), 358 (en), 1876 (en) 1230 1231Apr 25, 2017: v8.4.2 1232Code changes: 1233 - Small fix for possible out-of-bounds exception on RFC3966 input where no 1234 phone context was actually provided. 1235Metadata changes: 1236 - Updated phone metadata for region code(s): BF, ET, IN, KE, LU, VN 1237 - Updated short number metadata for region code(s): KE 1238 - Updated carrier data for country calling code(s): 1239 84 (en), 91 (en), 226 (en), 251 (en), 254 (en), 352 (en) 1240 1241Apr 11, 2017: v8.4.1 1242Code changes: 1243 - Changing isPossibleWithReason to return the enums INVALID_LENGTH and 1244 IS_POSSIBLE_LOCAL_ONLY, where these apply. isPossibleNumber continues to 1245 consider IS_POSSIBLE or IS_POSSIBLE_LOCAL_ONLY numbers as possible to dial. 1246 Announcement: https://groups.google.com/d/msg/libphonenumber-discuss/sPhYzdzFCmg/6tYsS1f6DgAJ 1247 - Doc updates for getRegionCodeForNumber to clarify that it does not 1248 work for short-codes or invalid numbers. 1249Metadata changes: 1250 - Updated phone metadata for region code(s): 1251 AF, AL, CI, CL, DE, HT, IL, MP, VN 1252 - Updated short number metadata for region code(s): CZ, DE 1253 - Updated geocoding data for country calling code(s): 84 (en, vi) 1254 - Updated carrier data for country calling code(s): 1255 84 (en), 93 (en), 225 (en), 509 (en), 972 (en) 1256 - Updated / refreshed time zone meta data. 1257 1258Mar 28, 2017: v8.4.0 1259Code changes: 1260 - Doc changes to update references to ISO country codes to CLDR region codes, 1261 which are what we actually use. Notice in some of the mapper files the 1262 country code is still the ISO one, because it's used as part of a description 1263 of a language only (e.g. zh-TW vs zh-CN). Edited the language comments there 1264 since they can be two *or* three letters (c.f. fil for filipino). Also edited 1265 the comment for leadingDigits at the territory level in the 1266 phonemetadata.proto file. 1267 - New API methods: isPossibleNumberForType and 1268 isPossibleNumberForTypeWithReason, along with getSupportedTypesForRegion and 1269 getSupportedTypesForNonGeoEntity. These allow you to query which types (e.g. 1270 Mobile) exist for a particular region, and work out if a number is possible 1271 for that type (this is a simple length check) rather than for the region as a 1272 whole. 1273Metadata changes: 1274 - Updated phone metadata for region code(s): BF, FJ, GB, HK, HT, IN, RO 1275 - Updated short number metadata for region code(s): BR, IN, RO, TR 1276 - Updated geocoding data for country calling code(s): 82 (hi, iw, tr) 1277 - Updated carrier data for country calling code(s): 1278 226 (en), 509 (en), 593 (en), 679 (en) 1279 1280Mar 14, 2017: v8.3.3 1281Code changes: 1282 - Doc fix for PhoneNumberOfflineGeocoder to explain the cases where an empty 1283 string might be returned. 1284Metadata changes: 1285 - Updated phone metadata for region code(s): 1286 AG, AI, AS, BB, BF, BM, BQ, BS, BW, CA, DM, DO, ES, GD, GU, HK, HR, IN, JM, 1287 JO, KN, KY, LC, ME, MP, MS, MX, PH, PR, SR, SX, TC, TH, TT, US, VC, VG, VI 1288 - Updated short number metadata for region code(s): ES, HR 1289 - Updated geocoding data for country calling code(s): 1290 34 (en, es), 84 (vi), 91 (en) 1291 - New carrier data for country calling code(s): 264 (en) 1292 - Updated carrier data for country calling code(s): 1293 55 (en), 63 (en), 66 (en), 91 (en), 233 (en), 599 (en) 1294 1295Feb 28, 2017: v8.3.2 1296Metadata changes: 1297 - Updated phone metadata for region code(s): BS, CI, HT, IL, IN, IS, KE, SK 1298 - Updated short number metadata for region code(s): KE 1299 - Updated geocoding data for country calling code(s): 254 (en) 1300 - Updated carrier data for country calling code(s): 1301 91 (en), 225 (en), 254 (en), 354 (en), 509 (en), 1242 (en) 1302 1303Feb 20, 2017: v8.3.1 1304Code changes: 1305 - Making getNationalSignificantNumber more robust in the face of malicious 1306 input. This now ignores the number_of_leading_zeros if they are less than 1307 zero. 1308Metadata changes: 1309 - New alternate formatting data for country calling code(s): 39 1310 - Updated phone metadata for region code(s): BS, VN 1311 - Updated geocoding data for country calling code(s): 1312 62 (en, id), 84 (en), 374 (en, hy) 1313 - Updated carrier data for country calling code(s): 7 (ru), 91 (en), 1242 (en) 1314 - Updated / refreshed time zone meta data. 1315 1316Feb 14, 2017: v8.3.0 1317Code changes: 1318 - Added two new enum values to ValidationResult - IS_POSSIBLE_LOCAL_ONLY and 1319 INVALID_LENGTH. Added more documentation to the existing values; see the 1320 javadoc for when these are going to be used. Note that the API for 1321 IsPossibleNumberWithReason has not yet been changed to return these values. 1322 IS_POSSIBLE_LOCAL_ONLY will be returned for some values which currently 1323 return IS_POSSIBLE, and INVALID_LENGTH will be returned for some values which 1324 currently return TOO_LONG. 1325 - Fix for isNumberMatch to ignore the numberOfLeadingZeros field when comparing 1326 numbers unless hasItalianLeadingZero is true, and to consider default values 1327 to match the same value when explicitly set for these two fields. This fix 1328 shouldn't be needed for anyone correctly creating phone numbers using "parse" 1329 as recommended. 1330 - C++ only: Fix for ExactlySameAs when comparing phone numbers to include 1331 comparison of the number_of_leading_zeros field. 1332 - C++ only: Updating maximum length for NSN to be 17 (matches Java and JS) 1333Metadata changes: 1334 - Updated phone metadata for region code(s): IN, MU, RE, TG, TJ, TT, US 1335 - New geocoding data for country calling code(s): 1336 218 (en), 972 (iw), 1283 (en), 1442 (en), 1458 (en), 1470 (en), 1475 (en), 1337 1531 (en), 1534 (en), 1539 (en), 1680 (en), 1681 (en), 1762 (en) 1338 - Updated geocoding data for country calling code(s): 1339 1206 (en), 1253 (en), 1360 (en), 1425 (en), 1509 (en) 1340 - Updated carrier data for country calling code(s): 1341 57 (en), 91 (en), 297 (en), 992 (en), 1868 (en) 1342 1343Feb 02, 2017: v8.2.0 1344Code changes: 1345 - Made normalizeDiallableCharsOnly() API in PhoneNumberUtil (Java) public. This 1346 method is already public in the C++ implementation. It has also now been 1347 added to the Javascript implementation. 1348Metadata changes: 1349 - Updated alternate formatting data for country calling code(s): 91 1350 - Updated phone metadata for region code(s): 1351 AU, AX, BY, BZ, FR, GY, IN, MC, NA, SJ, TG, TT, VN 1352 - Updated short number metadata for region code(s): HR, TG 1353 - Armenia geocoding data that is in Armenian language is moved to right language 1354 code (hy). 1355 - Updated geocoding data for country calling code(s): 91 (en), 374 (en, ru) 1356 - Updated carrier data for country calling code(s): 91 (en) 1357 1358Jan 25, 2017: v8.1.0 1359Code changes: 1360 - Introduced new isCarrierSpecificForRegion() API in ShortNumberInfo class. 1361 This determines whether the provided short code is carrier-specific or 1362 not when dialed from the given region. 1363Metadata changes: 1364 - New alternate formatting data for country calling code(s): 52 1365 - Updated alternate formatting data for country calling code(s): 62 1366 - Updated phone metadata for region code(s): 1367 AR, DJ, GB, GG, GH, ID, IM, IN, JE, MA, MQ, MZ, RO, ZA 1368 - Updated short number metadata for region code(s): ZA 1369 - Updated geocoding data for country calling code(s): 27 (en) 1370 - Updated carrier data for country calling code(s): 1371 91 (en), 93 (en, fa), 233 (en), 253 (en), 258 (en) 1372 1373Jan 11, 2017: v8.0.1 1374Metadata changes: 1375 - Updated phone metadata for region code(s): 1376 BR, CI, CL, CN, CR, DE, FR, GB, GW, HN, IL, IN, KM, KZ, NG, PG, SC, SK, SO, 1377 TT, UA, ZA 1378 - Updated short number metadata for region code(s): BH, BR, SK 1379 - New geocoding data for country calling code(s): 675 (en) 1380 - Updated geocoding data for country calling code(s): 1381 7 (en, ru), 86 (en, zh), 252 (en), 374 (en), 504 (en) 1382 - New carrier data for country calling code(s): 7 (ru), 44 (en), 269 (en) 1383 - Updated carrier data for country calling code(s): 1384 7 (en), 62 (en), 86 (en, zh, zh_Hant), 91 (en), 225 (en), 234 (en), 245 (en), 1385 252 (en) 1386 1387Dec 07, 2016: v8.0.0 1388Code changes: 1389 - Deleted deprecated methods in ShortNumberInfo that work on strings, instead 1390 of phone number objects. These have been marked deprecated for months. Any 1391 users of these methods should call PhoneNumberUtil.parse first to create a 1392 PhoneNumber object, and pass this in. 1393 - Support semicolon as extension character while parsing phone numbers. This 1394 is not applicable when you are trying to find the phone numbers. 1395 - Updated JavaScript to throw an error rather than a string. As a result, users 1396 doing custom behavior depending on the value of the error must now compare 1397 to the value of e.message. 1398Metadata changes: 1399 - Updated phone metadata for region code(s): 1400 AM, BD, BR, CI, ES, IN, KI, KR, LI, MC, MM, TZ 1401 - Updated short number metadata for region code(s): KI, MV, MY 1402 - New geocoding data for country calling code(s): 227 (en), 240 (en), 255 (en) 1403 - Updated geocoding data for country calling code(s): 95 (en), 686 (en) 1404 - New carrier data for country calling code(s): 423 (en) 1405 - Updated carrier data for country calling code(s): 1406 90 (en), 91 (en), 95 (en), 255 (en), 374 (en, ru) 1407 1408Nov 23, 2016: v7.7.5 1409Code changes: 1410 - Removing all references to possible_number_pattern other than the proto 1411 buffer itself (and derived files, or hand-crafted files based on it.) This 1412 information is no longer present in the binary. 1413 - Refactored metadata loading and removed synchronization for all kinds of 1414 metadata. Clients may experience quicker loading of alternate formats and 1415 short number metadata, but no change is required for callers of the library. 1416 - Reduced visibility of `public` internal API 1417 `PhoneNumberUtil.createInstance(MetadataSource)` to `private`. MetadataSource 1418 and all its implementations are non-public so this should not affect public 1419 usage of the library. 1420Metadata changes: 1421 - Updated phone metadata for region code(s): 1422 BB, BD, ES, HN, IN, KR, KW, MC, NL, PH, PK, SH, TW, VG, ZW 1423 - Updated short number metadata for region code(s): 1424 AF, AG, AM, AR, AW, AZ, BD, BM, BQ, BW, CD, CI, CM, CO, CW, DZ, GD, GE, GN, 1425 GT, GY, HN, HT, IE, IN, IQ, JM, JO, KE, KG, KH, KW, LV, NO, SG, SV, UY 1426 - Updated geocoding data for country calling code(s): 504 (en) 1427 - New carrier data for country calling code(s): 886 (en), 1284 (en) 1428 - Updated carrier data for country calling code(s): 63 (en), 92 (en) 1429 1430Nov 09, 2016: v7.7.4 1431GitHub project changes: 1432 - Changed tag to vX.Y.Z from libphonenumber-X.Y.Z; this may affect ports and 1433 derived projects. 1434Metadata structure changes in XML file: 1435 - Mobile and Fixed-Line blocks are no longer assumed to inherit missing data 1436 from the GeneralDesc, but are treated like every other phone number type. 1437 This means that for the non-geographical country codes, like +800, the 1438 example number has been moved from generalDesc to the relevant number types, 1439 and the code in getExampleNumberForNonGeoEntity has been changed to look at 1440 these sub-types for an example number. 1441 This also means that the "NA" and "-1" blocks present in the metadata to 1442 indicate that no mobile or fixed-line numbers appear for the entity have been 1443 removed. 1444 There should no longer be an exampleNumber at the generalDesc level, but it 1445 should be present at every PhoneNumberDesc with data. 1446Code changes: 1447 - Using new possibleLengthInfo to decide whether a short number is the right 1448 length or not. This could result in more specific results; whereas before, a 1449 number from length 3 to length 6 may have been deemed possible, now we may 1450 exclude a number of length 5. 1451 - Add hash (#) as a diallable character. Numbers with # in them will no longer 1452 have formatting applied in formatInOriginalFormat, and 1453 normalizeDiallableCharsOnly now retains the # symbol. 1454 - getExampleNumberForNonGeoEntity has been changed to look at the specific 1455 number types, not just the generalDesc, for the example numbers; this is a 1456 necessary change after the metadata structure change detailed above. 1457Metadata changes: 1458 - Updated phone metadata for region code(s): AD, AE, IN, IR, MU, MV, NG, PG 1459 - Updated short number metadata for region code(s): NL, SN 1460 - New geocoding data for country calling code(s): 1461 960 (en), 1249 (en), 1343 (en), 1579 (en), 1581 (en) 1462 - Updated geocoding data for country calling code(s): 1463 1782 (en), 1867 (en), 1902 (en) 1464 - Updated carrier data for country calling code(s): 1465 91 (en), 234 (en), 971 (en) 1466 1467Oct 26, 2016: libphonenumber-7.7.3 1468Internal changes: 1469 - Fixed Phonemetadata.java not to merge from a NumberFormat's unset bool 1470 national_prefix_optional_when_formatting. 1471 - Added MetadataFilter, an internal API which is under development and subject 1472 to backwards-incompatible changes without notice or guarantees. 1473Metadata changes: 1474 - Updated phone metadata for region code(s): 1475 882, AG, AI, AS, BB, BM, BR, BS, CA, DM, DO, GD, GU, HU, IN, JM, KN, KY, KZ, 1476 LC, MP, MS, PR, SX, TC, TR, TT, UG, US, VC, VG, VI 1477 - Updated short number metadata for region code(s): UY 1478 - New geocoding data for country calling code(s): 1463 (en), 358 (sv) 1479 - Removed geocoding data for country calling code(s): 358 (se) 1480 - Updated geocoding data for country calling code(s): 7 (en, ru) 1481 - Updated carrier data for country calling code(s): 1482 91 (en), 256 (en), 1876 (en) 1483 1484Oct 06, 2016: libphonenumber-7.7.2 1485Code changes: 1486 - Stop setting empty preferred_domestic_carrier_code, and if we are passed such 1487 a number then treat the empty field as if unset. 1488Metadata changes: 1489 - Updated phone metadata for region code(s): CL, FR, KE, MU, NG 1490 - Updated short number metadata for region code(s): 1491 EC, EE, EG, EH, ER, ES, ET, FI, FJ, FK, FM, FO, FR, OM, PA, PE, PF, PG, PH, 1492 PK, PL, PM, PR, PT, PW, PY, QA, RE, RO, RS, RU, RW, SA, SB, SC, SD, SE, SG, 1493 SH, SI, SJ, SK, SL, SM, SN, SO, SR, ST, SV, SX, SY, SZ, TC, TD, TG, TH, TJ, 1494 TL, TM, TN, TO, TR, TT, TV, TW, TZ, UA, UG, US, UY, UZ, VA, VC, VE, VG, VI, 1495 VN, VU, WF, WS, YE, YT, ZA, ZM, ZW 1496 - Updated geocoding data for country calling code(s): 56 (en, es) 1497 - Updated carrier data for country calling code(s): 1498 230 (en), 234 (en), 254 (en) 1499 1500Sep 27, 2016: libphonenumber-7.7.1 1501Build changes: 1502 - OSGi support added to Manifest information when building jar (#1300) 1503 - BuildMetadataJsonFromXml changed to output possible lengths for JS build 1504 - Fix geocoding file generation to handle language codes that are not just 1505 two letters long properly and to process filenames in the same order. 1506Code changes: 1507 - Switching the internal implementation of isPossible and related functions 1508 to use the new possibleLengths metadata. This affects a lot of countries, 1509 making isPossible more restrictive as more precise data is available. It 1510 also affects parsing ambiguous and invalid numbers, as we decide whether 1511 to strip a possible national prefix (1) or country code based on the length 1512 of the number and whether it is possible before or after this. 1513 - Formatting, naming (LOGGER -> logger) and comment tweaks to follow style 1514 guide 1515 - Removal of unneeded canBeGeocoded method in the 1516 PhoneNumberToTimeZonesMapper.java, using phoneNumberUtil instead 1517Metadata changes: 1518 - Updated phone metadata for region code(s): 1519 800, 808, 870, 878, 881, 882, 883, 888, 979, AG, AM, BD, BF, CL, CO, EC, ET, 1520 GB, GG, GH, IN, LR, MD, MQ, SH, SN, TA, TH, TR 1521 - Updated short number metadata for region code(s): 1522 AC, AD, AE, AF, AG, AI, AL, AM, AO, AR, AS, AT, AU, AW, AX, AZ, BA, BB, BD, 1523 BE, BF, BG, BH, BI, BJ, BL, BM, BN, BO, BQ, BR, BS, BT, BW, BY, BZ, CA, CC, 1524 CD, CF, CG, CH, CI, CK, CL, CM, CN, CO, CR, CU, CV, CW, CX, CY, CZ, DE, DJ, 1525 DK, DM, DO, DZ, MD 1526 - New carrier data for country calling code(s): 593 (en) 1527 - Updated carrier data for country calling code(s): 1528 49 (en), 56 (en), 66 (en), 90 (en), 91 (en), 226 (en), 231 (en), 373 (en), 1529 852 (zh_Hant) 1530 1531Sep 19, 2016: libphonenumber-7.7.0 1532Code changes: 1533 - Removed the dependency on protobuf (protobuf-javanano) from the Java library, 1534 resurrecting 1535 java/libphonenumber/src/com/google/i18n/phonenumbers/Phonemetadata.java 1536 which was present until libphonenumber-7.1.1. 1537 Does not affect the C++ or JavaScript libraries. 1538 1539Sep 07, 2016: libphonenumber-7.6.1 1540Code changes: 1541 - Phonemetadata.java has two more fields to represent possible lengths of phone 1542 numbers. Changed BuildMetadataFromXml (and the resultant jar) to alter the way 1543 that metadata about possible-lengths information is consumed when constructing 1544 metadata to populate these. 1545 Discussion list email: 1546 https://groups.google.com/forum/#!topic/libphonenumber-discuss/75TOpTFVi08 1547Metadata changes: 1548 - Updated phone metadata for region code(s): 1549 AG, AM, AX, BY, CD, FI, IN, KR, MA, NA, NL, PK, SY 1550 - Updated short number metadata for region code(s): BR, GB, NL, NZ 1551 - New geocoding data for country calling code(s): 1552 82 (pl, pt, ro, ru, sl, sr, uk, vi) 1553 - Updated carrier data for country calling code(s): 1554 27 (en), 91 (en), 243 (en), 963 (en) 1555 1556Aug 24, 2016: libphonenumber-7.6.0 1557Code changes: 1558 - Refactored metadata loading and closed all streams after loading. 1559 - Made isNumberGeographical public, and changed the geocoder to 1560 use this when checking whether to give a detailed answer or country-level 1561 only. 1562Build changes: 1563 - Use protobuf-javanano 3.0.0-alpha-7 from Maven Central. 1564Metadata changes: 1565 - Updated phone metadata for region code(s): EH, ET, JM, MA, SK, SN, SY, ZM 1566 - Updated short number metadata for region code(s): ZA 1567 - Updated geocoding data for country calling code(s): 212 (en) 1568 - New carrier data for country calling code(s): 1569 86 (zh, zh_Hant), 852 (zh, zh_Hant), 963 (en) 1570 - Updated carrier data for country calling code(s): 1571 86 (en), 212 (en), 251 (en), 421 (en) 1572 - Deleted unsupported SingleFilePhoneNumberMetadataProto 1573 1574Aug 10, 2016: libphonenumber-7.5.2 1575Metadata changes: 1576 - Updated phone metadata for region code(s): CO, IN, ME 1577 - Updated short number metadata for region code(s): IN 1578 - New carrier data for country calling code(s): 382 (en) 1579 - Updated carrier data for country calling code(s): 91 (en) 1580 1581Jul 27, 2016: libphonenumber-7.5.1 1582Metadata changes: 1583 - Updated alternate formatting data for country calling code(s): 595 1584 - Updated phone metadata for region code(s): BD, BG, CI, IN, PY, TJ 1585 - Updated short number metadata for region code(s): IN 1586 - New geocoding data for country calling code(s): 1587 82 (bg, ca, el, es, fi, hi, hu, iw, ja, tr) 1588 - Updated geocoding data for country calling code(s): 44 (en) 1589 - New carrier data for country calling code(s): 374 (ru) 1590 - Updated carrier data for country calling code(s): 1591 91 (en), 374 (en), 992 (en) 1592 1593Jul 22, 2016: libphonenumber-7.5.0 1594Code changes: 1595 - Simplify concurrent metadata loading in MultiFileMetadataSourceImpl and 1596 reduce points of contention. 1597 1598Jul 14, 2016: libphonenumber-7.4.5 1599Metadata changes: 1600 - Updated phone metadata for region code(s): CN, HN, IN, KW, LV, TC 1601 - Updated short number metadata for region code(s): AE, BR, GB, ZA 1602 - New geocoding data for country calling code(s): 93 (fa), 992 (en) 1603 - Updated geocoding data for country calling code(s): 1604 91 (en), 98 (en, fa), 371 (en), 504 (en), 1 (en) 1605 - Updated carrier data for country calling code(s): 91 (en) 1606 1607Jun 29, 2016: libphonenumber-7.4.4 1608Metadata changes: 1609 - Updated phone metadata for region code(s): AZ, BH, HN, IN, US 1610 - Updated short number metadata for region code(s): BR, IN, SK 1611 - New geocoding data for country calling code(s): 994 (en), 1612 - Updated geocoding data for country calling code(s): 504 (en), 1 (en) 1613 - Updated carrier data for country calling code(s): 1614 91 (en), 973 (en), 994 (en) 1615 1616Jun 15, 2016: libphonenumber-7.4.3 1617Metadata changes: 1618 - Updated phone metadata for region code(s): 1619 HK, HN, IN, KN, KW, SK, SN, TH, TZ 1620 - Updated short number metadata for region code(s): AR, NO 1621 - New geocoding data for country calling code(s): 93 (en), 504 (en) 1622 - New carrier data for country calling code(s): 93 (fa), 98 (fa) 1623 - Updated carrier data for country calling code(s): 1624 66 (en), 91 (en), 255 (en), 421 (en) 1625 1626Jun 01, 2016: libphonenumber-7.4.2 1627Code changes: 1628 - Make C++ code forward compatible with an upcoming RE2 change. 1629Metadata changes: 1630 - Updated phone metadata for region code(s): AE, BZ, GU, IN, KR 1631 - Updated short number metadata for region code(s): BR 1632 - New geocoding data for country calling code(s): 501 (en) 1633 - Updated carrier data for country calling code(s): 1634 91 (en), 971 (en), 1671 (en) 1635 1636May 18, 2016: libphonenumber-7.4.1 1637Metadata changes: 1638 - Updated phone metadata for region code(s): FR, IL, KR 1639 - Updated carrier data for country calling code(s): 972 (en) 1640 1641May 11, 2016: libphonenumber-7.4.0 1642Maven changes: 1643 - Repackage protobuf runtime dependency to prevent conflicts with clients' 1644 protobuf dependencies. Backwards-compatible, so no changes needed for clients 1645 who could use the previous release, but enables those with their own protobuf 1646 dependencies to use this and future releases without workarounds. 1647 1648May 03, 2016: libphonenumber-7.3.2 1649Metadata changes: 1650 - Updated phone metadata for region code(s): 1651 AU, BR, ET, IN, KH, ML, NO, SB, TJ, US 1652 - Updated short number metadata for region code(s): CA, ML, US 1653 - New geocoding data for country calling code(s): 223 (en) 1654 - Updated geocoding data for country calling code(s): 1655 27 (en), 55 (en, pt), 1 (en) 1656 - Updated carrier data for country calling code(s): 1657 61 (en), 91 (en), 223 (en), 251 (en), 677 (en), 992 (en) 1658 1659Apr 20, 2016: libphonenumber-7.3.1 1660Metadata changes: 1661 - Updated phone metadata for region code(s): DE, DJ, IL, IN, KH 1662 - Updated short number metadata for region code(s): BR 1663 - Updated carrier data for country calling code(s): 1664 91 (en), 855 (en), 972 (en) 1665 1666Apr 05, 2016: libphonenumber-7.3.0 1667Code changes: 1668 - Added java/pending_code_changes.txt for contributors to track code changes 1669 between releases. 1670 - Reduced minimum required version of cmake to 2.8. 1671 - Added cmake installation instructions for Mac. 1672 - Added getExampleNumberForType that doesn't take in a region, and 1673 getInvalidExampleNumber 1674 - Improvements to javadoc for parse method 1675 - Update isNumberGeographical to return true for geographical mobile numbers. 1676Metadata changes: 1677 - Updated phone metadata for region code(s): 1678 BJ, BZ, CI, ET, GQ, KE, KW, ML, NO, OM, VN 1679 - Updated short number metadata for region code(s): KE 1680 - Updated geocoding data for country calling code(s): 1681 84 (en), 251 (en), 254 (en) 1682 - Updated carrier data for country calling code(s): 1683 84 (en), 225 (en), 229 (en), 254 (en), 968 (en) 1684 1685Mar 21, 2016: libphonenumber-7.2.8 1686Metadata changes: 1687 - Updated phone metadata for region code(s): CL, CN, FO, KE, SE, SO 1688 - Updated short number metadata for region code(s): FO 1689 - Updated geocoding data for country calling code(s): 86 (en, zh) 1690 - Updated carrier data for country calling code(s): 1691 86 (en), 252 (en), 254 (en) 1692 1693Mar 09, 2016: libphonenumber-7.2.7 1694Code changes: 1695 - Update nationalPrefixOptionalWhenFormatting documentation. 1696Metadata changes: 1697 - Updated phone metadata for region code(s): CN, IN, MO, TK 1698 - Updated short number metadata for region code(s): FR 1699 - Updated carrier data for country calling code(s): 853 (en) 1700 - Updated / refreshed time zone meta data. 1701 1702Feb 25, 2016: libphonenumber-7.2.6 1703Metadata changes: 1704 - Updated phone metadata for region code(s): DJ, MA, NA, US 1705 - Updated short number metadata for region code(s): KR 1706 - New geocoding data for country calling code(s): 1380 (en) 1707 - Updated geocoding data for country calling code(s): 212 (en) 1708 1709Feb 10, 2016: libphonenumber-7.2.5 1710Code changes: 1711 - Fix two places in demo where NPEs can occur on bad input. 1712 - Fix an IllegalStateException when getMetadataForNonGeographicalRegion is 1713 called with a country calling code which isn't a non-geographic entity. 1714Metadata changes: 1715 - Updated phone metadata for region code(s): 1716 AG, AI, AS, BB, BM, BS, CA, DM, DO, ET, GD, GU, JM, KN, KY, LC, MP, MS, PR, 1717 SE, SK, SX, TC, TT, US, VC, VG, VI 1718 - Updated geocoding data for country calling code(s): 46 (en) 1719 - Updated carrier data for country calling code(s): 251 (en) 1720 1721Jan 28, 2016: libphonenumber-7.2.4 1722 - First release to automatically remove obsolete geocoding files 1723Metadata changes: 1724 - Updated phone metadata for region code(s): 1725 BW, CA, CI, CK, GM, IN, NA, NG, PG, TD, TM 1726 - Updated short number metadata for region code(s): PT 1727 - New geocoding data for country calling code(s): 1825 (en) 1728 - Removed geocoding data for country calling code(s): 1729 1726 (en), 1730 (en), 1838 (en), 1851 (en), 1888 (en), 225 (fr), 242 (fr), 1730 269 (fr), 238(pt), 55 (pt) 1731 - Updated carrier data for country calling code(s): 1732 91 (en), 225 (en), 234 (en), 235 (en), 675 (en), 993 (en) 1733 1734Jan 08, 2016: libphonenumber-7.2.3 1735Backwards-incompatible code changes: 1736 - Removed deprecated ShortNumberUtil.java 1737Other code changes: 1738 - Updated the demo: 1739 added short number support; 1740 added permalink; 1741 added direct link to file an issue 1742Metadata changes: 1743 - Updated phone metadata for region code(s): 1744 AU, BR, CC, CR, CW, CX, ET, HN, KR, SI, TV, WF 1745 - Updated short number metadata for region code(s): FR, HR, HU, IT, KR, LV, TV 1746 - New geocoding data for country calling code(s): 688 (en) 1747 - Updated carrier data for country calling code(s): 1748 61 (en), 251 (en), 506 (en), 599 (en) 1749 1750Dec 15, 2015: libphonenumber-7.2.2 1751Metadata changes: 1752 - Updated phone metadata for region code(s): 1753 AT, BD, BR, CC, CX, CY, FI, ID, IS, KI, MM, TN, VC 1754 - Updated short number metadata for region code(s): 1755 AT, BG, CY, CZ, DE, DK, EE, FI, GB, GR, ID, IE, IS, LT, LU, MT, NL, PL, RO, 1756 SI, SK 1757 - New geocoding data for country calling code(s): 95 (en) 1758 - Updated carrier data for country calling code(s): 1759 216 (en), 354 (en), 357 (en), 686 (en) 1760 1761Nov 11, 2015: libphonenumber-7.2.1 1762 - Fix to libphonenumber-7.2.0 1763Metadata changes: None 1764 1765Nov 10, 2015: libphonenumber-7.2.0 1766* Broken, do not use * 1767Code changes: 1768 - Phonemetadata now generated as nanoproto 1769Metadata changes: 1770 - Updated phone metadata for region code(s): 1771 BI, BT, IL, MN, MO, NP, RU, SK, VG 1772 - Updated short number metadata for region code(s): BT, DK 1773 - New geocoding data for country calling code(s): 972 (en), 975 (en) 1774 - New carrier data for country calling code(s): 853 (en) 1775 - Updated carrier data for country calling code(s): 1776 45 (en), 257 (en), 421 (en), 964 (en), 972 (en), 975 (en), 976 (en) 1777 - Updated / refreshed time zone meta data. 1778 1779Oct 29, 2015: libphonenumber-7.1.1 1780Metadata changes: 1781 - Updated phone metadata for region code(s): 1782 AT, BB, BR, GW, ID, MD, OM, SO, TT 1783 - Updated short number metadata for region code(s): BB, NO 1784 - New geocoding data for country calling code(s): 968 (en) 1785 - Updated geocoding data for country calling code(s): 245 (en, pt) 1786 - Updated carrier data for country calling code(s): 1787 62 (en), 245 (en), 252 (en), 373 (en), 968 (en), 1246 (en) 1788 1789Oct 08, 2015: libphonenumber-7.1.0 1790API changes: 1791 - New MetadataSource implementation that reads from a single metadata file with 1792 all regions' phone number metadata. 1793Metadata changes: 1794 - Updated phone metadata for region code(s): BR, BS, HT, IR, KW, MC, PA, VU 1795 - Updated carrier data for country calling code(s): 1796 98 (en), 678 (en), 880 (en) 1797 1798Sep 16, 2015: libphonenumber-7.0.11 1799Metadata changes: 1800 - Updated phone metadata for region code(s): 1801 IN, KE, LR, MM, MR, NA, NE, PT, RO, SO, TZ, US 1802 - New short number metadata for region code(s): CF, CG, ER, KP, NE, SO 1803 - Updated short number metadata for region code(s): CD, NO, PT 1804 - New geocoding data for country calling code(s): 1854 (en) 1805 - Updated geocoding data for country calling code(s): 264 (en) 1806 - Updated carrier data for country calling code(s): 1807 40 (en), 91 (en), 95 (en), 227 (en), 231 (en), 252 (en), 254 (en), 255 (en), 1808 509 (en) 1809 1810Aug 31, 2015: libphonenumber-7.0.10 1811Metadata changes: 1812 - Updated phone metadata for region code(s): 1813 AU, BY, CR, DZ, EH, ES, HK, HT, IN, JO, MN, MU, ST, TD, TT, ZW 1814 - Updated short number metadata for region code(s): HK, KR 1815 - Updated geocoding data for country calling code(s): 263 (en) 1816 - New carrier data for country calling code(s): 509 (en), 976 (en) 1817 - Updated carrier data for country calling code(s): 1818 41 (en), 61 (en), 91 (en), 230 (en), 235 (en), 239 (en) 1819 1820Aug 03, 2015: libphonenumber-7.0.9 1821Metadata changes: 1822 - Updated phone metadata for region code(s): AR, IN, MX, PL, SZ, YT, ZW 1823 - Updated short number metadata for region code(s): MX, ZW 1824 - Updated carrier data for country calling code(s): 91 (en), 263 (en) 1825 1826Jul 14, 2015: libphonenumber-7.0.8 1827Metadata changes: 1828 - Updated phone metadata for region code(s): 1829 AC, BS, BW, CL, DE, DZ, HN, HR, IL, IN, IT, JO, KY, MA, NP, PL, SH, SL, TM, 1830 UA, VA 1831 - Updated short number metadata for region code(s): HR 1832 - Updated geocoding data for country calling code(s): 56 (en, es) 1833 - Updated carrier data for country calling code(s): 1834 49 (en), 212 (en), 232 (en), 267 (en), 380 (en), 385 (en), 962 (en), 1835 972 (en), 977 (en), 993 (en) 1836- Updated / refreshed time zone meta data. 1837 1838Jun 24, 2015: libphonenumber-7.0.7 1839Metadata changes: 1840 - Updated phone metadata for region code(s): 1841 AC, BF, BG, CG, CM, FR, IL, IN, JP, KW, LB, LI, SB, SD, SH, TT 1842 - Updated short number metadata for region code(s): GY, SB 1843 - New geocoding data for country calling code(s): 592 (en) 1844 - Updated geocoding data for country calling code(s): 1845 86 (en, zh), 226 (en), 290 (en, fr) 1846 - New carrier data for country calling code(s): 592 (en), 689 (en) 1847 - Updated carrier data for country calling code(s): 1848 7 (en), 60 (en), 91 (en), 237 (en), 242 (en), 249 (en), 359 (en), 961 (en), 1849 1868 (en) 1850- Updated / refreshed time zone meta data. 1851 1852May 29, 2015: libphonenumber-7.0.6 1853Metadata changes: 1854 - Updated phone metadata for region code(s): 1855 BB, BR, CR, ID, IL, JO, KW, LK, LU, MD, MM, MV, MY, PH, PK, SC, SE 1856 - Updated short number metadata for region code(s): BE, LK, US 1857 - Updated carrier data for country calling code(s): 1858 60 (en), 63 (en), 92 (en), 94 (en), 95 (en), 248 (en), 373 (en), 960 (en), 1859 972 (en), 1246 (en) 1860 1861Apr 24, 2015: libphonenumber-7.0.5 1862* Metadata changes: 1863 - Updated phone metadata for region code(s): 1864 AF, AS, BD, BE, CA, CI, ID, IN, JM, KH, LI, LU, MU, NE, PL 1865 - Updated short number metadata for region code(s): BE, LI 1866 - Updated geocoding data for country calling code(s): 1867 62 (en), 86 (en, zh), 358 (en, fi, se) 1868 - Updated carrier data for country calling code(s): 1869 32 (en), 93 (en), 225 (en), 227 (en), 855 (en), 1684 (en), 1876 (en) 1870 1871Mar 25, 2015: libphonenumber-7.0.4 1872* Metadata changes: 1873 - Updated phone metadata for region code(s): CA, HU, IL, JO, LU, SG, SL, US 1874 - Updated short number metadata for region code(s): BI 1875 - New geocoding data for country calling code(s): 1876 1220 (en), 1628 (en), 1629 (en) 1877 - Updated carrier data for country calling code(s): 1878 65 (en), 232 (en), 972 (en) 1879 1880Mar 02, 2015: libphonenumber-7.0.3 1881* Metadata changes: 1882 - Updated phone metadata for region code(s): 1883 AR, BH, BY, CI, CN, GH, KR, KW, LU, ME, NZ, SB, WS 1884 - New geocoding data for country calling code(s): 64 (en) 1885 - Updated geocoding data for country calling code(s): 1886 86 (en, zh), 1418 (en), 1438 (en), 1450 (en), 1514 (en), 1819 (en) 1887 - Updated carrier data for country calling code(s): 1888 225 (en), 233 (en), 677 (en), 973 (en) 1889 1890Jan 09, 2015: libphonenumber-7.0.2 1891* Metadata changes: 1892 - Updated phone metadata for region code(s): 1893 BD, BH, EH, GH, IN, JM, LU, MA, MY, NF, NG, PK, SB, TT, TZ 1894 - Updated geocoding data for country calling code(s): 91 (en), 352 (en, fr) 1895 - New carrier data for country calling code(s): 1876 (en) 1896 - Updated carrier data for country calling code(s): 1897 60 (en), 91 (en), 92 (en), 212 (en), 233 (en), 234 (en), 352 (en), 677 (en) 1898 1899Nov 25, 2014: libphonenumber-7.0.1 1900* Metadata changes: 1901 - New alternate formatting data for country calling code(s): 676 1902 - Updated phone metadata for region code(s): 1903 BI, CM, ID, IR, KR, LA, NP, TG, TH, TO 1904 - New geocoding data for country calling code(s): 237 (en) 1905 - Updated geocoding data for country calling code(s): 98 (en, fa) 1906 - Updated carrier data for country calling code(s): 1907 237 (en), 257 (en), 856 (en), 977 (en) 1908 1909Oct 29, 2014: libphonenumber-7.0 1910* Code changes: 1911 - New APIs for ShortNumberInfo. The old APIs have been deprecated and will be 1912 removed in an upcoming release. 1913* Metadata changes: 1914 - Updated phone metadata for region code(s): 1915 AR, AU, CC, CI, CX, DZ, EE, IN, KZ, MC, SB, TJ, TT 1916 - Updated short number metadata for region code(s): MC 1917 - Updated geocoding data for country calling code(s): 34 (en, es), 54 (en) 1918 - Updated carrier data for country calling code(s): 1919 7 (en), 61 (en), 91 (en), 225 (en), 677 (en), 967 (en), 992 (en), 1868 (en) 1920 1921Oct 13, 2014: libphonenumber-6.3.1 1922* Metadata changes: 1923 - Updated phone metadata for region code(s): 1924 AC, AU, CR, DE, IL, MR, NO, SA, SR, UG 1925 - Updated short number metadata for region code(s): CR 1926 - Updated carrier data for country calling code(s): 1927 61 (en), 256 (en), 506 (en), 597 (en), 966 (en), 972 (en) 1928 1929Sep 25, 2014: libphonenumber-6.3 1930* Code changes: 1931 - Changing the offline geocoder to not return any country at all if the number 1932 could belong to multiple countries 1933 - Removing obsolete code that treated countries with no metadata as valid. 1934* Metadata changes: 1935 - New alternate formatting data for country calling code(s): 54, 91 1936 - Updated phone metadata for region code(s): 1937 AM, AR, BR, CA, CL, IL, IN, IR, IS, KE, NI, PF, SB, SN, TH, TN, US 1938 - New geocoding data for country calling code(s): 1939 1782 (en), 1929 (en), 1930 (en), 1938 (en) 1940 - Updated geocoding data for country calling code(s): 98 (en, fa) 1941 - New carrier data for country calling code(s): 354 (en) 1942 - Updated carrier data for country calling code(s): 1943 27 (en), 56 (en), 66 (en), 91 (en), 92 (en), 98 (en), 216 (en), 221 (en), 1944 254 (en), 374 (en), 505 (en), 677 (en), 972 (en) 1945 1946Aug 21, 2014: libphonenumber-6.2.2 1947* Metadata changes: 1948 - Updated phone metadata for region code(s): BN, CL, CO, DK, IN, SB, SO 1949 - Updated short number metadata for region code(s): FR, SA, US 1950 - Updated carrier data for country calling code(s): 1951 27 (en), 57 (en), 91 (en), 252 (en), 677 (en) 1952 1953Jul 28, 2014: libphonenumber-6.2.1 1954* Metadata changes: 1955 - Updated phone metadata for region code(s): BW, LB, MD, PA, PF, VI, ZM 1956 - New carrier data for country calling code(s): 507 (en), 961 (en) 1957 - Updated carrier data for country calling code(s): 267 (en), 373 (en) 1958 1959Jun 30, 2014: libphonenumber-6.2 1960* Code changes: 1961 - Better exclusion of dates when matching phone numbers from text. 1962 - Handle phone input in RFC3966 with missing tel: prefix 1963 1964* Metadata changes: 1965 - New alternate formatting data for country calling code(s): 95 1966 - Updated phone metadata for region code(s): 1967 AF, CN, EH, FJ, IN, JP, KE, KG, KW, MA, MM, PG, PK, SN, SO 1968 - New short number metadata for region code(s): SN 1969 - Updated short number metadata for region code(s): FR, KE 1970 - Updated geocoding data for country calling code(s): 254 (en) 1971 - New carrier data for country calling code(s): 95 (en) 1972 - Updated carrier data for country calling code(s): 1973 92 (en), 93 (en), 212 (en), 221 (en), 254 (en), 675 (en), 679 (en), 965 (en), 1974 996 (en) 1975 1976Jun 06, 2014: libphonenumber-6.1.1 1977* Metadata changes: 1978 - Updated phone metadata for region code(s): 1979 AF, AG, AI, AS, BB, BF, BM, BS, CA, CN, CR, DM, DO, DZ, FR, GD, GU, IN, JM, 1980 KH, KN, KW, KY, LC, MN, MP, MS, NG, NI, PH, PR, SX, TC, TT, US, VC, VG, VI 1981 - Updated short number metadata for region code(s): AL 1982 - New geocoding data for country calling code(s): 1346 (en), 1959 (en) 1983 - Updated geocoding data for country calling code(s): 1984 33 (en, fr), 352 (de, en, fr), 355 (en) 1985 - New carrier data for country calling code(s): 505 (en) 1986 - Updated carrier data for country calling code(s): 1987 63 (en), 91 (en), 93 (en), 234 (en) 1988 1989May 08, 2014: libphonenumber-6.1 1990* Code changes: 1991 - Adding MetadataLoader support to allow custom metadata loading from 1992 alternative sources (should have no visible impact to users). 1993 - Fixing bug where digits could be lost in as-you-type formatting and 1994 formatting patterns incorrectly applied. 1995 1996* Metadata changes: 1997 - Updated phone metadata for region code(s): 1998 AR, BF, BR, BS, CL, CN, CO, CR, DE, DM, EC, EG, FR, GA, GD, GH, HU, ID, IL, 1999 IN, JP, KH, KI, KN, LA, LC, LR, ML, MU, MX, MZ, NA, NE, PF, PL, RU, SM, TH, 2000 TW, UZ, VA, VC 2001 - Updated short number metadata for region code(s): BI, CR, PL, TH 2002 - New geocoding data for country calling code(s): 32 (de), 1242 (en) 2003 - Updated geocoding data for country calling code(s): 2004 32 (en, nl), 55 (en), 56 (en, es), 86 (en, zh) 2005 - New carrier data for country calling code(s): 2006 1758 (en), 1784 (en), 1869 (en) 2007 - Updated carrier data for country calling code(s): 2008 66 (en), 86 (en), 227 (en), 231 (en), 233 (en), 258 (en), 1473 (en), 2009 1767 (en) 2010 2011Feb 25, 2014: libphonenumber-6.0 2012* Code changes: 2013 - Better support for detecting phone numbers in text that are beside each other 2014 - Change to how Japanese numbers beginning with "00" are modelled, with the 2015 side-effect that the maximum possible number length has been extended by 1. 2016 - Handle StringIndexOutOfBoundsException in the AsYouTypeFormatter when the 2017 national prefix that was extracted was not found in the prefix. This affected 2018 countries with very long carrier codes, such as Korea. 2019 - Removal of some of the author attributions - contributions to be tracked in 2020 CONTRIBUTORS file. 2021* Metadata changes: 2022 - Updated phone metadata for region code(s): AS, BR, KW, LU 2023 - New carrier data for country calling code(s): 1684 (en) 2024 - Updated carrier data for country calling code(s): 352 (en) 2025 2026Feb 07, 2014: libphonenumber-5.9.4 2027* Metadata changes: 2028 - Updated phone metadata for region code(s): 2029 883, BF, BJ, BW, CL, CR, DZ, FR, GD, IN, JP, MD, NG, NZ, PK, PL, SY, UY, VU 2030 - Updated short number metadata for region code(s): LV, MD 2031 - New carrier data for country calling code(s): 373 (en), 1473 (en) 2032 - Updated carrier data for country calling code(s): 2033 48 (en), 49 (en), 91 (en), 92 (en), 213 (en), 226 (en), 229 (en), 234 (en), 2034 267 (en), 389 (en), 506 (en), 598 (en) 2035 2036Jan 21, 2014: libphonenumber-5.9.3 2037* Metadata changes: 2038 - Updated phone metadata for region code(s): 2039 BF, BH, BR, CN, GR, IN, MY, PA, TN, US 2040 - Updated short number metadata for region code(s): CN 2041 - New geocoding data for country calling code(s): 1364 (en), 1725 (en) 2042 - Updated geocoding data for country calling code(s): 86 (en) 2043 - Updated carrier data for country calling code(s): 2044 55 (en), 226 (en), 973 (en) 2045 2046Dec 20, 2013: libphonenumber-5.9.2 2047* Metadata changes: 2048 - New alternate formatting data for country calling code(s): 255, 27, 381, 506 2049 - Updated alternate formatting data for country calling code(s): 43 2050 - Updated phone metadata for region code(s): 2051 AG, AI, AS, BB, BF, BM, BS, CA, CR, DM, DO, EC, GD, GU, JM, KN, KY, LC, MP, 2052 MS, PR, SO, SX, TC, TT, US, VC, VG, VI 2053 - Updated carrier data for country calling code(s): 226 (en) 2054 2055Dec 13, 2013: libphonenumber-5.9.1 2056* Metadata changes: 2057 - New alternate formatting data for country calling code(s): 505, 679 2058 - Updated phone metadata for region code(s): 2059 BF, CI, EG, EH, FJ, IN, KI, MA, MT, NG, NI, SI, SN, SR, TT 2060 - Updated short number metadata for region code(s): KI 2061 - Updated geocoding data for country calling code(s): 2062 27 (en), 226 (en), 1 (en) 2063 - New carrier data for country calling code(s): 356 (en), 677 (en) 2064 - Updated carrier data for country calling code(s): 2065 212 (en), 221 (en), 225 (en), 226 (en), 234 (en), 597 (en), 1 (en) 2066 2067Nov 12, 2013: libphonenumber-5.9 2068* Code changes: 2069 - Adding support for numbers with multiple Italian leading zeros, by adding a field 2070 to the phone number proto to allow an arbitrary number of leading zeros, and 2071 supporting this when parsing, validating and formatting. 2072 - Adding more functionality to ShortNumberInfo -> such as getExpectedCostForRegion. 2073 - Fix for parsing short numbers that start with the national prefix. 2074 - Updating formatNumberForMobileDialing to work with short numbers. 2075 - Stop finding Israeli 4-digit "star" numbers in text when no star is in fact present. 2076 - Bug fix for finding phone numbers where the area code was also part of the country 2077 calling code. 2078 2079* Metadata changes: 2080 - Updated phone metadata for region code(s): 2081 AU, BQ, BY, CI, CO, CW, GN, HN, IN, JO, KI, KW, MG, MK, MM, NA, PK, TC, TM, 2082 UG 2083 - New short number metadata for region code(s): CD, GN 2084 - Updated short number metadata for region code(s): 2085 AF, AG, AI, AM, AR, AS, AW, AZ, BD, BH, BI, BM, BO, BQ, BT, BW, BY, CA, CH, 2086 CI, CM, CO, CW, DZ, FJ, GD, GE, GH, GT, GY, HN, HT, ID, IE, IM, IN, IQ, JM, 2087 JO, KE, KG, KH, KI, KW, KZ, LR, SV 2088 - New geocoding data for country calling code(s): 2089 257 (en), 389 (en), 599 (en), 686 (en), 962 (en) 2090 - Updated geocoding data for country calling code(s): 2091 264 (en), 375 (be, en, ru) 2092 - New carrier data for country calling code(s): 2093 375 (be, ru), 389 (en), 599 (en), 965 (ar) 2094 - Updated carrier data for country calling code(s): 2095 57 (en), 61 (en), 92 (en), 225 (en), 256 (en), 257 (en), 261 (en), 375 (en), 2096 686 (en), 962 (en), 965 (en) 2097 2098Oct 10, 2013: libphonenumber-5.8.8 2099* Metadata changes: 2100 - New alternate formatting data for country calling code(s): 2101 350, 358, 36, 66, 84, 94, 995 2102 - Updated alternate formatting data for country calling code(s): 2103 31, 359, 372, 49, 62, 7 2104 - Updated phone metadata for region code(s): 2105 AR, BD, BE, BF, BR, CO, CR, FI, GI, GM, IS, MU 2106 - Updated short number metadata for region code(s): AR, BE, ES, GI, PG, US 2107 - Updated geocoding data for country calling code(s): 220 (en) 2108 - Updated carrier data for country calling code(s): 2109 20 (en), 220 (en), 224 (en), 230 (en), 852 (en) 2110 2111Oct 8, 2013: libphonenumber-5.8.7 2112* Code changes: 2113 - New method in the PhoneNumberUtil API - isMobileNumberPortableRegion. 2114 - Carrier mapper: Updated API and added a getSafeDisplayName method that only returns the carrier 2115 if it's safe to display to the user. 2116 2117Oct 7, 2013: 2118* Code changes: 2119 - Added PhoneNumberToTimeZonesMapper including unittests to the geocoder maven project. 2120 - Added build rules for generating the binary time zones mapping file from the text file. 2121 - Modified PhoneNumberParserServlet.java (the appengine demo) to incorporate time zone mapping. 2122* Metadata changes: 2123 - Added the time zone mapping file. 2124 2125Sep 30, 2013: 2126* Code changes: 2127 - Added PhoneNumberToCarrierMapper including unittests. 2128 - Added build rules for generating binary carrier mapping files from text files. 2129 - Modified PhoneNumberParserServlet.java (the appengine demo) to incorporate carrier mapping. 2130* Metadata changes: 2131 - Added carrier mapping files for some NANPA countries, EG, SS, MA, DZ, TN, GM, SN, MR, ML, GN, 2132 CI, BF, NE, TG, BJ, MU, LR, SL, GH, NG, TD, CF, CM, CV, ST, GQ, GA, CG, CD, AO, GW, SC, SD, RW, 2133 ET, SO, DJ, KE, TZ, UG, BI, MZ, ZM, MG, ZW, MW, BW, SZ, ZA, AW, FO, GL, GR, NL, BE, FR, GI, PT, 2134 LU, IE, AL, CY, FI, BG, HU, LT, EE, AM, BY, AD, UA, RS, HR, SI, BA, IT, RO, CH, CZ, SK, AT, DK, 2135 NO, PL, DE, BZ, CR, PE, CU, AR, BR, CL, CO, VE, BO, PY, SR, UY, MY, AU, ID, PH, NZ, SG, TH, TL, 2136 BN, PG, TO, VU, FJ, WS, KI, RU, VN, HK, KH, LA, CN, BD, TR, IN, PK, AF, LK, MV, JO, IQ, KW, SA, 2137 YE, OM, PS, AE, IL, BH, QA, BT, NP, IR, TJ, TM, AZ, GE, KG and UZ in English. 2138 2139Sep 23, 2013: libphonenumber-5.8.6 2140* Code changes: 2141 - Restructured the geocoder binary generation code, moving the classes under tools/ from 2142 geocoding/ to buildtools/ and renaming AreaCode to PhonePrefix. 2143 2144Sep 23, 2013: libphonenumber-5.8.5 2145* Code changes: 2146 - Restructured the geocoder, moving the utility classes to a new module internal/prefixmapper. 2147 2148Sep 20, 2013: libphonenumber-5.8.4 2149* Metadata changes: 2150 - Adding a token to indicate which countries have mobile portability. 2151 2152Sep 20, 2013: libphonenumber-5.8.3 2153* Code changes: 2154 - PhoneNumberOfflineGeocoder: Moved utility functionality to PrefixFileReader. 2155 - Bug fix: Argentinian (and other countries with mobile tokens) mobile numbers now geocode 2156 correctly. 2157 2158Sep 19, 2013: libphonenumber-5.8.2 2159* Code changes: 2160 - New method in the PhoneNumberUtil API - getCountryMobileToken. 2161 2162Sep 19, 2013: libphonenumber-5.8.1 2163* Metadata changes: 2164 - New alternate formatting data for country calling code(s): 675 2165 - Updated phone metadata for region code(s): 2166 AO, AU, BF, BW, CA, CH, CI, CN, DE, FR, MA, MR, MU, NI, PG, SA, SE, US, VI 2167 - New short number metadata for region code(s): IQ 2168 - Updated short number metadata for region code(s): 2169 AU, BR, DO, EG, FR, GH, ID, IL, JM, KE, KZ, LR, MW, NG, NI, SA, SE, SL, TZ, US, UZ 2170 - New geocoding data for country calling code(s): 2171 966 (ar, en), 1 (en) 2172 2173Sep 2, 2013: libphonenumber-5.8 2174* Code changes: 2175 - Renamed ShortNumberUtil to ShortNumberInfo -> the former class is now deprecated and will be 2176 deleted in a later release. At the moment it just delegates to ShortNumberInfo. 2177 - New methods in the ShortNumberInfo API - isCarrierSpecific, singleton interface, 2178 isPossibleShortNumber, isValidShortNumber, getShortNumberCost. Note this is an experimental API 2179 at the moment and subject to change. 2180 - Bug fixes: 2181 -- AsYouTypeFormatting: 3-digit numbers can be formatted as a group where appropriate 2182 -- AsYouTypeFormatting: Countries with an optional national prefix were considered before to 2183 have always entered it, resulting in bugs where numbers without the national prefix were 2184 not properly formatted. 2185 -- Numbers in Chile that overlap with emergency numbers are no longer marked as connecting to 2186 them 2187 -- Not requiring the NDC to be alone for countries where there is no national prefix in strict 2188 grouping when extracting phone numbers 2189* Metadata changes: 2190 - New alternate formatting data for country calling code(s): 2191 30, 31, 385, 58, 62, 63, 971, 972 2192 - Updated alternate formatting data for country calling code(s): 43, 44, 49 2193 - Moved emergency phone number data to the ShortNumberMetadata.xml file 2194 - Updated phone metadata for region code(s): 2195 AT, EG, ML, NC, NL, SA 2196 - New short number metadata for region code(s): 2197 AR, CL, CO, ES, MX, NC 2198 - Emergency metadata fixes for region code(s): 2199 GA, JM, MH, VE 2200 2201Aug 09, 2013: libphonenumber-5.7.2 2202* Metadata changes: 2203 - New alternate formatting data for country calling code(s): 2204 352, 359, 372, 373, 375, 595, 7, 855 2205 - Updated phone metadata for region code(s): 2206 AR, BF, BH, BR, BY, CH, CM, CN, GE, GW, HN, JM, KH, LT, LU, MU, NP, RO, SO 2207 - New short number metadata for region code(s): BR 2208 - Updated short number metadata for region code(s): 2209 CH, FJ, GB, GG, IM, IT, JE, SH 2210 2211Aug 8, 2013: libphonenumber-5.7.1 2212* Metadata/code changes: 2213 - Change to the way the metadata is built; now only parts of the proto that are relevant will be 2214 generated. This means short-code data won't be generated for the normal protos, and fixed-line 2215 data won't be generated for short-number protos. This cuts the metadata binary size approximately 2216 in half. 2217 2218Jul 17, 2013: libphonenumber-5.7 2219* Code changes: 2220 - Improve phone number extraction recall. 2221 - Add support for loading short number metadata. 2222 2223Jul 16, 2013: libphonenumber-5.6.2 2224* Metadata changes: 2225 - Updated alternate formatting data for country calling code(s): 49, 61 2226 - New metadata for region code(s): TA 2227 - Updated metadata for region code(s): 2228 BF, BH, BI, BJ, BR, CR, EH, GA, GE, GN, GU, IL, IN, IR, KH, KW, KZ, MA, MT, 2229 NA, NE, NL, PH, RO, SH, SO, TK 2230 - New geocoding data for country calling code(s): 47 (en), 82 (ar) 2231 - Updated geocoding data for country calling code(s): 2232 49 (en), 98 (en, fa), 241 (en) 2233 2234Jul 12, 2013: libphonenumber-5.6.1 2235* Code changes: 2236 - Rename all instances of PhoneNumberMetadata to PhoneNumberMetadata for consistency. 2237 2238Jun 05, 2013: libphonenumber-5.6 2239* Code changes: 2240 - Fix for as-you-type-formatting bug affecting countries with no national prefix 2241 formatting rule, such as China. 2242* Metadata changes: 2243 - New alternate formatting data for country calling code(s): 351 2244 - Updated alternate formatting data for country calling code(s): 49 2245 - Updated metadata for region code(s): 2246 AS, BG, BH, BJ, BL, CD, CI, DE, DZ, EH, FJ, GF, GP, IN, KH, KZ, MA, MD, MF, 2247 ML, MY, NG, PT, PY, TC, TJ, TT 2248 2249May 08, 2013: libphonenumber-5.5 2250* Code changes: 2251 - Changed internal initialization code and made more fields final. 2252 Note that we now throw an exception if an attempt is made to set the 2253 metadata more than once (which should only happen during testing). 2254 - Fix problem with formatNumberForMobileDialing for HU and CL. 2255* Metadata changes: 2256 - Updated alternate formatting data for country calling code(s): 49 2257 - Updated metadata for region code(s): 2258 AM, BF, BR, CR, DE, MA, MG, MM, SA, TL, UA 2259 - Updated geocoding data for country calling code(s): 374 (am, en, ru) 2260 2261Apr 19, 2013: libphonenumber-5.4.2 2262* Metadata changes: 2263 - Updated metadata for region code(s): BF, GA, IN, KR, MV, PH, SO, UA, US 2264 2265Mar 25, 2013: libphonenumber-5.4.1 2266* Metadata changes: 2267 - Updated metadata for region code(s): BF, BH, CR, EC, IR, MG, PF, TD, TN 2268 - New geocoding data for country calling code(s): 374 (am, ru) 2269 - Updated geocoding data for country calling code(s): 2270 98 (en, fa), 358 (en, se), 374 (en) 2271 2272Mar 07, 2013: libphonenumber-5.4 2273* Code changes: 2274 - Switch formatNumberForMobileDialing to prefer national format to international format when the 2275 number is dialed from the same region the phone number is from. 2276 2277* Metadata changes: 2278 - Updated metadata for region code(s): 2279 BF, CD, CN, CZ, GN, IR, JP, KR, KW, LR, NZ, TT, UG, ZW 2280 - New geocoding data for country calling code(s): 82 (cs) 2281 - Updated geocoding data for country calling code(s): 2282 82 (en, fr, ko, zh, zh_Hant), 98 (en, fa), 263 (en) 2283 2284Feb 11, 2013: libphonenumber-5.3.2 2285* Metadata changes: 2286 - Updated metadata for region code(s): 2287 BD, BE, BY, CA, EH, GR, IE, IN, IS, LI, MA, MU, PT, SE, SG, TL 2288 - New geocoding data for country calling code(s): 2289 375 (be, en, ru), 1 (en) 2290 2291Jan 25, 2013: libphonenumber-5.3.1 2292* Metadata changes: 2293 - Updated metadata for region code(s): CN, DK, EH, GN, KH, KW, MA, MY, PA 2294 2295Jan 08, 2013: libphonenumber-5.3 2296* Code changes: 2297 - Handling UAN numbers in Argentina better when dialling them locally from a 2298 mobile 2299* Metadata changes: 2300 - Updated metadata for region code(s): 2301 BE, BW, CL, CN, CO, EH, KW, MA, ML, NG, PL, SY, ZA, ZM 2302 - New geocoding data for country calling code(s): 32 (en, fr, nl) 2303 - Updated geocoding data for country calling code(s): 27 (en), 86 (en, zh) 2304 2305Dec 06, 2012: libphonenumber-5.2.2 2306* Metadata changes: 2307 - New metadata for region code(s): EH 2308 - Updated metadata for region code(s): BR, CL, CR, IN, MA, PG, PK, RO 2309 - New geocoding data for country calling code(s): 241 (en) 2310 2311Nov 26, 2012: libphonenumber-5.2.1 2312* Metadata changes: 2313 - Updated metadata for region code(s): 2314 AE, AW, BF, CN, DE, JO, KE, KH, LT, MM, MU, NG, RW, SR, TR, VU 2315 - New geocoding data for country calling code(s): 359 (bg, en) 2316 2317Oct 10, 2012: libphonenumber-5.2 2318* Code changes: 2319 - Adds isNumberGeographical() method. 2320 - Adds getRegionCodesForCountryCode() method. 2321 - Fixing issue with getSupportedGlobalNetworkCallingCodes() 2322 [https://github.com/google/libphonenumber/issues/202] 2323 - Ensures that returned collections are unmodifiable where necessary 2324 [there is a very slight risk that this may break existing users who were relying on being able 2325 to modify these collections, but doing so would be breaking lots of other assumptions that this 2326 library makes - if you need to modify any affected collections you must copy them first] 2327* Metadata changes: 2328 - Updated metadata for region code(s): DE, GR, HR, OM, SB, ZA 2329 - Removed metadata for region code: AN (Netherlands Antilles) 2330 - Updated geocoding data for country calling code(s): 30 (el, en) 2331 2332Sep 27, 2012: libphonenumber-5.1.4 2333* Metadata changes: 2334 - Updated metadata for region code(s): AU, EC, KH, LB, TN, US 2335 2336Sep 17, 2012: libphonenumber-5.1.3 2337* Metadata changes: 2338 - Updated metadata for region code(s): EG, LA, LB, LI, PY 2339 - Updated metadata for non-geographical calling codes: 800, 808, 888, 979 2340 - Updated geocoding data for country calling code(s): 98 (en), 1 (en) 2341 2342Sep 11, 2012: libphonenumber-5.1.2 2343* Bug fix: 2344 - Fixing regression in AsYouTypeFormatter where it no longer worked for numbers entered in national 2345 format for countries with no national prefix, e.g. Spain. 2346 2347Sep 5, 2012: libphonenumber-5.1.1 2348* Code changes: 2349 - Added better logging/exception handling for catching cases where metadata is invalid/missing. 2350 2351Sep 3, 2012: libphonenumber-5.1 2352* Code changes: 2353 - Inserting a space after the national prefix in the AsYouTypeFormatter when formatting numbers in 2354 national format, if the formatting rules for that country dictate that a space is appropriate. 2355 - Format emergency numbers and short-codes as a block in the AsYouTypeFormatter. 2356* Metadata changes: 2357 - Updated metadata for region code(s): BF, BG, DZ, GA, IT, JP, KW, PF 2358 2359Aug 20, 2012: libphonenumber-5.0.3 2360* Metadata changes: 2361 - New alternate formatting data for country calling code(s): 43 2362 - Updated metadata for region code(s): AT, BF, JO, NG, RU, SL 2363 - New geocoding data for country calling code(s): 62 (en, id), 98 (fa) 2364 2365Aug 07, 2012: libphonenumber-5.0.2 2366* Metadata changes: 2367 - Updated metadata for region code(s): 2368 BF, CN, DJ, IL, JO, KH, KZ, MA, MT, MV, MY, NC, NG, SD, SK, SN, TL, UZ 2369 - New geocoding data for country calling code(s): 7 (ru), 98 (en) 2370 - Updated geocoding data for country calling code(s): 7 (en) 2371 2372July 26th, 2012: libphonenumber-5.0.1 2373* Metadata changes 2374 - CL, DE ,IN, KR, US 2375 - New geocoding data for country calling codes 40, 57, 66, 82, 91. 2376 - Fixed comments for 353 (IE). 2377 2378July 12th, 2012: libphonenumber-5.0 2379* Code changes: 2380 - Support for alternate formats when finding phone numbers. 2381 - Allowing two-digit numbers to be parsed if they are entered in national-format with no 2382 punctuation 2383* Metadata changes 2384 - IL, GA 2385* Other 2386 - Reflowed this file to 100 char width to make it unambiguous as to what the standard should be. 2387 2388July 6th, 2012: libphonenumber-4.9.1 2389* Metadata changes 2390 - AR, BA, BF, CR, DE, EC, ES, KZ, MK, NC, NG, PF, SB, UZ, non-geo entity 882 2391 - Geocoding data updates for country calling codes 54 (AR) and 81 (JP), new data for 234 (NG) 2392 2393June 21st, 2012: libphonenumber-4.9 2394* Bug fix 2395 - formatInOriginalFormat fixed not to add a star sign if it was not present originally. 2396* Metadata changes 2397 - BF, CZ, ES, KW 2398 - Non-geographical entities with calling code 882 (BebbiCell, Maritime Communications, Oration 2399 Technologies, Telespazio and Thuraya) 2400 - Geocoding data updates for country calling codes 221, 224, 226, 242, 244, 245 2401* Functionality changes: 2402 - Minimum allowed length for a national significant number (NSN) when parsing changed from 3 to 2. 2403 - Support parsing of RFC3966-formatted strings with an isdn-subaddress or extra parameters 2404 specified. 2405 - Allow soft hyphen to appear in phone numbers (\u00AD) 2406* Testing changes: 2407 - Add extra unit tests for non-geographical phone number entities 2408 - ExampleNumbersTest testEmergency tests now uses ShortNumberUtil 2409 2410June 14th, 2012: libphonenumber-4.8.5 2411* Metadata update only: 2412 - AC, CR, DE, DK, IL, IN, IS, KH, LI, LR, MA, MD, MK, PA, SA, SG, SS 2413 2414June 6th, 2012: libphonenumber-4.8.4 2415* Metadata update only: 2416 - AE, RO 2417 - Non-geographical entity with calling code 881 (Iridium) 2418 2419May 30th, 2012: libphonenumber-4.8.3 2420* Metadata update only: 2421 - AN, ET, KW, MN, SX, TC, TL 2422 2423May 16th, 2012: libphonenumber-4.8.2 2424* Metadata update only: 2425 - BH, CR, EE, JO, KW, LA, QA, SI, TH 2426 - Non-geographical entity with calling code 878 (VISIONng) 2427 2428May 8th, 2012: libphonenumber-4.8.1 2429* Metadata update only: 2430 - CA, CI, EG, HK, IN, IR, LB, MA, ME, MM 2431 - Non-geographical entity with calling code 870 (Inmarsat) 2432 - Geocoding updates for country calling codes 1 for new area codes 2433 2434April 24th, 2012: libphonenumber-4.8 2435* Functionality changes 2436 - RFC format now outputs a number starting with "tel:" 2437 - Parsing support for numbers in RFC format that contain the country info in the "phone-context" 2438 part 2439 - Support for obtaining area codes for Italy, Vatican City, San Marino 2440* Metadata changes 2441 - AM, AO, AR, BE, BF, CD, EG, GH, GM, GN, IN, IR, IT, JO, LA, LC, MD, MS, NO, PA, PK, SI, SJ, SO, 2442 SY, TC, TN, UZ, VN, ZW 2443 - Geocoding updates for country calling codes 1, 20, 233, 31, 33, 352, 374, 54, 56, 86 2444* Refactoring of matching functions, including moving them to PhoneNumberMatcher. 2445 2446March 16th, 2012: libphonenumber-4.7 2447* Bug fixes 2448 - Now return "too long" for input that is longer than 250 chars when parsing 2449* Metadata changes 2450 - AC,AM,AT,AZ,BF,BR,BY,BZ,CR,CU,DE,DJ,EE,EG,ET,GA,GH,HK,HN,ID,IN,JP,KE,KG,KH,KR,KW,KY,LB,LU,MA,MD, 2451 MK,NA,NE,NZ,SA,SB,SC,SE,SL,SN,UZ 2452* Refactoring of test classes so that tests requiring the test metadata to be loaded have a common 2453 base class which handles this. 2454 2455February 9th, 2012: libphonenumber-4.6 2456* Bug fixes 2457 - Fix for formatByPattern to enable RFC formatting to work 2458 - Fix for RFC formatting to work even when the international formatting rule starts with 2459 punctuation 2460 - Logging consistency changes - some warnings are no longer printed, others have become only 2461 WARNINGS 2462 - Fix for isValidNumberForRegion potentially throwing a NPE 2463 - Parsing Israeli * numbers written in international format now works 2464 - PhoneNumberMatcher doesn't match timestamps as phone-numbers 2465* Metadata changes 2466 - Updates for AN, AX, BF, BJ, BR, BS, DJ, FI, IN, LV, MW, RS, SC, VN 2467 - New countries supported: SS (South Sudan), CW (Curaçao) and BQ (Bonaire, Sint Eustatius and Saba) 2468* Refactoring of the private formatting functions in PhoneNumberUtil to ensure names are more 2469 descriptive and to reduce code duplication. 2470 2471January 19th, 2012: libphonenumber-4.5 2472* Code changes 2473 - Support for non-geographical country calling codes (e.g. +800). 2474 - Modify formatInOriginalFormat to not insert/remove/modify digits in the original number passed 2475 in. 2476 - Fix formatOutOfCountryKeepingAlphaChars to not throw a NPE. 2477 2478* Metadata changes 2479 - Updates for AR, BH, CI, CN, CR, DE, GA, IL, JO, JP, KE, KZ, LB, LK, LT, MV, MW, MZ, NA, NL, NZ, 2480 PL, RO, SA, SV, TM, UG, US 2481 - New country calling codes: 800, 808, 883, 888, 979 2482 - Geocoding data updates: AR, US 2483 2484December 9th, 2011: libphonenumber-4.4 2485* Code changes 2486 - Support for Voicemail numbers 2487 - Support prefixes "xt" and "xtn" to indicate extensions of phone numbers 2488 - Change formatInOriginalFormat to use raw_input for numbers with incorrect leading zeroes, instead 2489 of all invalid numbers. 2490 2491* Metadata changes 2492 - Updates for AR, BD, CH, CI, IL, IR, IS, IT, JP, KW, LR, MM, NG, SA, SC, UZ 2493 2494November 24th, 2011: libphonenumber-4.3 2495* Code changes 2496 - Fix the problems with AYTF crashing for longer numbers entered with +CountryCode, and incorrectly 2497 removing national prefix for some numbers. 2498 - Improve PhoneNumberMatcher to not match numbers ending with '%'. 2499 - Fix formatNumberForMobileDialing to handle Israeli star numbers, Peruvian and Colombian numbers. 2500 - Modify formatInOriginalFormat to use the raw input if we don't have a formatting pattern for a 2501 number. 2502 - Simple offline geocoding function which takes into account the user's region. 2503 2504* Metadata changes 2505 - Updates for CR, GN, JP, KE, PL, SG, SR, SX, TH, TK 2506 2507November 10th, 2011: libphonenumber-4.2 2508* Code changes 2509 - Providing an "exact match" isEmergencyNumber method 2510 - Improvement to PhoneNumberMatcher: requires national prefix to be present when matching 2511 national-format numbers, unless matching for a region where it is explicitly marked in the 2512 metadata that they may be omitted. Applies to leniency level VALID and higher. 2513 - Change formatNumberForMobileDialing not to modify the phoneNumber passed in. 2514 2515* Metadata changes 2516 - Emergency numbers added for all remaining countries 2517 - Collected data on which numbers we format with a national prefix are commonly written without one 2518 and added this 2519 - Updates for AR, AT, BH, CZ, GR, IR, KM, LT, MX, PT, SE, SO, UG 2520 - Addition of SX (Sint Maarten) 2521 2522October 19th, 2011: libphonenumber-4.1 2523* Code changes 2524 - Update code and metadata for countries with IDD "8~10" to accept phone numbers where the "~" is 2525 omitted. 2526 - Modify formatInOriginalFormat to use raw_input (when present) when the number is considered as 2527 invalid by the library. 2528 - Add ShortNumberUtil to deal with international short phone numbers, such as short codes and 2529 emergency numbers. 2530 - Increase the maximum phone-number length accepted when parsing (now set to 2531 16). 2532 2533* Metadata changes 2534 - Updates: BF, BN, CN, DE, DK, DO, FR, IN, KI, KW, MC, MD, ML, PA, QA, SB, UK, WS 2535 - Emergency number information also added to: AE, AF, AL, AM, AR, AT, AU, BA, 2536 BB, BD, BE, BG, BH, BO, BR, BY, CA, CH, CL, CN, CO, CR, CY, CZ, DE, DJ, DK, 2537 DO, DZ, EC, EE, EG, ES, FI, FJ, FO, FR, GB, GE, GF, GH, GI, GL, GR, GT, GY, 2538 HK, HN, HR, HU, ID, IE, IL, IN, IR, IS, IT, JM, JO, JP, KR, KW, KY, KZ, LB, 2539 LK, LT, LU, LV, MA, MC, MD, ME, MK, ML, MM, MN, MO, MT, MU, MV, MX, MY, NG, 2540 NI, NL, NO, NP, OM, PA, PE, PH, PK, PL, PM, PT, PY, QA, RO, RS, RU, RW, SA, 2541 SB, SD, SE, SG, SI, SK, SL, SM, SR, SV, SY, TD, TH, TJ, TM, TN, TR, TT, TW, 2542 UA, UG, US, UY, UZ, VA, VE, VN, VU, ZA, ZM, ZW 2543 2544October 6th, 2011: libphonenumber-4.0 2545* Code changes 2546 - New function formatNumberForMobileDialing, which attempts to format a number in such a way that 2547 the call can be connected from a mobile phone. If this is impossible, for example for numbers 2548 that cannot be internationally dialled, then an empty string is returned. 2549 - Fallback functionality to English for non-CJK languages for geocoding 2550 2551* Metadata changes 2552 - Collecting data for emergency numbers 2553 - Updates: AR, AU, BR, CN, CZ, EG, GD, IE, IL, JM, KW, KH, SD, SO, TR, UG, UZ 2554 - Geocoding data changes: AO, AR, AT, BJ, BR, CD, CG, CI, CL, CN, CV, DE, ES, 2555 FR, GR, GW, HU, KM, MR, MZ, NL, PL, PT, SE, ST, SZ 2556 2557September 13th, 2011: libphonenumber-3.9 2558* Code changes 2559 - Enable AsYouTypeFormatter to handle long IDD and NDD. 2560 - Allow the presence of an IDD following a +. 2561 - Fix formatting of phone numbers which contain only 0s in the national number. 2562 - Refactored some code in geocoding including AreaCodeMap and the storage strategies. 2563 2564* Metadata changes 2565 - Updates: AM, BE, BH, BJ, BR, BT, BZ, CI, CL, CN, DE, DK, DM, DZ, EC, EG, FJ, 2566 GR, HR, HT, IN, IQ, IS, JM, KE, KG, KH, KR, LA, LB, LR, MA, MD, ML, MO, MX, 2567 MY, NE, NG, PG, PH, PK, PY, QA, SA, SD, SG, SN, TD, TG, TH, TN, TT, UG, YE, 2568 ZA, ZM 2569 - New geocoding data for: AC, CG, CU, CV, EG, ET, FI, FI, FI, GL, JP, KM, MA, 2570 MA, MU, MU, MU, MZ, RS, SH, SH, SL, SO, ST, TG, TG, TG, UG, ZM 2571 - Updated geocoding data for: AR, DE 2572 2573August 11th, 2011: libphonenumber-3.8 2574* Code changes 2575 - Fix to demo to not throw null-ptr exceptions for invalid NANPA numbers 2576 - Fixed AYTF to not accept plus signs in the middle of input 2577 - PhoneNumberMatcher improvements - added STRICT_GROUPING and EXACT_GROUPING levels, numbers 2578 followed/preceded by a currency symbol will not match, multiple numbers separated by phone-number 2579 punctuation will now match. ", " is no longer accepted as an extension symbol when matching, only 2580 when parsing. "x" is only accepted as a carrier code or extension marker, not otherwise. 2581 - Changes to handling of leading zeroes - these will not be silently ignored anymore, but will be 2582 stored as part of the number. 2583 - PhoneNumberOfflineGeocoder - new method to get the description of a number that assumes the 2584 validity of the number has already been checked and will not re-verify it. 2585 - Split geocoding US binary data into multiple files. 2586 2587* Metadata changes 2588 - Updates: AR, AT, AU, AZ, BE, BF, BH, BY, CA, CN, CO, CR, HT, HU, IT, KG, KH, 2589 LB, LI, ME, NC, RS, SE, TT, US, VG, ZA 2590 - New geocoding data for: AL, AM, AO, BF, BJ, BW, CD, CI, CZ, DZ, EE, GH, GM, 2591 GN, GR, GW, HU, IS, KE, LK, LS, LT, LU, LV, MD, MG, MR, NA, PE, QN, SD, SK, 2592 SN, SZ, TN, VE, VN, ZA, ZW 2593 - Updated geocoding data for: GB, PT, US 2594 - Revised sorting of geocoding data 2595 2596July 5th, 2011 2597* Code changes 2598 - Refactored AreaCodeMap to minimize binary and memory footprint by using 2 different strategies. 2599 - Refactored BuildMetadataFromXml.java and added unittests. 2600 2601* Metadata changes 2602 - Regenerate binaries for all existing area code mapping data with smaller sizes. 2603 - Added city-level area code data mapping for US and Canada. 2604 2605June 29th, 2011 2606* Code changes 2607 - Fixed issue 38, issue 39, issue 41 and issue 43 2608 2609* Metadata changes 2610 - Added phone number area mapping files for 2611 - JP in Japanese 2612 - FR in French 2613 - TW in English, Simplified and Traditional Chinese 2614 - RU in English 2615 - IT in English and Italian 2616 - PT in Portuguese 2617 - TR in English and Turkish 2618 - CH in English, German, French and Italian 2619 - Updates: CR, GE, IT, JP, KW, MH, MP, MU, PE, PM, RW, TG, TJ, TK 2620 2621June 14th, 2011 2622* Code changes 2623 - Added PhoneNumberOfflineGeocoder, supporting classes and their unittests. 2624 - Added GenerateAreaCodeData to transform phone number area mapping files from text files to binary 2625 files. 2626 - Modified PhoneNumberParserServlet.java and phonenumberparser.jsp to incorporate 2627 PhoneNumberOfflineGeocoding in the appengine demo. 2628 2629* Metadata changes 2630 - Added phone number area mapping files for NANPA countries and GB in English, NL in Dutch, AR, CL 2631 and ES in Spanish, AT and DE in German, SE in Swedish, BR in Portuguese, KR in English, Korean, 2632 Simplified and Traditional Chinese, and CN in Simplified Chinese. 2633 2634June 10th, 2011 2635* Code changes: 2636 - Fixes for PhoneNumberMatcher to be more restrictive in valid mode and not match numbers 2637 surrounded by Latin characters. This ensures, for example, the string abc123456789acg will not be 2638 marked as a phone numbers. 2639 - Enable PhoneNumberUtil to handle all digits, rather than a subset 2640 - Fix for AYTF issue36 and improvement for US AYTF behaviour. 2641* Metadata changes: 2642 - Updates: BG, EG, ES, GH, PF, SC, SY, VA 2643 2644May 24th, 2011 2645* Code changes: 2646 - Phonenumber now implements Serializable. 2647 - findNumbers doesn't accept numbers with mis-matched brackets as phone-numbers 2648 - An offline phone number geocoder has been added. The current implementation just returns the 2649 region name for the phone number; more detailed geocoding will be added later. 2650* Metadata changes: 2651 - New countries: GF, KP, NC, PA, PF, PW, PY, SB, SR, TO, UY, VU 2652 - Updates: CY, CZ, ES, GB, GQ, JM, MQ, TN, VI 2653 2654May 9th, 2011 2655* Code changes: 2656 - Fixed potential for a null-ptr exception in getExampleNumber 2657 - Potential speed improvement with replacement of StringBuffer with StringBuilder 2658* Metadata changes 2659 - Changed way that international formats are specified to make it easier to do so 2660 - New countries: AX, CC, CX, WF 2661 - Updates: AM, AR, AU, AW, CN, CO, CR, DM, EC, ET, FI, FJ, GH, IN, JP, KE, KM, 2662 KN, LR, MD, MQ, MX, NP, PH, SC, SE, SM, SN, SY, UG, US, VC, VI, ZM 2663 2664Apr 26th, 2011 2665* Code changes: 2666 - Improved PhoneNumberMatcher for cases with other numbers before or after the phone number. 2667 - Improved AsYouTypeFormatter not to use formatting rules containing non-formatting characters 2668 (e.g. '*' in Israeli star numbers). 2669* Metadata changes: 2670 - New countries: FJ, FM, GY, NF, NI, NR, TV. 2671 - Updates: AM, AZ, BF, BW, BZ, CI, CR, GB, GP, HK, JM, KH, LB, LY, MV, PE, PK, SZ, TJ, US. 2672* Minor documentation updates 2673 2674Apr 11th, 2011 2675* Bug fixes: 2676 - Adding date exclusion pattern in PhoneNumberMatcher. 2677 - Fixing bug with selecting a suitable region for numbers with leading zeros where mutiple regions 2678 for that country code are possible. 2679* Metadata changes: 2680 - Updates: AG, AI, AS, BB, BM, BS, CA, DM, DO, ET, FO, GD, GE, GU, IN, JM, KN, KY, LC, MN, MP, MR, 2681 MS, NO, PR, TC, TR, TT, US, VC, VG, VI 2682 - New countries: CK, FK, GT, IO, KI, SJ, SV 2683* Documentation updates and some small refactoring to AsYouTypeFormatter 2684 2685Mar 31st, 2011 2686* New functionality: 2687 - Can parse and format numbers in RFC-3966 format. 2688 - Added isAlphaNumber to check to see if a number is a "vanity" or "alpha" number 2689 - Can format a number made up of alpha-characters in an "out-of-country" format (e.g. 0011 1 2690 800-SIX-FLAG to dial an American alpha-number from Australia). 2691* Code changes: 2692 - Renamed private vars, private methods and fixed comments to try and differentiate between country 2693 (calling) codes and region codes. 2694 == Non-backwards-compatible API changes: == 2695 - Renamed getSupportedCountries to getSupportedRegions, as this more accurately reflects that the 2696 library is based around region codes. 2697 - getNationalSignificantNumber is no longer a static method, but is instead an instance method. 2698* Metadata changes: 2699 - Bug-fixes and updates for AU, AZ, EE, FI, IN, JO, KW, KZ, MV, RU, RR, VA 2700 - New country: ME 2701 2702Mar 22nd, 2011 2703* Metadata changes: 2704 - New mobile-number pattern for AU 2705 2706Mar 10th, 2011 2707* New functionality: 2708 - New function to format a number with the preferred domestic carrier code used when parsing, 2709 falling back to a default calling code otherwise (formatNationalNumberWithPreferredCarrierCode). 2710 - We now store the preferred domestic carrier code used when the user calls parseAndKeepRawInput 2711 - New functionality to extract phone-numbers from text (findNumbers). This is just the first 2712 version - it does not extract ALPHA numbers such as 0800 CALL ME, or numbers where alternate 2713 endings are specified (such as 03-331 6005/6006). 2714* Code changes: 2715 - Tidying up the test file to use several pre-defined phone number constants 2716 - Fixing several lint errors 2717 - Added javadoc to formatNationalNumberWithCarrierCode 2718 - Fixed bug where a null pointer exception was thrown when getAsYouTypeFormatter was called with an 2719 invalid region code 2720 - Improved AsYouTypeFormatter to deal with countries with variable-length patterns such as LU 2721* Metadata changes: 2722 - Bug-fixes and updates for the following countries: BF, BO, BR, CL, CO, CR, DK, FO, GE, KR, KW, 2723 LA, LU, MU, SC, SH, TR, VE 2724 - New country: SH 2725 2726Mar 10th, 2011 2727* Code changes: 2728 - releasing the code to run the demo on localhost or appengine. 2729 2730Mar 7th, 2011 2731* Metadata changes: 2732 - Adding support for AC 2733 2734Feb 11th, 2011 2735* Metadata changes: 2736 - Update UAN number ranges for IM and JE. 2737 2738Feb 9th, 2011 2739* Code changes: 2740 - Better isNumberMatch method. This will now recognise numbers starting with a national prefix as 2741 an NSN_MATCH, instead of SHORT_NSN_MATCH. 2742 == Note Non-backwards-compatible API change here! == 2743 This will no longer throw a NumberParseException - instead we will return NOT_A_NUMBER if one 2744 or other of the numbers provided do not match. 2745 - New number-type UAN now supported in the code. This represents Company Numbers or Universally 2746 Accessible Numbers. 2747* Metadata changes: 2748 - Bug-fixes and updates for the following countries: AG, AZ, BA, BE, CA, CU, ES, FI, GB, GD, GG, 2749 IE, IL, IM, IN, IR, IT, JE, JP, KR, KW, NG, NZ, PK, PS, PT, RU, SE, SG, SY, US 2750 - New countries: CO, LU, LY, MC, SM 2751 - Addition of "Personal Number" ranges to all NANPA countries 2752 2753Jan 31st, 2011 2754* Code changes: 2755 - Introducing equals() and hashCode() methods for the Phonenumber.PhoneNumber class 2756 2757Jan 28th, 2011 2758* Code changes: 2759 - Fixing critical bug with non-Android-compatible code. isEmpty() was being used and CANON_EQ in 2760 reg-ex matches. 2761 2762Jan 20th, 2011 2763* Code improvements: 2764 - Handle null phone-numbers when parsing by throwing a NumberParseException. 2765 - Handle extension written with an accented "o", as per Spanish, when parsing. 2766 - Handle U+30FC dashes as phone-number punctuation. 2767 - Allow "ZZ" or null regions to be specified for numbers starting with a full-width "+" symbol, or 2768 with other characters (such as whitespace) before the leading +. 2769 - new getLengthOfNationalDestinationCode function 2770* Metadata changes: 2771 - New types of numbers introduced: UAN (universal or "company" numbers) and short codes. Note that 2772 "generalDesc" patterns do not encompass short-codes. No code-support for these has been 2773 introduced as of yet. We are also now enabling the collection of data for information such as 2774 area-code-optional, and no-international-dialling ranges. 2775 - Data updates as per ITU notifications/bug fixes for the following countries: AM, BH, CD, CG, CR, 2776 DE, DJ, EE, GB, GN, HU, IE, JO, JP, LB, LR, MA, MK, MN, MR, NA, PG, SC, SG, SO, SZ, VN, ZA, ZW 2777 - Data added for the following countries: BZ, CU, EC, FO, GI, HN, HT, LK, MT, MV, NU, PS, SD 2778 - Indentation fixes in reg-exes for the following countries: BG, GB 2779 - Allow nationalPrefixForParsing to be specified for countries with no national prefix, to handle 2780 possible carrier prefixes 2781 2782Jan 3rd, 2011 2783* Metadata changes: 2784 - Updates to JE 2785 - Updated comments for GB/GG/IM/JE 2786 2787November 25th, 2010 2788* Metadata changes: 2789 - Updates to existing countries: AD, AG, AI, AN, AS, BB, BG, BM, BS, BW, CA, DM, DO, GD, GH, GM, 2790 GU, IN, JM, KN, KY, KZ, LB, LC, MP, MS, PR, SY, TC, TT, TZ, US, VC, VG, VI. 2791 - Reorganize reg-exes for better readability. 2792 - Updated comments. 2793 2794October 22nd, 2010 2795* Metadata changes: 2796 - Updates to existing countries: AE, GB, GG, IM, JE 2797 2798October 15th, 2010 2799* Code improvements: 2800 - Allowed parsing of numbers that start with "++" or a full-width "+" symbol 2801 - Allowed reg-exes for national and possible number patterns to have white space in them in the 2802 source XML file 2803 - Added a more useful toString method for the phone number proto class 2804* Metadata changes: 2805 - Updates to existing countries: AF, BF, BO, ES, GB, GG, IM, IS, JE, JE, JP, KR, PE, PT, RU, SE, 2806 TT, ZW 2807* Bug fixes: 2808 - Parsing empty strings with invalid region codes no longer throws a null pointer exception 2809 2810September 4th, 2010 2811* Code improvement: 2812 - Added new phone number type: pager 2813* Metadata change: 2814 - update to existing country: GG, IM, JE, RS, RU 2815* Bug fixes: 2816 - ArrayOutOfBoundException in AsYouTypeFormatter.getRememberedPosition() 2817 - AsYouTypeFormatter for UK childline number 2818 2819September 1st, 2010 2820* Bug fix on KZ metadata. 2821 2822August 17th, 2010 2823* Code improvement: 2824 - Refactored BuildMetadataProtoFromXml.java into BuildMetadataFromXml.java and 2825 BuildMetadataProtoFromXml.java 2826 - Added BuildMetadataProtoFromXml.java and JSArrayBuilder.java 2827 - Refactored CountryCodeToRegionCodeMap and CountryCodeToRegionCodeMapForTesting into separate 2828 files. 2829 2830August 16th, 2010 2831* Bug fixes 2832 - AsYouTypeFormatter for formatting Chinese geographical numbers entered in national format. 2833 - AsYouTypeFormatter for formatting Chinese 400/800 numbers entered in national format. 2834* Metadata change: 2835 - new countries: AM, AN, BH, GL, IS 2836 - adding national prefix 1 to all NANPA countries. 2837 - update to existing countries: BF, FR, UK, PK, RE 2838 2839August 4th, 2010 2840* Further improve startup performance 2841 - Preload no country specific metadata at startup. 2842 - Stop creating the file containing mapping from country calling code to region code and loading 2843 it at startup; instead, do the initialization in PhoneNumberUtil. 2844 2845July 31th, 2010 2846 2847* Improve startup performance 2848 - Separate generated metadata binary file to one file per region 2849 - Preload US at start up, and load other region at the time when needed 2850 - Create a file containing mapping from country calling code to region code, and load it at 2851 startup 2852 - Same change also applied to unittests 2853 2854July 30th, 2010 2855* Metadata change: 2856 - new country: TL 2857 - update to existing country: AZ, CN, FR, GH, JO, LA, PG, PK, QA, SZ, UA, VN 2858 2859* Code improvement 2860 - China local number formatting for AsYouTypeFormatter 2861 - improve extension parsing to handle number in the form of +1 (645) 123 1234 ext. 910# 2862