geoip_region_by_name(3) [php man page]

GEOIP_REGION_BY_NAME(3) 						 1						   GEOIP_REGION_BY_NAME(3)

geoip_region_by_name - Get the country code and region

SYNOPSIS

       array geoip_region_by_name (string  $hostname)

DESCRIPTION

	The geoip_region_by_name(3) function will return the country and region corresponding to a hostname or an IP address.

	This  function	is  currently  only  available to users who have bought a commercial GeoIP Region Edition. A warning will be issued if the
       proper database cannot be located.

	The names of the different keys of the returning associative array are as follows:

	      o "country_code" -- Two letter country code (see geoip_country_code_by_name(3))

	      o "region" -- The region code (ex: CA for California)

PARAMETERS

	      o $hostname
		- The hostname or IP address whose region is to be looked-up.

RETURN VALUES

	Returns the associative array on success, or FALSE if the address cannot be found in the database.

EXAMPLES

       Example #1

	      A geoip_region_by_name(3) example

	       This will print the array containing the country code and region of the host example.com.

	      <?php
	      $region = geoip_region_by_name('www.example.com');
	      if ($region) {
		  print_r($region);
	      }
	      ?>

	      The above example will output:

	      Array
	      (
		  [country_code] => US
		  [region] => CA
	      )

PHP Documentation Group 												   GEOIP_REGION_BY_NAME(3)

GEOIP_REGION_NAME_BY_CODE(3)						 1					      GEOIP_REGION_NAME_BY_CODE(3)

geoip_region_name_by_code - Returns the region name for some country and region code combo

SYNOPSIS

       string geoip_region_name_by_code (string  $country_code, string	$region_code)

DESCRIPTION

	The geoip_region_name_by_code(3) 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.

PARAMETERS

	      o $country_code
		- The two-letter country code (see geoip_country_code_by_name(3))

	      o $region_code
		- The two-letter (or digit) region code (see geoip_region_by_name(3))

RETURN VALUES

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

EXAMPLES

       Example #1

	      A geoip_region_name_by_code(3) example using region code for US/Canada

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

	      <?php
	      $region = geoip_region_name_by_code('CA', 'QC');
	      if ($region) {
		  echo 'Region name for CA/QC is: ' . $region;
	      }
	      ?>

	      The above example will output:

	      Region name for CA/QC is: Quebec

       Example #2

	      A geoip_region_name_by_code(3) example using FIPS codes

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

	      <?php
	      $region = geoip_region_name_by_code('JP', '01');
	      if ($region) {
		  echo 'Region name for JP/01 is: ' . $region;
	      }
	      ?>

	      The above example will output:

	      Region name for JP/01 is: Aichi

PHP Documentation Group 											      GEOIP_REGION_NAME_BY_CODE(3)