PHP Portal » PHP Handbuch » geoip_region_name_by_code

Werbung

geoip_region_name_by_code


(PECL geoip >= 1.0.4)

geoip_region_name_by_codeReturns the region name for some country and region code combo

Beschreibung

string geoip_region_name_by_code ( string $country_code , string $region_code )

The geoip_region_name_by_code() function will return the region name corresponding to a country and region code combo.

In the United States, the region code corresponds to the two-letter abbreviation of each state. In Canada, the region code corresponds to the two-letter province or territory code as attributed by Canada Post.

For the rest of the world, GeoIP uses FIPS 10-4 codes to represent regions. You can check » http://www.maxmind.com/app/fips10_4 for a detailed list of FIPS 10-4 codes.

This function is always available if using GeoIP Library version 1.4.1 or newer. The data is taken directly from the GeoIP Library and not from any database.

Parameter-Liste

country_code

The two-letter country code (see geoip_country_code_by_name())

region_code

The two-letter (or digit) region code (see geoip_region_by_name())

Rückgabewerte

Returns the region name on success, or FALSE if the country and region code combo cannot be found.

Beispiele

Beispiel #1 A geoip_region_name_by_code() example using region code for US/Canada

This will print the region name for country CA (Canada), region QC (Quebec).

PHP Code
1
2
3
4
$region = geoip_region_name_by_code('CA', 'QC'); if ($region) { echo 'Region name for CA/QC is: ' . $region; }

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

Region name for CA/QC is: Quebec

Beispiel #2 A geoip_region_name_by_code() example using FIPS codes

This will print the region name for country JP (Japan), region 01.

PHP Code
1
2
3
4
$region = geoip_region_name_by_code('JP', '01'); if ($region) { echo 'Region name for JP/01 is: ' . $region; }

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

Region name for JP/01 is: Aichi