Getting Help with GeoLite2

GeoLite2 City, Country, and ASN databases are in most ways similar to the GeoIP2 City, Country, and ISP databases respectively, with a few key differences.

  • The location information in the GeoLite2 databases is less accurate.
  • The GeoLite2 ASN database has fewer data points than the GeoIP2 ISP database.
  • We do not provide official support for GeoLite2.

Similarly, the GeoLite2 web services are similar to GeoIP2 Precision City and Country web services respectively, with a few key differences.

  • As with the GeoLite2 databases, the GeoLite2 web services return less accurate data than GeoIP2.
  • The GeoLite2 City web service returns fewer data points than the GeoIP2 Precision City web service. See this side by side comparison for details.
  • Each user may query the GeoLite2 web services a maximum of 1,000 times per day.
  • We do not provide official support for GeoLite2 web services.

Although MaxMind does not offer official support for GeoLite2, the databases are in most cases a drag-and-drop replacement for GeoIP2 databases and the web services are integrated using the same APIs as GeoIP2 Precision web services. This means that some of the documentation written for GeoIP2, as described below, is directly applicable to GeoLite2 products. We also offer some GeoLite2 documentation on our developer site and an FAQ section on GeoLite2.

In addition to these resources provided by MaxMind, you can also consult stackoverflow’s GeoIP questions and answers.


Integration and Setup

Some of the documentation for GeoIP2 databases and GeoIP2 Precision web services may be useful as you integrate and setup GeoLite2 databases and web services.

GeoLite2 Downloadable Databases

GeoLite2 databases are available in a binary format or CSV format. You can compare the outputs available in the various GeoLite2 databases.

Binary (MaxMind DB file format):

  1. MaxMind requires GeoLite2 users sign up for an account in order to comply with privacy laws. Make sure you have signed up for a free GeoLite2 account.
  2. Make sure you have an active license key [login required].
  3. Download and keep your databases updated with our GeoIP Update program or a direct download script. GeoLite2 users may use the same methods as described for GeoIP2 users.
  4. Subscribe to “New Database Update Releases” on https://status.maxmind.com/ to receive notifications in the event we have an unexpected delay for a database update.
  5. Ensure you are using the appropriate API according to your environment.
  6. Executing your first MMDB query. Below are code examples for querying the binary databases (with MaxMind supported APIs):

Comma-separated values (CSV):

  1. MaxMind requires GeoLite2 users sign up for an account in order to comply with privacy laws. Make sure you have signed up for a free GeoLite2 account.
  2. Make sure you have an active license key [login required].
  3. Download and keep your databases updated with a direct download script.
  4. Subscribe to “New Database Update Releases” on https://status.maxmind.com/ to receive notifications in the event we have an unexpected delay for a database update.
  5. Ensure you are familiar with the details of the CSV files based on the specific databases you are using:

GeoLite2 Web Service

  1. MaxMind requires GeoLite2 users to sign up for a free account in order to comply with privacy laws. Make sure you have signed up for a free GeoLite2 account. You can sign up for a GeoLite2 account from our Developer’s site.
  2. Make sure you have an active license key [login required].
  3. Ensure you are using the appropriate API according to your environment, and connecting to the correct URI for the service you are using. On the GeoIP2 Precision developer’s documentation, we list the URIs for GeoLite2. In addition, the data points listed in GeoIP2 Precision Country and City are nearly identical to those present in GeoLite2 Country and City. The data points which are absent from the GeoLite2 web services have been marked accordingly. You can also download a comparison of the data points present in the GeoLite2 Web Services versus those present in GeoIP2 Precision City and Insights. We have a brief tutorial on integrating GeoLite2 in PHP on our blog.
  4. To prevent search engine spiders from depleting your GeoLite2 service lookups, we recommend the use of the robots exclusion standard.

Accuracy

IP geolocation is inherently imprecise. Locations are often near the center of a population. Any location provided by GeoLite2 data should not be used to identify a particular address or household.

Read our FAQ’s relating to coverage and accuracy:


Data Corrections

Please carefully read our corrections FAQ page to learn more about our corrections process. Note that we do not accept all corrections. When a data correction is accepted, we will send an automated email to confirm.

You may submit corrections requests by submitting this form.


Data Privacy

To comply with data privacy regulations, please monitor our Do Not Sell My Personal Information Requests page [login required] for IP addresses and networks that should not be used for advertising or marketing purposes. You may also access this list in an automated way with our Privacy Exclusions API.

You must keep your databases up to date and destroy old versions of the databases within 30 days of the release of an updated version. More information about the terms and conditions of your use of GeoLite2 can be found in the GeoLite2 End User License Agreement.