As with PhoneNumberUtil, the Phone Number Geocoder uses a singleton.
$geoCoder = \libphonenumber\geocoding\PhoneNumberOfflineGeocoder::getInstance();
Returns a text description for the supplied PhoneNumber
object, in the $locale
language supplied.
The description returned might consist of the name of the country, or the name of the geographical area the phone number is from.
If $userRegion
is supplied, it will also be taken into consideration. If the phone number is from the same region, only a lower-level description will be returned.
$gbNumber = \libphonenumber\PhoneNumberUtil::getInstance()->parse('0161 496 0123', 'GB');
var_dump($geoCoder->getDescriptionForNumber($gbNumber, 'en'));
// string(10) "Manchester"
var_dump($geoCoder->getDescriptionForNumber($gbNumber, 'en_GB', 'GB'));
// string(10) "Manchester"
var_dump($geoCoder->getDescriptionForNumber($gbNumber, 'en_GB', 'US'));
// string(14) "United Kingdom"
var_dump($geoCoder->getDescriptionForNumber($gbNumber, 'ko-KR', 'US'));
// string(6) "영국" (Korean for United Kingdom)
$usNumber = \libphonenumber\PhoneNumberUtil::getInstance()->parse("+1 650 253 0000", "US");
var_dump($geoCoder->getDescriptionForNumber($usNumber, 'en'));
// string(10) "Mountain View, CA"
var_dump($geoCoder->getDescriptionForNumber($usNumber, 'en_GB', 'GB'));
// string(10) "United States"
var_dump($geoCoder->getDescriptionForNumber($usNumber, 'en_GB', 'US'));
// string(14) "Mountain View, CA"
var_dump($geoCoder->getDescriptionForNumber($usNumber, 'ko-KR', 'US'));
// string(6) "미국" (Korean for United States)
Returns the same as getDescriptionForNumber()
, but assumes that you have already checked whether the number is suitable for geolocation.