geoip_time_zone_by_country_and_region(3) [php man page]

GEOIP_TIME_ZONE_BY_COUNTRY_AND_REGION(3)				 1				  GEOIP_TIME_ZONE_BY_COUNTRY_AND_REGION(3)

geoip_time_zone_by_country_and_region - Returns the time zone for some country and region code combo

SYNOPSIS

       string geoip_time_zone_by_country_and_region (string  $country_code, [string  $region_code])

DESCRIPTION

	The geoip_time_zone_by_country_and_region(3) function will return the time zone 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 time zone on success, or FALSE if the country and region code combo cannot be found.

EXAMPLES

       Example #1

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

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

	      <?php
	      $timezone = geoip_time_zone_by_country_and_region('CA', 'QC');
	      if ($timezone) {
		  echo 'Time zone for CA/QC is: ' . $timezone;
	      }
	      ?>

	      The above example will output:

	      Time zone for CA/QC is: America/Montreal

       Example #2

	      A geoip_time_zone_by_country_and_region(3) example using FIPS codes

	       This will print the time zone for country JP (Japan), region 01 (Aichi).

	      <?php
	      $timezone = geoip_time_zone_by_country_and_region('JP', '01');
	      if ($timezone) {
		  echo 'Time zone for JP/01 is: ' . $timezone;
	      }
	      ?>

	      The above example will output:

	      Time zone for JP/01 is: Asia/Tokyo

PHP Documentation Group 										  GEOIP_TIME_ZONE_BY_COUNTRY_AND_REGION(3)

GEOIP_RECORD_BY_NAME(3) 						 1						   GEOIP_RECORD_BY_NAME(3)

geoip_record_by_name - Returns the detailed City information found in the GeoIP Database

SYNOPSIS

       array geoip_record_by_name (string  $hostname)

DESCRIPTION

	The geoip_record_by_name(3) function will return the record information corresponding to a hostname or an IP address.

	This  function	is available for both GeoLite City Edition and commercial GeoIP City Edition. A warning will be issued if the proper data-
       base cannot be located.

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

	      o "continent_code" -- Two letter continent code (as of version 1.0.4 with libgeoip 1.4.3 or newer)

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

	      o "country_code3" -- Three letter country code (see geoip_country_code3_by_name(3))

	      o "country_name" -- The country name (see geoip_country_name_by_name(3))

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

	      o "city" -- The city.

	      o "postal_code" -- The Postal Code, FSA or Zip Code.

	      o "latitude" -- The Latitude as signed double.

	      o "longitude" -- The Longitude as signed double.

	      o "dma_code" -- Designated Market Area code (USA and Canada only)

	      o "area_code" -- The PSTN area code (ex: 212)

PARAMETERS

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

RETURN VALUES

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

CHANGELOG

       +--------+---------------------------------------------------+
       |Version |						    |
       |	|						    |
       |	|		     Description		    |
       |	|						    |
       +--------+---------------------------------------------------+
       | 1.0.4	|						    |
       |	|						    |
       |	|  Adding the  continent_code  with  GeoIP  Library |
       |	| 1.4.3 or newer only				    |
       |	|						    |
       | 1.0.3	|						    |
       |	|						    |
       |	|	Adding country_code3 and country_name	    |
       |	|						    |
       +--------+---------------------------------------------------+
EXAMPLES

       Example #1

	      A geoip_record_by_name(3) example

	       This will print the array containing the record of host example.com.

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

	      The above example will output:

	      Array
	      (
		  [continent_code] => NA
		  [country_code] => US
		  [country_code3] => USA
		  [country_name] => United States
		  [region] => CA
		  [city] => Marina Del Rey
		  [postal_code] =>
		  [latitude] => 33.9776992798
		  [longitude] => -118.435096741
		  [dma_code] => 803
		  [area_code] => 310
	      )

PHP Documentation Group 												   GEOIP_RECORD_BY_NAME(3)