GeoIP2 Release Notes

GeoNames Monthly Diff Report September 2023

GeoNames Monthly Diff Report (September 2023)

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.

* Please note: Although we do not include information about time_zone in our monthly Diff Reports, GeoNames is updating the time zones for a number of locations in Ukraine. These updates will be reflected in our time_zone data, which is present in all of our IP geolocation databases and web services.

New Satellite connection type releasing

Effective Tuesday August 29, 2023 we will be adding a new connection type value, Satellite, which will identify satellite internet providers such as Starlink, Viasat, and Hughes. Satellite connections typically have higher latency than cable/DSL connections.

The Satellite connection type value will appear in the following databases:

• GeoIP Connection Type database
• GeoIP Enterprise database

Users of the following client APIs will need to update their API to the latest version to avoid breaking changes with the new value:

• Update Java API to version 4.1.0
• Update Node API to version 4.2.0

API policies - temporary enforcement on October 17, 2023

To improve our server infrastructure and allow for better performance and efficiency, MaxMind will begin enforcing our policies around our API and database download requests in March 2024. To help customers get ready for this change, we will have a planned, temporary enforcement of these policies on October 17, 2023.

What are the policies?

• MaxMind will only accept API and database download requests sent with the more secure HTTPS protocol.
• MaxMind will only accept API and database download requests that are sent to the appropriate hostname as documented in the integration instructions on our Developer Portal (see direct links below).

What do I need to do? If you download GeoIP or GeoLite databases and you use an up to date version of our geoipupdate program, you do not need to take any action.

If you are using web services, or if you do direct downloads of GeoIP or GeoLite databases, you should ensure that you are using the correct hostname for your API requests, and that you are using HTTPS, prior to October 17, 2023. You can view the appropriate URIs for GeoIP and GeoLite services and downloads on our Developer Portal using the links below:

• GeoIP Country, City Plus, and Insights web services
• GeoIP and GeoLite database downloads
• GeoIP Legacy web services
• GeoLite web services

GeoNames Monthly Diff Report August 2023

GeoNames Monthly Diff Report (August 2023)

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.

* A number of new features with improved names were added to Brazil in this month's update.

Resolving more networks to borough of Queens, New York

Starting with tomorrow's release we will begin resolving IPs that currently return the neighborhood of Flushing (Queens, NY) to the corresponding borough of Queens in the city name field.

For more granular place identification (such as neighborhood), we recommend using the postal code where provided.

New Satellite connection type

On Tuesday August 29, 2023 we will be adding a new connection type value, Satellite, which will identify satellite internet providers such as Starlink, Viasat, and Hughes. Satellite connections typically have higher latency than cable/DSL connections.

The Satellite connection type value will appear in the following databases:

• GeoIP Connection Type database
• GeoIP Enterprise database

Users of the following client APIs will need to update their API to the latest version to avoid breaking changes with the new value:

• Update Java API to version 4.1.0
• Update Node API to version 4.2.0

GeoNames Monthly Diff Report July 2023

GeoNames Monthly Diff Report (July 2023)

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.

* This month's update contains a large number of updated names for cities in Vietnam.

Twice weekly updates for the GeoIP Domain Name database

Beginning this Friday, June 16, we will update the GeoIP Domain Name databases twice weekly on Tuesdays and Fridays (instead of monthly). We made this change so that data corrections and 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 GeoIP database downloads. You can find documentation on updating your GeoIP databases on our developer’s site.

Correction regarding London boroughs in our geolocation data

On June 6, we announced that more networks would be mapped to London boroughs beginning on Friday, June 9.

This change has been delayed. It should be present in our products and services beginning on Friday, June 16.

In addition, for networks in the greater London area we will be returning the name of the town for city-level name data instead of the borough. The borough will be populated in the second level subdivision.

For example, a network that maps to the Walthamstow town will return Walthamstow for the city_name, and Walthamstow Forest for the second level subdivision.

Delayed update for GeoIP Anonymous IP database

We are aware of an issue that caused a delay to the GeoIP Anonymous IP database release. The database was not released on Friday, June 9 through Sunday, June 11.

The issue has been corrected, and the database will be released today, Monday, June 12, and going forward, as normal.

GeoNames Monthly Diff Report June 2023

GeoNames Monthly Diff Report (June 2023)

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 contains a large number of updated names for cities in India.

More networks mapped to London boroughs

When a network geolocates to London, we will often return the borough for the city, rather than returning London. Beginning this Friday, June 9, we will be mapping more networks to London boroughs.

This change will apply to all products and services with city-level geolocation data:

• GeoIP City database
• GeoIP City Plus web service
• GeoIP Insights web service
• GeoIP Enterprise database
• minFraud Insights web service
• minFraud Factors web service
• GeoLite City web service
• GeoLite City database

GeoNames Monthly Diff Report May 2023

GeoNames Monthly Diff Report (May 2023)

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.

Off-schedule GeoIP Domain database update

We have released an off-schedule update to the GeoIP Domain database to correct a few minor errors.

New update schedule for GeoIP Domain database

We are changing the release schedule for our GeoIP Domain database.

The next update of the GeoIP Domain database will release on Tuesday, May 2, 2023. Going forward, the GeoIP Domain database will be released on the first Tuesday of each month.

Previously, the GeoIP Domain database was updated every fourth Tuesday.

GeoNames Monthly Diff Report April 2023

GeoNames Monthly Diff Report (April 2023)

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.

Issue Geolocating IPs in Portugal

We are aware of an issue in which our geolocation products and services are not returning correct city-level data for IP addresses located in Portugal.

The issue was introduced in our release of GeoIP databases last Friday, March 17. The issue has been fixed and will be corrected in the next release of our GeoIP databases, scheduled for Tuesday, March 21.

The following products and services are affected:

• GeoIP City database
• GeoIP Enterprise database
• GeoLite City database
• GeoIP City Plus web service
• GeoIP Insights web service

Web service customers will see the corrected data right away. Database customers should download the latest update to our databases to get access to corrected data.

Changes to MaxMind License Keys

We are making changes to the format of our license keys:

• New license keys will be longer, with a six character prefix.
• Beginning on March 27, 2023, we will no longer be issuing unhashed license keys for use with legacy versions of our GeoIP Update program (any version prior to v3.1.1).

For customers using our REST API, Client APIs or version 3.1.1 and higher of our GeoIP Update program:

No action is required. Existing license keys will still be valid and will continue to function normally.

New license keys will have the following changes:

• The character set is changing from [a-zA-Z0-9] to [a-zA-Z0-9_].
• The length of the license key will now be 40 characters.
• License keys will have a _mmk suffix.

Please note that the length of license keys may be increased in the future.

Customers using legacy versions of our GeoIP Update program:

Legacy versions of geoipupdate use less secure unhashed license keys. Beginning on March 27, 2023 we will no longer be issuing new unhashed license keys. Your existing license keys can continue to be used, but you will no longer be able to generate new unhashed license keys.

New license keys only work with geoipupdate version 3.1.1 or greater. We encourage you to update to the latest version at your earliest convenience.

Learn how to upgrade from geoipupdate legacy to the current version on our Developer’s Portal.

GeoNames Monthly Diff Report March 2023

GeoNames Monthly Diff Report (March 2023)

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.

Geolocate Tor Exit Nodes in GeoIP and GeoLite

We have added geolocation data for Tor exit nodes to all our GeoIP and GeoLite products and services with geolocation data.

Please note that the geolocation for Tor exit nodes is not the geolocation of the end user of the IP address, but the geographical location of the exit node itself. Learn more about Tor and other anonymizers on our Knowledge Base.

Geolocation data for Tor exit nodes is now present in:

• GeoIP2 Country database
• GeoIP2 City database
• GeoIP2 Enterprise database
• GeoIP2 Country web service
• GeoIP2 City Plus web service
• GeoIP2 Insights web service
• GeoLite2 Country database
• GeoLite2 City database
• GeoLite2 Country web service
• GeoLite2 City web service

GeoNames Monthly Diff Report February 2023

GeoNames Monthly Diff Report (February 2023)

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.

Change to AT&T ISP name

On Monday, February 6 we will be updating MaxMind products and services with ISP data to consolidate naming conventions for certain AT&T ISP names. We will now return AT&T Internet instead of AT&T Internet Services and AT&T U-verse. We are updating these values to more accurately reflect new brand name used by AT&T.

The following 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

GeoNames Monthly Diff Report January 2023

GeoNames Monthly Diff Report (January 2023)

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.

* A number of the cities in Ukraine have been updated with more accurate English names.