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)

GeoDirection

     GeoDirection is a free service that dynamically redirects internet surfers based on their geographic location. This JavaScript redirection tool is ideal for internet users that wish to redirect browsers based on their City, Region or Country, using Geobytes' IP Address map technology. Further, it can also be used via the provided Geobytes' JavaScript Variables to insert localized geographic content into a web page or JavaScript.  Note: There is no need to install any special software on your web server.

Sample Redirection Script:

<script language="Javascript"
src
="http://gd.geobytes.com/gd?pages=USCASFRA&ext=html&after=5">
</script>

Sample Content Localisation Script:

<script language="Javascript" src="http://gd.geobytes.com/gd?after=-1&variables=GeobytesCountry,GeobytesCity">
</script>
<script language
="Javascript">
document.write("<p>Welcome to visitors from "+sGeobytesCity+", "+sGeobytesCountry);
</script>

Please note, by using Geobytes' GeoDirection service you are agreeing to be subject to the Geobytes GeoDirection Service Agreement.

Parameters:

pages: Specifies the page that a person will be re-directed to based on their location. For example: USCASFRA would re-direct visitors from the city of San Francisco to a page called USCASFRA.html, USCA would re-direct visitors from the California region to a page called USCA.html, while US would re-direct visitors from the country of United States to a page called US.html. Note: The order of precedence is city, region, country, meaning a city match overrides region, and a region match overrides country. (Alternatively, you can also direct to any specific url - click here to see the sample below.)

ext: Specifies the file extension of the page you wish to re-direct to. The default is html.

after: Specifies how long to wait before re-directing the user. Default is 0 seconds (do not wait). -1 = Do not re-direct (allows you to perform your own re-direct to any page see example)

targetpage: Sets the target page that the user will be re-directed to. The default is to re-direct the user to a page of the same name as the matching location code in the "pages" parameter. see example

-r (radius): When following a city location code, cause the script to include all surrounding cities out to the given distance. see example

variables: Specifies the variable(s) to be initialized for use in later scripts on the page. For a complete reference of the available Geobytes' JavaScript variables see Geobytes' JavaScript variables
Quick example: variables=GeobytesCountry,GeobytesCity would initialize the sGeobytesCountry and the sGeobytesCity JavaScript variables for later use.

Examples:

Code example using the Geobytes' JavaScript variables to redirect visitors from a given Country, Region or City:

<script language="Javascript" src="http://gd.geobytes.com/gd?after=-1&variables=GeobytesLocationCode,GeobytesCode,GeobytesInternet"></script>
<script language
="Javascript">
if(typeof(sGeobytesLocationCode)=="undefined"
   ||
typeof(sGeobytesCode)=="undefined"
   ||typeof(sGeobytesInternet)=="undefined"
)
{
   // Something has gone wrong with the variables, so set them to some default value,
   // maybe set a error flag to check for later on.

   var
sGeobytesLocationCode="unknown";
   var
sGeobytesCode="unknown";
   var
sGeobytesInternet="unknown";
}
if(sGeobytesLocationCode=="USCASFRA")
{
 
  // Visitors from San Francisco would go here
   window.open("enter San Francisco URL here");
}else if(sGeobytesCode=="CA")
{
   // Visitors from California would go here
   window.open("enter California URL here");
}else if(sGeobytesInternet=="US")
{
  
// Visitors from The United States would go here
   window.open("enter United States URL here");
}

</script>

The re-direction script as shown in the examples below must be pasted into the <head></head> section of the page that you are re-directing your users from.

The following example would re-direct visitors from San Francisco to USCASFRA.html, and would re-direct users from California to USCA.html Any other visitors from United States would be re-directed to US.html. Visitors from other countries will not be re-directed.

<head>
<script language
="Javascript"
src="http://gd.geobytes.com/gd?pages=USCASFRA,USCA,US">
</script>
</head>

The following example re-directs to an .ASP page and waits for 5 seconds.

<head>
<script language
="Javascript"
src="http://gd.geobytes.com/gd?pages=USCASFRA,USCA,US&ext=ASP&after=5">
</script>
</head>

Can you re-direct users to any page name you like?

Yes, there are a number of ways to do this. First you can use the targetpage parameter to specify the target page for the redirect. Here is an example:

<head>
<script language
="Javascript"
src="http://gd.geobytes.com/gd?pages=USNYNYOR,UKENLOND&targetpage=BigCities&ext=ASP&after=5">
</script>
</head>

Notice, that you still need to set the file extension, if any. In the above example, all visitors from either New York or London would be redirected to BigCities.ASP.

Another approach is to use the "sGeobytesLocationCode" Javascript variable to detect where the user is from, and then issue your own re-direct to any other page you like. Re-directing your users this way enables you to have more control over which users are re-directed to which pages. For example:

<head>
<script language
="Javascript" src="http://gd.geobytes.com/Gd?pages=US&ext=html&after=-1"></script>
<script language="javascript">
if(typeof(sGeobytesLocationCode)!="undefined"&&sGeobytesLocationCode.indexOf('US')==0)
{
    document.write("<META HTTP-EQUIV='Refresh' CONTENT='0; URL=enter your url here'>");
}
</script>
</head>

The script above would re-direct users from The United States to any page that you specify, you can also specify a fully qualified url. Just replace "enter your url here" with the url of the page you are re-directing your users to.

Can you re-direct all users within a given radius?

Yes, there are at least two ways to do this, depending on whether you want to send the visitors from each of the cities within the specified radius to their own custom page or to a common page for all of the cities within the defined area.

This script uses the -r parameter to direct all visitors from within a 80 kilometre radius of to a target page called MyPage.html after 5 seconds.

<head>
<script language
="Javascript"
src="http://gd.geobytes.com/gd?pages=USCASFRA -r 80&targetpage=MyPage&ext=html&after=5">
</script>
</head>

The above approach will probably meet most application's requirements, however there is another way to use this 'radius' facility, and that is "without specifying a target page" as we did in the above example. If you omit the target page parameter from the above example, then GeoDirection will redirect each city's traffic to its own page - you would need a landing page for each city with in the radius - as the script will automatically redirect to the users 'city page'. (A city page being something like - USCASFRA.html) This option - without the targetpage parameter is more tedious as you would need to look up all of the location codes for all of the surrounding cities - and worse still create pages for each city. However, while this approach might seem like a complete waste of time, it is very handy when the server is dynamically creating the pages on the fly - the URI part of the URL tells the server which page to create.

Another option  is to just include a coma separated list of all of the location codes within the area of interest and then redirect to a nominated page manually - as shown in the "AlternatePageName" example above.:  The advantage of this method, while more complex, is that you get more control.

You can determine near by location codes via either our Location code generator or via a call like this:

http://glrs.geobytes.com/map.htm?GetNearByCities&Radius=50&LocationCode=&template=<geobytes%20locationcode>%20<geobytes%20city>,%20&units=miles

BTW There are more examples of the radius parameter here in our support forums.

See the FAQ below for further examples.

How to find out location codes for Cities, Regions, Countries?

The last point you need to know to get geo re-directs running is the location codes for the cities, regions and countries that you wish to target.  

The easiest way is to use our location code generator, but as you have probably realised now, you can pretty much guess the code of many of the countries and regions. For example: The region code is the first 4 characters of the location code, and the country code is the first 2 characters.

For further assistance with obtaining codes, please see our EpiCenter or our forums site.

Using the sGeobytesLocationCode Javascript Variable

After the GeoDirection service processes your request it initialises a JavaScript string variable that is accessible by any JavaScript on the page. The variables name is "sGeobytesLocationCode" and it's value is set to the location code of the user. For example: The location code for San Francisco is USCASFRA. If the user's location can't be determined it's value is "unknown". You may wish to use this variable to tell the user something like: "We are now re-directing you to our San Francisco page... Please Wait..." Following is some sample code:

<script language="javascript">
if(typeof(sGeobytesLocationCode)!="undefined"&&sGeobytesLocationCode=="USCASFRA")
{
    document.write("We are now re-directing you to our San Francisco page...");
}

</script>

GeoDirection FAQ

How do I open the re-directed page in a new window?

Simply use JavaScript's window.open method. For example, the code below would open a new page redirecting users from California .

<script language="Javascript" src="http://gd.geobytes.com/Gd?after=-1"></script>
<script language="javascript">
if(typeof(sGeobytesLocationCode)!="undefined"&&sGeobytesLocationCode.indexOf('USCA')==0)
{
    window.open("enter url here");
}

</script>

How many Geobytes' JavaScript variables are there and what are their names?

There are 30 Geobytes' JavaScript variables in total to use, their names with a short summary describing each variable are in the table below:

#

Geobytes' Country Variables

Sample Data

Description

1

sGeobytesCountryId

254

The primary key of the countries table.

2

sGeobytesCountry

United States

The country name of a given country

3

sGeobytesFips104

US FIPS 10-4
4

sGeobytesIso2

US

The “A 2” column in the ISO 3166 document

5

sGeobytesIso3

USA

The “A 3” column in the ISO 3166 document

6

sGeobytesIson

840

The “Number” column in the ISO 3166 document

7

sGeobytesInternet

US

The “ccTLD” code designated by IANA*

8

sGeobytesCapital

Washington, DC

The capital city of a given country

9

sGeobytesMapReference

North America

The major reference point in the world of the given country

10

sGeobytesNationalitySingular

American

The singular expression of a given countries nationality

11

sGeobytesNationalityPlural

Americans

The plural expression of a given countries nationality

12

sGeobytesCurrency

US Dollar

The currency of the given country

13

sGeobytesCurrencyCode

USD

The currency code of a given country

14

sGeobytesPopulation

278058881

The population of a given country

15

sGeobytesCountryTitle

The United States

The given country's title as it would appear in a sentence.

 

 

 

 

 

Geobytes' Region Variables

Sample Data

Description

16

sGeobytesRegionId

126

A variable holding the primary key of the regions table of a given region.

17

sGeobytesRegion

California

A variable holding the region name of a given region

18

sGeobytesCode

CA

A 2 character code used to represent the general abbreviation for a sub-country geographical region

19

sGeobytesAdm1Code

Used to identify a geopolitical region at a sub-country region level

 

Geobytes' City/Location Variables

Sample Data

Description

20

sGeobytesCityId

7419

A variable holding the primary key of the cities table of a given city.

21

sGeobytesCity

San Francisco

A variable holding the city name of a given city

22

sGeobytesLatitude

37.7002

A variable holding the latitude of a given city

23

sGeobytesLongitude

-122.4060

A variable holding the Longitude of a given city

24

sGeobytesTimezone

-08:00

A variable holding the Timezone of a given city

25

sGeobytesLocationCode

USCASFRA

A variable holding the GeobytesLocationCode of a given city

 

 

 

 

 

Geobytes' DMA Variables

Sample Data

Description

26

sGeobytesDma

807

Non-overlapping Designated Market Area (US Only), used to identify TV stations whose broadcast signals reach a specific area.

 

 

 

 

 

Geobytes' Subnet Variables

Sample Data

Description

27

sGeobytesCertainty

85

A variable used to indicate certainty

28

sGeobytesIsProxyForwarderFor

true

A variable used to indicate that the connection is being made by a Proxy

29

sGeobytesIsProxyNetwork

false

A variable used to indicate that the user is connecting via a ProxyNetwork (AOL or MSN TV)

30

sGeobytesIpAddress

54.225.1.70

A variable that stores an IP Address

*IANA - Internet Assigned Numbers Authority

For a comprehensive description of each of the above fields see the Understanding the Geo Tags & Geobytes Headers page.

How could I redirect users from multiple countries to multiple pages respectively?

The code below would redirect users from the countries within each variable (ie. var sCountryLocations="US") to be redirected to any page of a webmasters choice.

<head>
<script language="Javascript" src="http://gd.geobytes.com/Gd?after=-1"></script>
<script language="javascript">
var sSpanishLocations="ES,MX,GT,SV,HN,NI,CR,EC,PE,CU,DO,PR,PA,VE,CO,BO,AR,CL,PY,UY";
var sGermanLocations="DE,AT,CH";
var sFrenchLocations="FR,BE";
var sPhilippineLocations="PH";
var sKoreanLocations="KP,KR";
var sChineseLocations="CN";
if(typeof(sGeobytesLocationCode)!="undefined")
{
   var sCountryCode=sGeobytesLocationCode.substring(0,2);
   if(sCountryCode!="US"&&sCountryCode!="CA")
   {
      if(sSpanishLocations.indexOf(sCountryCode)>=0)
      {
         // Spanish Visitors would go here
         document.write("<META HTTP-EQUIV='Refresh' CONTENT='0; URL=Spanish.htm'>");
      }else if(sGermanLocations.indexOf(sCountryCode)>=0)
      {
         // German Visitors would go here
         document.write("<META HTTP-EQUIV='Refresh' CONTENT='0; URL=German.htm'>");
      }else if(sFrenchLocations.indexOf(sCountryCode)>=0)
      {
         // French Visitors would go here
         document.write("<META HTTP-EQUIV='Refresh' CONTENT='0; URL=French.htm'>");
      }else if(sPhilippineLocations.indexOf(sCountryCode)>=0)
      {
         // Philippine Visitors would go here
         document.write("<META HTTP-EQUIV='Refresh' CONTENT='0; URL=Philippine.htm'>");
      }else if(sKoreanLocations.indexOf(sCountryCode)>=0)
      {
         // Korean Visitors would go here
         document.write("<META HTTP-EQUIV='Refresh' CONTENT='0; URL=Korean.htm'>");
      }else if(sChineseLocations.indexOf(sCountryCode)>=0)
      {
         // Chinese Visitors would go here
         document.write("<META HTTP-EQUIV='Refresh' CONTENT='0; URL=Chinese.htm'>");
      }else
      {
         // World Visitors would go here
         document.write("<META HTTP-EQUIV='Refresh' CONTENT='0; URL=World.htm'>");
      }
   }
}
</script>
</head>

How would I redirect users to two different pages?

The code below redirects users from the countries within Europe to one page and visitors from the United States to another page.  The rest of the world stays on the current page that this code is pasted onto.

<head>
<script language
="Javascript" src="http://gd.geobytes.com/Gd?after=-1"></script>
<script language="javascript">
var sLocations="US,AL,AD,AT,BE,BG,HR,CZ,DK,EE,FO,FI,FR,DE,GI,GR,"+
"GG,VA,HU,IE,IT,JE,LV,LI,LT,LU,MK,MT,IM,MC,NL,NO,PL,PT,RO,SM,SK,SI,ES,SE,CH,UK,YU";
if(typeof(sGeobytesLocationCode)!="undefined")
{
    var sCountryCode=sGeobytesLocationCode.substring(0,2);
    if(sLocations.indexOf(sCountryCode)==0)
    {
          // Visitors from the US would go here
          document.write("<META HTTP-EQUIV='Refresh' CONTENT='0; URL=enter url here'>");
    }else if(sLocations.indexOf(sCountryCode)>0)
    {
          // Visitors from Europe would go here
          document.write("<META HTTP-EQUIV='Refresh' CONTENT='0; URL=enter url here'>");
    }
}
</script>
</head>

How would I redirect visitors from the United States to "http://www.SomeDomain.com" and the rest of the world to "http://www.restoftheworld.com"?

The code below shows how to, by default let all the traffic go to "http://www.restoftheworld.com" then re-direct people from the United States to "http://www.SomeDomain.com". 

<head>
<script language
="Javascript" src="http://gd.geobytes.com/Gd?after=-1"></script>
<script language="javascript">
if(typeof(sGeobytesLocationCode)!="undefined"&&sGeobytesLocationCode.indexOf('US')==0)
{
    document.write("<META HTTP-EQUIV='Refresh' CONTENT='0; URL=http://www.SomeDomain.com'>");
}

</script>
</head>

How can this service be FREE?

We are happy to provide this service for free to the web community, all we ask in exchange is a small amount of advertising.

For approximately every 1 in a 50 redirects the current browser window will be directed to the Geobytes site or that of a sponsor, the redirect will also open a new window for the original, intended content. This will not happen to the same person twice in the same day.

If you wish to remove this ad, then that can be easily done by purchasing some Mapbytes resolutions. These Mapbytes will allow you to enter the url of the site on which you use GeoDirection. Any requests from this url will be allowed access and will not have any ads served. Mapbytes start from $9.95 for 10,000 resolutions. See the Buy page to purchase Mapbytes or see the FAQ page for more details.

 

 
 
Remove the Ad from the GeoDirection Service.
Using GeoBytes' latest offering "Mapbytes" you can now remove the ad that pops up in every 1 in 50 redirects.

Pricing starts from just $9.95 for 10,000 requests.

See the FAQ page for more details.

Buy some Mapbytes Now!
Features
No software to install
Just paste a few lines of code on your page.
No registration required to use the free service.
Quickly and Easily re-direct users to specific pages for their country, or even their city.
Learn More
See the GeoDirection FAQ for more examples.
In a Hurry - see an Overview of all that Geobytes offers.
Find out more on Geobytes Products and Services.
GeoReport - Geographical web site traffic analysis - drill down graphs.
GeoSelect - Geographically customize your web site with GeoSelect
GeoNetMap - GeoSelect's IP address to geographical location database
See our Pricing for our paid services.
Buy Now!
Pricing & Licensing Info
Learn More about Geobytes!
FAQ
View the GeoSelect Demo
Visit the Support page
Go to the Geobytes Home  page

 

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