XML Geolocation Web Service

The XML Geolocation web service API ¹⁾ allows you to directly program your back-end scripts to deliver dynamic geo-localized pages using the XML elements provided by geoPlugin.

To access this service, add the following url to a remote include call


http://www.geoplugin.net/xml.gp?ip=xx.xx.xx.xx

Of course, substitute the xx's with your visitor's IP number.

Example output of an XML query for your IP address (18.97.9.170) is:

<?xml version="1.0" encoding="UTF-8"?>
<geoPlugin>
	<geoplugin_request>18.97.9.170</geoplugin_request>
	<geoplugin_status>200</geoplugin_status>
	<geoplugin_delay>1ms</geoplugin_delay>
	<geoplugin_credit>Some of the returned data includes GeoLite2 data created by MaxMind, available from <a href='https://www.maxmind.com'>https://www.maxmind.com</a>.</geoplugin_credit>
	<geoplugin_city>Ashburn</geoplugin_city>
	<geoplugin_region>Virginia</geoplugin_region>
	<geoplugin_regionCode>VA</geoplugin_regionCode>
	<geoplugin_regionName>Virginia</geoplugin_regionName>
	<geoplugin_areaCode></geoplugin_areaCode>
	<geoplugin_dmaCode>511</geoplugin_dmaCode>
	<geoplugin_countryCode>US</geoplugin_countryCode>
	<geoplugin_countryName>United States</geoplugin_countryName>
	<geoplugin_inEU>0</geoplugin_inEU>
	<geoplugin_euVATrate></geoplugin_euVATrate>
	<geoplugin_continentCode>NA</geoplugin_continentCode>
	<geoplugin_continentName>North America</geoplugin_continentName>
	<geoplugin_latitude>39.0469</geoplugin_latitude>
	<geoplugin_longitude>-77.4903</geoplugin_longitude>
	<geoplugin_locationAccuracyRadius>20</geoplugin_locationAccuracyRadius>
	<geoplugin_timezone>America/New_York</geoplugin_timezone>
	<geoplugin_currencyCode>USD</geoplugin_currencyCode>
	<geoplugin_currencySymbol>&#36;</geoplugin_currencySymbol>
	<geoplugin_currencySymbol_UTF8>$</geoplugin_currencySymbol_UTF8>
	<geoplugin_currencyConverter>0</geoplugin_currencyConverter>
</geoPlugin>

XML Geolocation Currency Converter

The “geoplugin_currencyConverter” element is the conversion rate for the currency converter base currency.
Like all calls to any of geoPlugin's web services, the default base_currency is USD ($US).
Thus, if your base currency is NOT $US, then you must add the variable base_currency=XXX to the call to geoplugin.net eg

http://www.geoplugin.net/xml.gp?base_currency=EUR

Now the geoplugin_currencyConverter element will output the exchange rate of one Euro for your visitor.

The base_currency value must be a valid ISO 4217 3-letter code.

XML Geolocation Web Service

XML Geolocation Currency Converter

See also