Home ] Contact Us ] Support ] Forums ] Pricing ] Buy Now! ] Free Services ] Merchandise ] IP Address Locator ] Trace Route Locator ] Spam Locator ]  

 


Up

Login to Client Services Center Geobytes Home Page  

Looking for FREE
geographic page
re-directs - 
click here

 


See me in
the demo
(Click Here)

 


Get yourself
a $49
developers
license

(Click Here)

Understanding the Geo Tags & Geobytes Headers

GeoSelect provides two methods for incorporating geographical customization into web sites. 
These methods are 

  • Geo Tags
    The Geo Tags are HTML style tags that are used just like any other HTML tag. There are just 3 tags that need to be used and they are <geoselect>, <geoif> and <geobytes>.
    geobytes tags act as placeholders for dynamic content, and may appear anywhere within the page, although normally they would be found within geoif tags.
  • Geobytes Headers
    This method allows you to access the geographical information at the server-side and use it with PHP, ASP, Perl or any other kind of server-side script. GeoSelect inserts the viewer’s location into the HTTP headers before the request is passed to any applications. There are more than 20 Geobytes headers to choose from. You can also use the HTML-style <geo> tags in conjunction with the Geobytes Headers. 
    There are quite a number of headers that you can use to customize data within your web application, a list of the available headers is included below.

 

The following section contains a description of the supported Country, Region, City, DMA and Subnet tags and headers.

Country Tags & Headers

The available country tags and headers are as follows: 

Country headers

HTTP_GEOBYTESCOUNTRYID

HTTP_GEOBYTESCOUNTRY

HTTP_GEOBYTESFIPS104

HTTP_GEOBYTESISO2

HTTP_GEOBYTESISO3

HTTP_GEOBYTESISON

HTTP_GEOBYTESINTERNET

HTTP_GEOBYTESCAPITAL

HTTP_GEOBYTESMAPREFERENCE

HTTP_GEOBYTESNATIONALITYSINGULAR

HTTP_GEOBYTESNATIONALITYPLURAL

HTTP_GEOBYTESCURRENCY

HTTP_GEOBYTESCURRENCYCODE

HTTP_GEOBYTESPOPULATION

HTTP_GEOBYTESCOUNTRYTITLE

Description of Country headers
The purpose of each of these fields is documented below.

  • CountryId; this field is an internal key used to relate a specific row in this table to related rows in the Regions, Cities, and Dmas tables. This is the primary key and is unique. The number “113” for example is the key for India.
  • Country; this field is a string representation of the country name, for example, “India”, “Singapore” or “Canada”.
  • FIPS104; FIPS104 or more precisely FIPS 10-4 is a publication by the Federal Information Processing Standards body that identifies geopolitical entities around the world with a code. For example, “AS07” is the state of Victoria in Australia. This field represents logical groupings of these four letter codes, so in this example the letters “AS” would be stored in the “FIPS104” field. More information about this publication can be found at the National Imagery and Mapping Agency at http://www.nima.mil and http://www.nima.mil/gns/html/index.html. 
  • ISO2; this field represents the “A 2” column in the ISO 3166 document which lists each country with associated alpha and numeric codes. More information on ISO 3166 standard can be found at the International Organization for Standardization web-site at http://www.iso.org/iso/en/prods-services/iso3166ma/02iso-3166-code-lists/list-en1.html. An example is “US” which represents the United States of America.
  • ISO3; this field represents the “A 3” column in the ISO 3166 document which lists each country with associated alpha and numeric codes. More information on ISO 3166 standard can be found at the International Organization for Standardization web-site at http://www.iso.org/iso/en/prods-services/iso3166ma/02iso-3166-code-lists/list-en1.html. An example is “GTM” which represents Guatemala.
  • ISON; this field represents the “Number” column in the ISO 3166 document which lists each country with associated alpha and numeric codes. More information on the ISO 3166 standard can be found at the International Organization for Standardization web-site at http://www.iso.org/iso/en/prods-services/iso3166ma/02iso-3166-code-lists/list-en1.html. An example is “036” which represents Australia.
  • Internet; this field represents the “ccTLD” code designated by IANA (Internet Assigned Numbers Authority) which is employed in the DNS to identify hosts in various countries around the world. For example, the code “uk” is assigned to the United Kingdom. The “ccTLD” codes are based on the “A 2” column of the ISO 3166 standard document. More information on the Internet Assigned Numbers Authority can be found at http://www.iana.org, more information on the International Organization for Standardization can be found at http://www.iso.org.
  • Capital; this field is a string representation of a given countries capital city, for example, the capital of United States is “Washington, DC”. This information was referenced from the CIA web-site and can be found at http://www.cia.gov/cia/publications/factbook/.
  • MapReference; this field is a string representation of a given countries, major reference point in the world, for example, the map reference for Canada is “North America”. This information was referenced from the CIA web-site and can be found at http://www.cia.gov/cia/publications/factbook/.
  • NationalitySingular; this field is a string representation, referring to a singular expression of a given countries nationality. For example, the singular expression of a person from the United States would be “American”. This information was referenced from the CIA web-site and can be found at http://www.cia.gov/cia/publications/factbook/.
  • NationalityPlural; this field is a string representation, referring to a plural expression of a given countries nationality. For example, the plural expression of people from the United States would be “Americans”. This information was referenced from the CIA web-site and can be found at http://www.cia.gov/cia/publications/factbook/.
  • Currency; this field is a string representation of a given countries currency, for example, the currency of United States would be “US Dollar”. This information was referenced from the CIA web-site and can be found at http://www.cia.gov/cia/publications/factbook/.
  • CurrencyCode; this field is a 3 character string representation of a given countries currency code. The codes are based on the ISO 4217 where the first 2 characters are made up of the countries Internet code and the last is a currency designator. For example the currency code “USD” is the code for the US Dollar. More information on the ISO standardization can be found at http://www.iso.org.
  • Population; this field represents a given countries population, based on an estimate as of July 2001, and is referenced from the CIA web-site. More information can be found at the CIA web-site at http://www.cia.gov/cia/publications/factbook/.
  • CountryTitle; this field is a string representation of a given country's title as it would appear in a sentence. For example:- The “title” for United States is “The United States”.

A comparison of the different internationally recognized codes for countries can be found at http://www.statoids.com/wab.html. The CIA FactBook also contains such a list http://www.cia.gov/cia/publications/factbook/.

Region/State Tags & Headers

The available country tags and headers are as follows:

Region/State headers

HTTP_GEOBYTESREGIONID

HTTP_GEOBYTESREGION

HTTP_GEOBYTESCODE

HTTP_GEOBYTESADM1CODE

Description of headers
The purpose of each of these fields is documented below.

  • RegionId; this field is an internal key used to relate a specific row in this table to related rows in the “Cities” table.
  • Region; this field is the character representation of the sub-country geographical region. For example, the value of this column might be the state “Florida” in the USA or “New South Wales” in Australia.
  • Code; this field is a 2 character code used to represent the general abbreviation for a sub-country geographical region. The were referenced from http://www.mindspring.com/~gwil/statoids.html#codes Each region has a unique code within a given country, and existing official codes were used where possible. "Official" can mean various things, but the ISO 3166-2 codes have been favored http://www.iso.org/iso/en/prods-services/iso3166ma/04background-on-iso-3166/iso3166-2.html. The codes are mnemonic. They consist of the first letter in the subdivision name, followed by a letter that occurs later in that name, unless it was impossible to assign unique codes by that rule.
  • ADM1Code; this field is related to the “FIPS104” field in the “Countries” table. Where the “FIPS104” code is used to identify a geopolitical region at country resolution, the “ADM1Code” is used to identify a geopolitical region at a sub-country region. For more information on the “ADM1Code” field visit the National Imagery and Mapping Agency Internet site at http://www.nima.mil/gns/html/index.html

City Tags & Headers

The available country tags and headers are as follows:

City headers

HTTP_GEOBYTESCITYID

HTTP_GEOBYTESCITY

HTTP_GEOBYTESLATITUDE

HTTP_GEOBYTESLONGITUDE

HTTP_GEOBYTESTIMEZONE

HTTP_GEOBYTESLOCATIONCODE

 

Description of city headers
The purpose of these fields is documented below.

  • CityId; this field is an internal key used to relate a specific rows in this table to related rows in the “Subnets” and “NearbyCities” table. This is the primary key and is unique. The number “1225” for example is the key for Melbourne, Australia.
  • City; this field is a character representation of the actual name of the city. For example “New York”, “London” or “Paris”. This field should not be used as the key for queries since the names of cities are not globally unique.
  • Longitude; this field is used to store the approximate longitude of the city specified by the rest of the row. 
  • Latitude; this field is used to store the approximate latitude of the city specified by the rest of the row.
  • TimeZone; this field is used to indicate which time zone the city is in. For example, the “TimeZone” field value for Sydney, Australia is “+10:00” being UTC (or GMT) plus 10 hours. The time is represented in UTC (Coordinated Universal Time). UTC was formerly known as GMT (Greenwich Mean Time). See ISO8601:2000(E) for further information on time zone representation. The ISO is available at http://www.pvv.org/~nsaa/8601v2000.pdf 
  • LocationCode; this field is a 4 character alpha code used to represent a city within a given country and region. The code consists of the first letter of each word, then followed by the next 2 characters in the last word. If the city has only one word, then the first 4 characters would be used. When generating these codes if there was a duplicate code generated, then the next letter in the city name would be used. If a duplicate code is still found, then the last character of the code is replaced by a letter from the alphabet in descending order.

Dma Tags & Headers

The available country tags and headers are as follows:

Dma headers

HTTP_GEOBYTESDMA

Description of DMA headers
The purpose of these fields is documented below.

  • Dma; this is the Dma code as assigned by Nielsen Media -http://www.nielsenmedia.com Designated Market Areas (DMA’s) are used by Nielsen Media Research to identify TV stations whose broadcast signals reach a specific area and attract the most viewers. A DMA consists of all counties whose largest viewing share is given to stations of that same market area. Non-overlapping DMA’s cover the entire continental United States, Hawaii and parts of Alaska. There are currently 210 Designated Market Areas throughout the U.S.

Subnet Tags & Headers

The available country tags and headers are as follows:

Subnet headers

HTTP_GEOBYTESCERTAINTY

HTTP_GEOBYTESISPROXYFORWARDERFOR

HTTP_GEOBYTESISPROXYNETWORK

HTTP_GEOBYTESIPADDRESS

Description of Subnet headers
The purpose of these fields is documented below.

  • Certainty; this field is used to list the certainty for the information contained in the Geobytes map in relation to the subnet being searched on and the city that it is related to. A lower certainty rating may indicate that the data gathered was inconclusive or that the particular subnet serves a greater geographical area.
  • IsProxyForwardedFor; this field is used to indicate that the connection is being made by a Proxy.
  • IsProxyNetwork; this field is used to indicate that the user is connecting via a ProxyNetwork. At this time the only ProxyNetworks listed are AOL or MSN TV.
  • IPAddress; this field is the IP address that GeoSelect will use to perform the resolution. It is useful to use this field to pass in a selected IP address for use with testing. 

 

Modified:08/29/06   
© 2000 - 2003   
geobytes, inc.  
ARBN 091 652 961
Geobytes - because everybody's somewhere!
Contact Geobytes via our support forums
Privacy Policy