Geo Tags & Headers

  • 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 athttp://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 athttp://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 Subnet 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.

    – because everybody's somewhere