> For the complete documentation index, see [llms.txt](https://ciusji.gitbook.io/luden/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ciusji.gitbook.io/luden/features/geo-data-resolution.md).

# Geo Data Resolution

Luden looks up geolocation data by IP address during enrichment step. Here's a full list of fields Luden could get from the IP address:

```
{
  "location": {
    "continent": "North America",
    "country": "US",
    "country_name": "United States",
    "region": "NY",
    "city": "New York",
    "latitude": 40.7809,
    "longitude": -73.9502,
    "zip": "10128",
    "autonomous_system_number": 16509,
    "autonomous_system_organization": "AMAZON-02",
    "organization": "Amazon.com",
    "domain": "amazonaws.com"
  }
}
```

## Configuration <a href="#configuration" id="configuration"></a>

**Luden** uses [MaxMind](https://www.maxmind.com/) databases for doing geo lookup. There are two families of MaxMind databases: `GeoIP2` and `GeoLite2`.

`GeoIP2` databases such as `GeoIP2-Country`, `GeoIP2-City`, `GeoIP2-ISP`, `GeoIP2-Domain` are paid product. You can buy a license on [maxmind.com](https://www.maxmind.com/en/geoip2-databases). After purchasing, you will receive a license key. You can use the license key Luden:

* Put obtained license key on Luden UI → Geo data resolver section if you're using Configurator UI.
* Or use [`MAX_MIND_PATH` env variable](https://jitsu.com/docs/other-features/geo-data-resolution#configuration).

**`GeoLite2`** databases such as `GeoLite2-Country`, `GeoLite2-City`, `GeoLite2-ASN` are free. For obtaining them you should just create a [free account](https://dev.maxmind.com/geoip/geolite2-free-geolocation-data) and generate a license key. Configuration steps are the same as with paid database: either put obtained license key on Jitsu UI → Geo data resolver, or use`MAX_MIND_PATH`

With the key, Luden will download all databases available for the key. If you want to limit the databases, you can specify them as a postfix to Maxmind license key as `[key]?edition_id=GeoIP2-City,GeoIP2-ISP`

Also, you can point MAX\_MIND\_PATH environment variable directly to a local file.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://ciusji.gitbook.io/luden/features/geo-data-resolution.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.