DOC: add IPI migration guide for IPInfo and MaxMind#136
Open
jwrosewell wants to merge 2 commits into
Open
Conversation
New subpages under IP Intelligence comparing IPInfo and MaxMind response fields to the equivalent 51Degrees properties. Each vendor gets its own page with tables grouped by topic (geolocation, ASN, privacy, mobile, anonymizer etc), plus a "Properties unique to 51Degrees" section calling out features such as weighted country lists, diversity scores, bot identification, and human probability. Mappings reference the published 51Degrees properties verified against the common-metadata repository and the IIpIntelligenceData interface in ip-intelligence-dotnet. External vendor links carry rel="nofollow". Two callout paragraphs explain features readers ask about most: coordinate randomization (Latitude and Longitude are averaged then randomized within 1 km during data file generation, for privacy) and the categorical LocationConfidence property that complements numeric accuracy radii. Wired into the IPI index as the new IpIntelligence_Migration subpage. References #124
Contributor
Author
|
@Eddie51D — please treat this as a starting point rather than a final mapping. The structure, page wiring, callouts and "no equivalent" handling should be ready to ship, but the individual row mappings (especially the rows flagged as "Approximate" in the Notes column) need a pass against your internal product knowledge before this goes out to customers. Specific areas worth a closer look:
Once you've made any corrections, feel free to close issue #124 yourself. |
Contributor
Eddie51D
approved these changes
May 21, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds a new IP Intelligence Migration Guide so customers evaluating 51Degrees as a replacement for IPInfo or MaxMind can see, at a glance, how the response fields they are used to map to the equivalent 51Degrees properties.
New pages:
src/ipintelligence/migration/index.md(landing, anchorIpIntelligence_Migration)src/ipintelligence/migration/ipinfo.md(anchorIpIntelligence_Migration_IpInfo)src/ipintelligence/migration/maxmind.md(anchorIpIntelligence_Migration_MaxMind)Plus a one-line wiring change in
src/ipintelligence/index.mdadding@subpage IpIntelligence_Migration.What the pages contain
Each vendor page has mapping tables grouped by topic (geolocation, ASN, privacy, mobile carrier, anonymizer, etc.) with three columns: vendor field, 51Degrees property, and notes. Notes call out approximate mappings, single-value vs. weighted-list shape differences, and "no direct equivalent" cases (left blank, per the intro).
Two callouts highlight 51Degrees-specific behaviour readers tend to ask about:
Latitude/Longitudeare averaged and randomized within around 1 km during data file generation, so coordinates can never be classified as personal data.LocationConfidencerolls up the per-level numeric*.confidencefields that MaxMind exposes;AccuracyRadiusMax/AccuracyRadiusMincomplement it with spatial precision.Each page closes with a "Properties unique to 51Degrees" section listing weighted country lists, diversity scores, bot identification, human probability, and probabilistic identifiers.
Sources of truth
common-metadatarepository (Properties/Location/,Properties/Network/,Properties/Asn/, etc.).IAspectPropertyValue<float>, not a weighted list) verified againstIIpIntelligenceData.csinip-intelligence-dotnet.rel="nofollow"(https://ipinfo.io/developers and https://dev.maxmind.com/geoip/docs/web-services/responses).Test plan
IpIntelligence_Migration*).@ref IpIntelligence_Features_Randomization,_Weighting,_Countries,_Diversity,_Human) point to existing pages.rel="nofollow"; property-dictionary links use the bare URL.References #124