GeoIP City binary database fields

The GeoIP City binary database contains the following fields for each network. The top-level record for each network is a map containing the keys listed below. Each key maps to a map or an array of maps. If a key maps to an undefined or empty value, it is not included in the record.

NameTypeDescription
citymapA map containing details about the city associated with the IP address.
continentmapA map containing details about the continent associated with the IP address.
countrymapA map containing details about the country where MaxMind believes the IP address is located.
locationmapA map containing details about the location associated with the IP address, including coordinates and time zone.
postalmapA map containing details about the postal code associated with the IP address.
registered_countrymapA map containing details about the country where the ISP has registered the IP block. This may differ from the country where the IP is located.
represented_countrymapA map containing details about the country represented by users of the IP address, such as a military base or embassy.
subdivisionsarray of mapsAn array of maps containing data for the subdivisions associated with the IP address, ordered from largest to smallest.
traitsmapA map containing general traits associated with the IP address.

city

NameTypeDescription
geoname_iduint32

A unique identifier for the city as specified by GeoNames.

Learn more about GeoNames IDs on our Knowledge Base.

namesmap

A map from locale codes (e.g., en, de, ja) to localized names.

Learn more about localized geolocation names on our Knowledge Base.

continent

NameTypeDescription
codestring

A two-character continent code like NA (North America) or OC (Oceania).

Learn more about continent codes on our Knowledge Base.

geoname_iduint32

A unique identifier for the continent as specified by GeoNames.

Learn more about GeoNames IDs on our Knowledge Base.

namesmap

A map from locale codes (e.g., en, de, ja) to localized names.

Learn more about localized geolocation names on our Knowledge Base.

country

NameTypeDescription
geoname_iduint32

A unique identifier for the country as specified by GeoNames.

Learn more about GeoNames IDs on our Knowledge Base.

is_in_european_unionboolean

This is true if the country is a member state of the European Union. This key is only present when the value is true.

Learn more about the EU flag on our Knowledge Base.

iso_codestring

The two-character ISO 3166-1 alpha code for the country.

Learn more about country codes on our Knowledge Base.

namesmap

A map from locale codes (e.g., en, de, ja) to localized names.

Learn more about localized geolocation names on our Knowledge Base.

location

NameTypeDescription
accuracy_radiusuint16

The approximate accuracy radius in kilometers around the latitude and longitude for the IP address. This is the radius where we have a 67% confidence that the device using the IP address resides within the circle centered at the latitude and longitude with the provided radius.

Learn about the geolocation area on our Knowledge Base.

latitudedouble

The approximate latitude of the location associated with the IP address. This value is not precise and should not be used to identify a particular address or household.

Learn about the geolocation area on our Knowledge Base.

longitudedouble

The approximate longitude of the location associated with the IP address. This value is not precise and should not be used to identify a particular address or household.

Learn about the geolocation area on our Knowledge Base.

metro_codeuint16Deprecated. Metro codes are no longer maintained.
time_zonestring

The time zone associated with the location, as specified by the IANA Time Zone Database (e.g., America/New_York).

Learn more about time zone data on our Knowledge Base.

postal

NameTypeDescription
codestring

The postal code of the location. Postal codes are not available for all countries. In some countries, this will only contain part of the postal code.

Learn more about postal code data on our Knowledge Base.

registered_country

NameTypeDescription
geoname_iduint32

A unique identifier for the registered country as specified by GeoNames.

Learn more about GeoNames IDs on our Knowledge Base.

is_in_european_unionboolean

This is true if the registered country is a member state of the European Union. This key is only present when the value is true.

Learn more about the EU flag on our Knowledge Base.

iso_codestringThe two-character ISO 3166-1 alpha code for the registered country.
namesmap

A map from locale codes (e.g., en, de, ja) to localized names.

Learn more about localized geolocation names on our Knowledge Base.

represented_country

NameTypeDescription
geoname_iduint32

A unique identifier for the represented country as specified by GeoNames.

Learn more about GeoNames IDs on our Knowledge Base.

is_in_european_unionboolean

This is true if the represented country is a member state of the European Union. This key is only present when the value is true.

Learn more about the EU flag on our Knowledge Base.

iso_codestringThe two-character ISO 3166-1 alpha code for the represented country.
namesmap

A map from locale codes (e.g., en, de, ja) to localized names.

Learn more about localized geolocation names on our Knowledge Base.

typestringA string indicating the type of entity that is representing the country. Currently this is only military but may expand to include other types in the future.

subdivisions

NameTypeDescription
geoname_iduint32

A unique identifier for the subdivision as specified by GeoNames.

Learn more about GeoNames IDs on our Knowledge Base.

iso_codestring

A string up to three characters long containing the subdivision portion of the ISO 3166-2 code.

Learn more about ISO code data on our Knowledge Base.

namesmap

A map from locale codes (e.g., en, de, ja) to localized names.

Learn more about localized geolocation names on our Knowledge Base.

traits

NameTypeDescription
is_anycastboolean

This is true if the IP address belongs to an anycast network. This key is only present when the value is true.

Learn more about anycast data on our Knowledge Base.