geoPlugin Home


geoPlugin Web Services


We offer a number of different free web services to allow you to efficiently localize your visitors1) and pull up vital information on them.

The services we offer allow a great deal of flexibility in how you use them, either in your back-end scripts or front-end HTML pages.

The services are based either on:


However, they all return the same data, just presented in a different way to make your life easier! If you require the data presented in a way that we don't currently offer, please drop us a line and we'll do our best to incorporate it.

The geo-localized data that is returned by these services gives you all you need to know about your visitor. You can be as creative as you want with this information! You are probably a lot more creative than us, but have a look at our example page to get some basic ideas.

The data on your visitor returned to you by all of the web services shows their:



Geolocation accuracy

Table Terms:

Correctly Resolved Within 25 Miles of True Location: refers to the IP addresses that are correctly resolved within 25 miles of the actual city. The second number in parenthesis refers to the percentage of IP addresses that are correctly resolved if excluding data not covered on a city level.

Incorrectly Resolved More Than 25 Miles From True Location: refers to IP addresses that were incorrectly resolved by more than 25 miles of the actual city.

Not Covered on a City Level: refers to the percentage of the data of select country that does not contain city information. We leave these data ranges without city information to prevent false positives. The city information is not available for AOL IP address or when Internet Service Providers (ISPs) route traffic through proxies thus masking the originating location.

Updated November 19th, 2008

Data obtained from MaxMind

Countries Correctly Resolved Within 25 Miles of True Location Incorrectly Resolved More Than 25 Miles from True Location Not Covered on a City Level
Argentina 67% (67%) 32% 1%
Australia 62% (63%) 37% 1%
Austria 79% (80%) 20% 1%
Bahamas 92% (92%) 7% 1%
Bangladesh 84% (85%) 15% 1%
Belgium 90% (90%) 9% 1%
Bolivia 60% (61%) 39% 1%
Brazil 65% (71%) 27% 8%
Bulgaria 76% (77%) 23% 1%
Canada 83% (83%) 16% 1%
Chile 73% (73%) 26% 1%
China 71% (73%) 26% 3%
Colombia 67% (68%) 32% 1%
Costa Rica 88% (88%) 11% 1%
Cote D'Ivoire 93% (94%) 6% 1%
Croatia 79% (80%) 20% 1%
Cyprus 84% (85%) 15% 1%
Czech Republic 77% (77%) 22% 1%
Denmark 83% (84%) 16% 1%
Ecuador 78% (78%) 21% 1%
Egypt 80% (82%) 18% 2%
El Salvador 92% (92%) 7% 1%
Estonia 83% (84%) 16% 1%
Finland 81% (82%) 18% 1%
France 66% (67%) 32% 2%
French Polynesia 83% (83%) 16% 1%
Georgia 93% (94%) 6% 1%
Germany 76% (77%) 22% 2%
Greece 65% (66%) 33% 2%
Guadeloupe 92% (93%) 7% 1%
Honduras 75% (77%) 23% 2%
Hong Kong 92% (93%) 7% 1%
Hungary 83% (83%) 16% 1%
Iceland 82% (83%) 17% 1%
India 70% (70%) 29% 1%
Indonesia 70% (70%) 29% 1%
Ireland 70% (70%) 29% 1%
Israel 68% (70%) 30% 2%
Italy 62% (64%) 36% 2%
Japan 72% (77%) 21% 7%
Jordan 78% (89%) 10% 12%
Kazakhstan 85% (86%) 14% 1%
Kenya 74% (77%) 22% 4%
Korea, Republic of 78% (80%) 19% 3%
Latvia 84% (84%) 15% 1%
Lebanon 83% (88%) 12% 5%
Lithuania 80% (80%) 19% 1%
Luxembourg 94% (94%) 5% 1%
Malaysia 66% (66%) 33% 1%
Malta 93% (97%) 3% 4%
Mexico 72% (74%) 26% 2%
Morocco 42% (54%) 36% 22%
Mozambique 70% (74%) 24% 6%
Netherlands 85% (85%) 14% 1%
New Caledonia 77% (79%) 20% 3%
New Zealand 68% (68%) 31% 1%
Nicaragua 77% (77%) 22% 1%
Nigeria 40% (56%) 32% 28%
Norway 79% (79%) 20% 1%
Pakistan 62% (62%) 37% 1%
Peru 86% (86%) 13% 1%
Philippines 64% (65%) 35% 1%
Poland 66% (67%) 33% 1%
Portugal 73% (73%) 26% 1%
Qatar 95% (95%) 4% 1%
Romania 74% (74%) 25% 1%
Russian Federation 82% (83%) 17% 1%
Saudi Arabia 47% (51%) 45% 8%
Singapore 93% (94%) 6% 1%
Slovakia 56% (57%) 43% 1%
Slovenia 83% (84%) 16% 1%
South Africa 67% (68%) 32% 1%
Spain 77% (78%) 21% 2%
Sri Lanka 71% (71%) 28% 1%
Sweden 80% (81%) 19% 1%
Switzerland 67% (68%) 32% 1%
Taiwan 83% (83%) 16% 1%
Thailand 77% (78%) 22% 1%
Trinidad and Tobago 92% (93%) 6% 2%
Tunisia 44% (55%) 36% 20%
Turkey 73% (73%) 26% 1%
Ukraine 70% (71%) 28% 2%
United Arab Emirates 82% (84%) 15% 3%
United Kingdom 59% (64%) 34% 7%
United States 83% (84%) 15% 2%
Uruguay 68% (68%) 31% 1%
Venezuela 63% (63%) 36% 1%


Nearby Places

In addition to the geolocation web service, there is also a geocoding webservice that will find nearby places based on latitude/longitude coordinates.
So, once you've geolocalized your webvisitor, that gives you their latitude/longitude coordinates, you can find places nearby (within a 10km radius).
This webservice can give data ready for use in PHP scripts (default), JSON, or XML languages.

Query this service using the following URL:

http://www.geoplugin.net/extras/nearby.gp?lat=XXX&long=YYY&output=ZZZ

Where

  • XXX = latitude coordinate
  • YYY = longitude coordinate
  • ZZZ = how the data should be output. Accepted values are:
    1. php (default)
    2. json
    3. xml


Nearby places to you include:


1:
Place: Croix
Region: Nord-Pas-de-Calais
County:
Latitude: 50.6784600
Longitude: 3.1493000
Distance (miles): 0.88
Distance (km): 1.41
Direction (degrees) 60.28
Direction (heading) ENE
2:
Place: Le Blanc Seau
Region: Nord-Pas-de-Calais
County:
Latitude: 50.6833300
Longitude: 3.1500000
Distance (miles): 1.14
Distance (km): 1.84
Direction (degrees) 48.76
Direction (heading) NE
3:
Place: Mouvaux
Region: Nord-Pas-de-Calais
County:
Latitude: 50.6994400
Longitude: 3.1342900
Distance (miles): 2.01
Distance (km): 3.23
Direction (degrees) 0.88
Direction (heading)
4:
Place: Marcq-en-Barœul
Region: Nord-Pas-de-Calais
County:
Latitude: 50.6666700
Longitude: 3.0833300
Distance (miles): 2.23
Distance (km): 3.58
Direction (degrees) 94.02
Direction (heading) E






See also

1) This product includes GeoLite data created by MaxMind, available from http://maxmind.com/
 
 
Bookmark with:    Digg    StumbleUpon    Del.icio.us    Technorati


Acceptable Use Policy    Contact geoPlugin