Goal
We want to know what information is available from the Maxmind database to display about an IP address. This will help us determine the design for the feature.
This task is to document all data available to us from Maxmind. Tentative table below, feel free to modify as you see fit.
| Category | Data point | Definition/Explanation |
|---|---|---|
| City | City-level data associated with an IP address. This record is returned by all location services and databases besides Country. | |
| confidence | A value from 0-100 indicating MaxMind's confidence that the city is correct. This attribute is only available from the Insights service and the GeoIP2 Enterprise database. | |
| geonameId | The GeoName ID for the city. This attribute is returned by all location services and databases. | |
| name | The name of the city based on the locales list. This attribute is returned by all location services and databases. | |
| names | A array map where the keys are locale codes and the values are names. This attribute is returned by all location services and databases. | |
| Continent | Contains data for the continent record associated with an IP address. This record is returned by all location services and databases. | |
| code | A two character continent code like "NA" (North America) or "OC" (Oceania). This attribute is returned by all location services and databases. | |
| geonameId | The GeoName ID for the continent. This attribute is returned by all location services and databases. | |
| name | Returns the name of the continent based on the locales list. This attribute is returned by all location services and databases. | |
| names | An array map where the keys are locale codes and the values are names. This attribute is returned by all location services and databases. | |
| Country | Contains data for the country record associated with an IP address. This record is returned by all location services and databases. | |
| confidence | A value from 0-100 indicating MaxMind's confidence that the country is correct. This attribute is only available from the Insights service and the GeoIP2 Enterprise database. | |
| geonameId | The GeoName ID for the country. This attribute is returned by all location services and databases. | |
| isInEuropeanUnion | This is true if the country is a member state of the European Union. This attribute is returned by all location services and databases. | |
| isoCode | The ISO 3166-1 alpha-2 code for the country. This attribute is returned by all location services and databases. | |
| name | The name of the country based on the locales list. This attribute is returned by all location services and databases. | |
| names | An array map where the keys are locale codes and the values are names. This attribute is returned by all location services and databases. | |
| Location | Contains data for the location record associated with an IP address. This record is returned by all location services and databases besides Country. | |
| averageIncome | The average income in US dollars associated with the requested IP address. This attribute is only available from the Insights service. | |
| accuracyRadius | 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. | |
| latitude | 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. | |
| longitude | 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. | |
| populationDensity | The estimated population per square kilometer associated with the IP address. This attribute is only available from the Insights service. | |
| metroCode | The metro code of the location if the location is in the US. MaxMind returns the same metro codes as the Google AdWords API. | |
| timeZone | The time zone associated with location, as specified by the IANA Time Zone Database, e.g., "America/New_York". | |
| MaxMind | Contains data about your account. This record is returned by all location services and databases. | |
| queriesRemaining | The number of remaining queries you have for the service you are calling. | |
| Postal | Contains data for the postal record associated with an IP address. This record is returned by all location databases and services besides Country. | |
| code | 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. This attribute is returned by all location databases and services besides Country. | |
| confidence | A value from 0-100 indicating MaxMind's confidence that the postal code is correct. This attribute is only available from the Insights service and the GeoIP2 Enterprise | |
| RepresentedCountry | Contains data for the represented country associated with an IP address. This class contains the country-level data associated with an IP address for the IP's represented country. The represented country is the country represented by something like a military base. | |
| type | A string indicating the type of entity that is representing the country. Currently we only return military but this could expand to include other types in the future. | |
| confidence | A value from 0-100 indicating MaxMind's confidence that the country is correct. This attribute is only available from the Insights service and the GeoIP2 Enterprise database. | |
| geonameId | The GeoName ID for the country. This attribute is returned by all location services and databases. | |
| isInEuropeanUnion | This is true if the country is a member state of the European Union. This attribute is returned by all location services and databases. | |
| isoCode | The ISO 3166-1 alpha-2 code for the country. This attribute is returned by all location services and databases. | |
| name | The name of the country based on the locales list. This attribute is returned by all location services and databases. | |
| names | An array map where the keys are locale codes and the values are names. This attribute is returned by all location services and databases. | |
| Subdivision | Contains data for the subdivisions associated with an IP address. This record is returned by all location databases and services besides Country. | |
| confidence | This is a value from 0-100 indicating MaxMind's confidence that the subdivision is correct. This attribute is only available from the Insights service and the GeoIP2 Enterprise database. | |
| geonameId | This is a GeoName ID for the subdivision. This attribute is returned by all location databases and services besides Country. | |
| isoCode | This is a string up to three characters long contain the subdivision portion of the ISO 3166-2 code. This attribute is returned by all location databases and services except Country. | |
| name | The name of the subdivision based on the locales list. This attribute is returned by all location databases and services besides Country. | |
| names | An array map where the keys are locale codes and the values are names. This attribute is returned by all location databases and services besides Country. | |
| Traits | Contains data for the traits record associated with an IP address. This record is returned by all location services and databases. | |
| autonomousSystemNumber | The autonomous system number associated with the IP address. This attribute is only available from the City and Insights web service and the GeoIP2 Enterprise database. | |
| autonomousSystemOrganization | The organization associated with the registered autonomous system number for the IP address. This attribute is only available from the City and Insights web service and the GeoIP2 Enterprise database. | |
| connectionType | The connection type may take the following values: Dialup, Cable/DSL, Corporate, Cellular. Additional values may be added in the future. This attribute is only available in the GeoIP2 Enterprise database. | |
| domain | The second level domain associated with the IP address. This will be something like "example.com" or "example.co.uk", not "foo.example.com". This attribute is only available from the City and Insights web service and the GeoIP2 Enterprise database. | |
| ipAddress | The IP address that the data in the model is for. If you performed a "me" lookup against the web service, this will be the externally routable IP address for the system the code is running on. If the system is behind a NAT, this may differ from the IP address locally assigned to it. This attribute is returned by all end points. | |
| isAnonymous | This is true if the IP address belongs to any sort of anonymous network. This property is only available from GeoIP2 Precision Insights. | |
| isAnonymousProxy | Deprecated. Please see our GeoIP2 Anonymous IP database to determine whether the IP address is used by an anonymizing service. | |
| isAnonymousVpn | This is true if the IP address is registered to an anonymous VPN provider. If a VPN provider does not register subnets under names associated with them, we will likely only flag their IP ranges using the isHostingProvider property. This property is only available from GeoIP2 Precision Insights. | |
| isHostingProvider | This is true if the IP address belongs to a hosting or VPN provider (see description of isAnonymousVpn property). This property is only available from GeoIP2 Precision Insights. | |
| isLegitimateProxy | This attribute is true if MaxMind believes this IP address to be a legitimate proxy, such as an internal VPN used by a corporation. This attribute is only available in the GeoIP2 Enterprise database. | |
| isPublicProxy | This is true if the IP address belongs to a public proxy. This property is only available from GeoIP2 Precision Insights. | |
| isResidentialProxy | This is true if the IP address is on a suspected anonymizing network and belongs to a residential ISP. This property is only available from GeoIP2 Precision Insights. | |
| isSatelliteProvider | Deprecated. Due to the increased coverage by mobile carriers, very few satellite providers now serve multiple countries. As a result, the output does not provide sufficiently relevant data for us to maintain it. | |
| isTorExitNode | This is true if the IP address is a Tor exit node. This property is only available from GeoIP2 Precision Insights. | |
| isp | The name of the ISP associated with the IP address. This attribute is only available from the City and Insights web services and the GeoIP2 Enterprise database. | |
| network | The network in CIDR notation associated with the record. In particular, this is the largest network where all of the fields besides ipAddress have the same value. | |
| organization | The name of the organization associated with the IP address. This attribute is only available from the City and Insights web services and the GeoIP2 Enterprise database. | |
| staticIPScore | An indicator of how static or dynamic an IP address is. This property is only available from GeoIP2 Precision Insights. | |
| userCount | The estimated number of users sharing the IP/network during the past 24 hours. For IPv4, the count is for the individual IP. For IPv6, the count is for the /64 network. This property is only available from GeoIP2 Precision Insights. | |
| userType | The user type associated with the IP address. This can be one of the following values: business, cafe, cellular, college, content_delivery_network, dialup, government, hosting, library, military, residential, router, school, search_engine_spider traveler. This attribute is only available from the Insights web service and the GeoIP2 Enterprise database. |