GeoIP2 Release Notes

Subscribe to the GeoIP2 release notes RSS feed.

GeoNames Monthly Diff Report July 2022

July 11, 2022

GeoNames Monthly Diff Report (July 2022)

GeoIP2 and GeoLite2 databases incorporate GeoNames geographical data, which is made available under the Creative Commons Attribution 4.0 License.

Monthly updates to GeoNames data are incorporated into our databases as we refresh them. Above you will find a CSV report of these changes for the month of July as they relate to the following fields:

geoname_id
country_name
country_code
city_name
subdivision_1_iso_code
subdivision_2_iso_code

Note that the values for the 'old' and ‘new’ columns for a given field only differ for the field defined in the ‘diff_in’ column.

GeoNames Monthly Diff Report June 2022

June 15, 2022

GeoNames Monthly Diff Report (June 2022)

GeoIP2 and GeoLite2 databases incorporate GeoNames geographical data, which is made available under the Creative Commons Attribution 4.0 License.

Monthly updates to GeoNames data are incorporated into our databases as we refresh them. Above you will find a CSV report of these changes for the month of June as they relate to the following fields:

geoname_id
country_name
country_code
city_name
subdivision_1_iso_code
subdivision_2_iso_code

Note that the values for the 'old' and ‘new’ columns for a given field only differ for the field defined in the ‘diff_in’ column.

GeoIP Legacy databases have been retired

June 1, 2022

In line with the announcement on our blog from 2020, GeoIP Legacy databases have been retired.

Data changes to GeoIP Legacy web services

May 31, 2022

In line with the announcement on our blog from 2020, there will be several changes to the data in our GeoIP Legacy web services beginning today. The following web services are affected:

GeoIP Legacy City
GeoIP Legacy City/ISP/Org
GeoIP Legacy Insights (formerly known as Omni)

The following data changes have been made:

Region codes: The legacy web services historically returned region codes in the FIPS 10-4 standard (for all countries except for the US and Canada). Now, region codes worldwide will be returned in the ISO 3166-2 standard.
Area codes: Area code fields will now return blank.
Country/Region/City names: Country, region, and city names will now come from GeoNames.

For more information, read the full announcement on our blog from 2020.

Please note that associated changes to the minFraud Legacy web services are also being made.

GeoLite databases will now receive twice weekly updates

May 25, 2022

Starting this Friday, May 27, GeoLite databases will be updated twice weekly, on Tuesdays and Fridays. The following databses are affected:

GeoLite2 Country Database
GeoLite2 City Database
GeoLite2 ASN Database

The twice weekly database updates will allow us to more quickly incorporate data corrections.

Please update your integration to download updates according to this new schedule.

For more information about database updates see the documentation our Developer Portal and Knowledge Base.

GeoNames Monthly Diff Report May 2022

May 10, 2022

GeoNames Monthly Diff Report (May 2022)

GeoIP2 and GeoLite2 databases incorporate GeoNames geographical data, which is made available under the Creative Commons Attribution 4.0 License.

Monthly updates to GeoNames data are incorporated into our databases as we refresh them. Above you will find a CSV report of these changes for the month of May as they relate to the following fields:

geoname_id
country_name
country_code
city_name
subdivision_1_iso_code
subdivision_2_iso_code

Note that the values for the 'old' and ‘new’ columns for a given field only differ for the field defined in the ‘diff_in’ column.

GeoNames Monthly Diff Report April 2022

April 11, 2022

GeoNames Monthly Diff Report (April 2022)

GeoIP2 and GeoLite2 databases incorporate GeoNames geographical data, which is made available under the Creative Commons Attribution 4.0 License.

Monthly updates to GeoNames data are incorporated into our databases as we refresh them. Above you will find a CSV report of these changes for the month of April as they relate to the following fields:

geoname_id
country_name
country_code
city_name
subdivision_1_iso_code
subdivision_2_iso_code

Note that the values for the 'old' and ‘new’ columns for a given field only differ for the field defined in the ‘diff_in’ column.

GeoNames Monthly Diff Report March 2022

March 11, 2022

GeoNames Monthly Diff Report (March 2022)

GeoIP2 and GeoLite2 databases incorporate GeoNames geographical data, which is made available under the Creative Commons Attribution 4.0 License.

Monthly updates to GeoNames data are incorporated into our databases as we refresh them. Above you will find a CSV report of these changes for the month of March as they relate to the following fields:

geoname_id
country_name
country_code
city_name
subdivision_1_iso_code
subdivision_2_iso_code

Note that the values for the 'old' and ‘new’ columns for a given field only differ for the field defined in the ‘diff_in’ column.

Update Regarding IP Geolocations in Ukraine

February 25, 2022

IP addresses that are geolocated to the regions of Donetsk and Luhansk currently return Ukraine for the country in MaxMind's products and services.

MaxMind's IP geolocation products and services use GeoNames to determine the name of the country in which an IP address is located. At this time, we do not have plans to diverge from GeoNames for IP addresses located in disputed regions.

February Holiday Database Release Schedule

February 18, 2022

Due to the holidays on Monday, February 21, database updates scheduled for Tuesday, February 22 will be delayed by about one day.

The following database updates will be delayed:

GeoIP2 Country
GeoIP2 City
GeoIP2 Connection Type
GeoIP2 ISP
GeoIP2 Enterprise
GeoLite2 Country
GeoLite2 City
GeoLite2 ASN

The GeoIP Legacy database updates will also be delayed.

The GeoIP2 Anonymous IP database will continue to update as scheduled.

We will resume our regular update schedule beginning on Friday, February 25.

GeoNames Monthly Diff Report February 2022

February 10, 2022

GeoNames Monthly Diff Report (February 2022)

GeoIP2 and GeoLite2 databases incorporate GeoNames geographical data, which is made available under the Creative Commons Attribution 4.0 License.

Monthly updates to GeoNames data are incorporated into our databases as we refresh them. Above you will find a CSV report of these changes for the month of February as they relate to the following fields:

geoname_id
country_name
country_code
city_name
subdivision_1_iso_code
subdivision_2_iso_code

Note that the values for the 'old' and ‘new’ columns for a given field only differ for the field defined in the ‘diff_in’ column.

* This month's update has a large number of changes to the GeoNames ID for locations in China due to some changes in how we process GeoNames data for China.

Dialup values for connection_type and user_type deprecated

February 9, 2022

We have deprecated the dialup values for connection_type and user_type in our GeoIP2 products and services:

GeoIP2 Connection Type database
- connection_type no longer has the possible value of Dialup
GeoIP2 Enterprise database
- connection_type no longer has the possible value of Dialup
- user_type no longer has the possible value of dialup
GeoIP2 Insights web service
- user_type no longer has the possible value of dialup

You can see a list of possible values for the connection_type data point in our documentation for the GeoIP2 Connection Type database.

You can see a list of possible values for the user_type data point in the API schema for our GeoIP2 web services.

Mobile country and mobile network code data

January 25, 2022

We have added data containing the mobile country code and mobile network code to several of our GeoIP2 product and services. Mobile country code and mobile network code data uniquely identify mobile network operators (carriers). This data can be used for carrier segmentation and targeting as well as general analytics. Learn more about mobile country code data on Wikipedia.

This data will be included in the following GeoIP2 products and services:

GeoIP2 ISP database
GeoIP2 Enterprise database
GeoIP2 City Plus web service
GeoIP2 Insights web service
minFraud Insights web service
minFraud Factors web service

Database users

The mobile_country_code and mobile_network_code data will be included in all new releases of the GeoIP2 ISP and Enterprise databases starting with today's release.

CSV file users

The new data columns will be added to the following files:

GeoIP2 ISP database
- GeoIP2-ISP-Blocks-IPv4.csv
- GeoIP2-ISP-Blocks-IPv6.csv
GeoIP2 Enterprise database
- GeoIP2-Enterprise-ISP.csv

See our developer documentation for the GeoIP2 ISP and Enterprise databases for more information about the files. You can also download a sample CSV database containing the new data columns for GeoIP2 ISP and Enterprise from our developer's site.

MMDB file users

You may need to update your MMDB reader to support lookups containing the new output when it is released. You can find a sample MMDB file with mobile_country_code and mobile_network_code on our GitHub page.

Web service users

The new data will be included in the /traits object:

Our client APIs will be updated in the coming weeks to handle the new data. Make sure to keep your client API up to date to start taking advantage of this data.

If you are interfacing directly with our REST API, you can begin receiving the new data right away.

GeoNames Monthly Diff Report January 2022

January 10, 2022

GeoNames Monthly Diff Report (January 2022)

GeoIP2 and GeoLite2 databases incorporate GeoNames geographical data, which is made available under the Creative Commons Attribution 4.0 License.

Monthly updates to GeoNames data are incorporated into our databases as we refresh them. Above you will find a CSV report of these changes for the month of January as they relate to the following fields:

geoname_id
country_name
country_code
city_name
subdivision_1_iso_code
subdivision_2_iso_code

Note that the values for the 'old' and ‘new’ columns for a given field only differ for the field defined in the ‘diff_in’ column.

GeoIP2 Precision is now GeoIP2 web service

January 10, 2022

We're dropping the "Precision" from our GeoIP2 web service names to make the closest equivalent between our web services and databases clearer, and to make it clear that IP geolocation is not precise enough to locate individuals or street addresses. You can learn more about the accuracy and limitations to IP geolocation on our knowledge base.

We are also renaming our city-level geolocation web service to be GeoIP2 City Plus. We have added "Plus" to this web service to make it clearer that the city-level geolocation web service also contains IP network data. You can see a list of all data points in the GeoIP2 City Plus web service on our main website.

Nothing has changed about how to use our web services, and no changes are required to your current integration.

Our GeoIP2 web services will be renamed as follows:

Old Name	New Name (Click for the Product Page on our Main Website)
GeoIP2 Precision Country web service	GeoIP2 Country web service
GeoIP2 Precision City web service	GeoIP2 City Plus web service
GeoIP2 Precision Insights web service	GeoIP2 Insights web service

This page was last updated on August 9, 2022.