GeoIP Release Notes

We have released an updated version of the GeoIP2 City database, which fixes a geolocation bug affecting some IPv6 addresses.

See the Geolocation Coordinate Bug Fix release note for more information about this bug.

Customers should download the updated GeoIP2 City database at their earliest convenience.

We are aware of a bug in which databases and web services have been returning geolocation location coordinates of 0,0 for IPv6 addresses which are geolocated only down to the country-level.

The following databases and web services are affected:

• GeoIP2 City database
• GeoIP2 Enterprise database
• GeoIP Legacy City web service
• GeoIP Legacy Omni/Insights web service
• GeoIP2 City Plus web service
• GeoIP2 Insights web service
• minFraud Insights web service
• minFraud Factors web service

We have a fix, and it will be released later today.

The updated GeoIP2 City database is now available for download.

Web service users will see the corrected data as soon as the fix has been implemented.

We apologize for any inconvenience this may have caused.

GeoNames Monthly Diff Report (August 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 August 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 corrects an error in which several subdivisions in China had their names populated into the city_name field by error. The city_name field for these subdivisions has been removed.

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)

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.

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

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:

1. 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.
2. Area codes: Area code fields will now return blank.
3. 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.

Starting this Friday, May 27, GeoLite databases will be updated twice weekly, on Tuesdays and Fridays. The following databases 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)

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)

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)

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.

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.

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)

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.

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.

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:

• /traits/mobile_country_code
• /traits/mobile_network_code

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)

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.

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:

GeoNames Monthly Diff Report (December 2021)

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 December 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.

Due to the December holidays, we will not be providing database updates for certain databases next Friday, December 24 and Friday, December 31. The following GeoIP2 databases will not have their regularly scheduled updates:

• GeoIP2 Country
• GeoIP2 City
• GeoIP2 ISP
• GeoIP2 Enterprise

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

We will resume our regular update schedule beginning on Tuesday, January 4.

Due to the Thanksgiving holiday, we will not be providing database updates for certain databases this Friday, November 26. The following GeoIP2 databases will not have their regularly scheduled update:

• GeoIP2 Country
• GeoIP2 City
• GeoIP2 ISP
• GeoIP2 Enterprise

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

We will resume our regular update schedule beginning on Tuesday, November 30.

GeoNames Monthly Diff Report (November 2021)

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 November 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.

We completed our most recent review and update of geolocation for Crimea. Our accuracy has increased as follows:

• Approximately 96% of website visitors who are from Crimea are currently located by GeoIP2 as being in Crimea.
• Approximately 99% of the visitors who are located in Crimea by GeoIP2 are actually in Crimea.

Due to the nature of geolocation technology and other factors beyond our control, we cannot guarantee any specific future accuracy level. Further, accuracy figures are subject to change as IP networks are reallocated.

GeoNames Monthly Diff Report (October 2021)

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 October 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.

We are releasing an update for our GeoIP2 Country, City, and Enterprise databases, and for our GeoIP2 Country, City Plus, and Insights web services to fix a bug that geolocated about 0.1% of IP addresses located in Japan to the wrong country and the wrong coordinates.

When the updated databases are released today, you will be able to download them via your account portal, or using your GeoIP Update program. If you use any of the GeoIP2 web services, you will have access to the updated data with no further action required.

Effective October 4, 2021, the minimum accuracy radius value will be 5km across our city/postal-level geolocation products and services. Previously, the minimum accuracy radius value was 1km. This change applies to the following products and services:

• GeoIP2 City database
• GeoLite2 City database
• GeoIP2 Enterprise database
• GeoIP2 City Plus web service
• GeoIP2 Insights web service
• minFraud Insights and Factors web services

We are making this change in order to ensure it is clear that IP geolocation should not be used to identify a particular street address or household.

GeoNames Monthly Diff Report (September 2021)

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 September 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.

We have updated our data in a number of ways in preparation for the rollout of iCloud Private Relay. We have worked with Apple to ensure that our data accurately reflects how Private Relay works and delivers the best possible user experience for your users.

• Geolocation data across our products and services now incorporate the IP geolocation feeds published by Apple, which provides coarse city or region geolocation mappings for iCloud Private Relay IPs.
• We identify iCloud Private Relay IPs in our ISP dataset (present in our GeoIP2 ISP and Enterprise databases, and in our GeoIP2 Insights web service) by tagging ranges as iCloud Private Relay.

Apple has shared the following assurances built into Private Relay:

• Geolocation information for clients is validated by the relay servers using signed tokens, and visible to origins through the IP addresses selected by relay servers.
  • A user is not able to arbitrarily select their geolocation to evade geolocation controls.
• Access to relay servers is rate-limited using device attestation to reduce fraud.
• All traffic is secured using TLS 1.3.

To ensure your website and servers are ready for Private Relay, database customers should be sure to update to the latest MaxMind GeoIP2 databases.

In order to get ISP data that includes Private Relay IPs, update to the latest GeoIP2 ISP or Enterprise database. In order to get geolocation data for Private Relay IPs, update to the latest GeoIP2 City or Enterprise database.

GeoIP2 Insights customers do not need to take any action to receive this data. It will be returned in the /traits/isp and /traits/organization outputs.

For more information about Private Relay along with helpful technical information, visit Prepare Your Network or Web Server for Private Relay on Apple’s developer website.

We will continue to monitor these IPs and make any adjustments that are needed in the future.

We will be mapping more mobile (cellular) networks to a state (subdivision) rather than a city for the United States and other countries. This change will better reflect the end user location of these IP addresses across a region instead of a specific city.

For example, many of these networks use IP addresses across a region like “New England.” In such cases, we may map IP addresses to a state in the geographic center of the region, and set the accuracy_radius and subdivision_confidence values appropriately. See our Support Center documentation on GeoIP2 accuracy for more information about accuracy_radius values.

These changes will be implemented incrementally. Some IP addresses will reflect this change on September 2, 2021, and additional IP addresses will be updated on September 13, 2021.

The file sizes of the GeoIP2 Country, City, and Enterprise databases, and the GeoLite2 Country and City databases will increase significantly on Friday, August 20, 2021. The file size increase is due to the activation of a large number of IPv6 network ranges.

• GeoIP2 Country
  • Binary (MMDB): increase less than 1% to approximately 5.7 MB
  • CSV IPv6 Blocks File: increase less than 1% to approximately 15 MB
• GeoIP2 City
  • Binary (MMDB): increase around 2% to approximately 126 MB
  • CSV IPv6 Blocks File: increase around 8% to approximately 10.8 MB
• GeoIP2 Enterprise
  • Binary (MMDB): increase less than 1% to approximately 364 MB
  • CSV IPv6 Blocks File: increase around 7% to approximately 160 MB

Update: The changes in file size were not as significant as initially forecast. We are working to establish processes that will allow us to provide better notification about a change in database file size.

GeoNames Monthly Diff Report (August 2021)

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 August 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 (July 2021)

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 2021)

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.

* This month’s update includes a significant number of changes to city_names in Ukraine and geoname_ids in Brazil.

We now update GeoIP2 Country, City, ISP, and Enterprise databases (and most of their legacy equivalents) twice weekly on Tuesdays and Fridays (instead of weekly). We made this change so that data corrections and location updates can be deployed more quickly.

If you would like to take advantage of these more frequent updates, you will have to update the schedule of your GeoIP2 database downloads. You can find documentation on updating your GeoIP2 databases on our developer’s site.

GeoNames Monthly Diff Report (May 2021)

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.

* This month’s update includes a significant number of changes to subdivision codes in Algeria and Lithuania.

GeoNames Monthly Diff Report (April 2021)

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 2021)

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.

* This month’s update includes changes that should improve overall accuracy of city-level name data.

GeoNames Monthly Diff Report (February 2021)

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.

We will be mapping more mobile (cellular) networks to a state (subdivision) rather than a city for Telstra Internet IPs in Australia, as well as other mobile networks in France and other countries. This change will better reflect the traffic distribution of these IP addresses across a state.

These changes will be implemented incrementally. Some IP addresses will reflect this change on February 2, 2021, and additional IP addresses will be updated on February 16, 2021.

On Monday, January 25 we will be updating MaxMind products and services with ISP data to consolidate naming conventions for Vodafone Germany. We will now return either Vodafone Germany Cable, Vodafone Germany DSL, Vodafone Germany Business, or Vodafone Germany. Previous values were Vodafone GmbH, Vodafone Germany, and Vodafone DSL. We are updating these values to more accurately reflect the type of connection that the IP address is associated with.

The following GeoIP databases and services are affected by this change:

• GeoIP2 ISP database
• GeoIP2 Enterprise database
• GeoIP Legacy ISP and Organization databases
• GeoIP2 City Plus and Legacy City Web Service
• GeoIP2 and Legacy Insights Web Service
• minFraud Insights
• minFraud Factors