Document examples of the X-Geo-IP header.

[cosimo]

Document examples of the X-Geo-IP header.

[cosimo]

Hi,

the X-Geo-IP header will differ depending on which function you decide to apply, and what GeoIP database you are using.

In case of simple country lookup, you will have:

X-Geo-IP: country:US

whereas a failed lookup will return country:A6. That is an internal convention we adopted, of course YMMV.

In case of City database, the header will look like:

X-Geo-IP: city:Rome, country:IT, lat:44.2134, lon:12.241, ip:1.2.3.4

(numbers are made up), while in the lookup failed case, you will have:

X-Geo-IP: city:, country:A6, lat:0.0, lon:0.0, ip:1.2.3.4

The invalid/internal IP case is covered by the geoip library itself, so it's reported as failure.
Hope that helps. Should maybe put this in the docs, since I took the time to write it :-)

[cosimo]

Merged.