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