MaxMind GeoIP2 .NET API中文介绍与使用指南

【实例简介】
MaxMind GeoIP2 .NET API源码下载
GeoIP2 .NET API为开发者提供了一个强大的接口，用于GeoIP2和GeoLite2的网络服务和数据库。本API支持多线程使用，适用于.NET平台。

安装指南

推荐通过NuGet安装这个库，可以在Visual Studio包管理器控制台中输入：

install-package MaxMind.GeoIP2

IP地理定位的使用

IP地理定位并不精确，通常定位到人口中心附近。GeoIP2数据库或网络服务提供的任何位置信息都不应用于识别具体地址或家庭。

网络服务使用示例

要使用网络服务API，首先需要用账户ID和许可证密钥创建一个新的WebServiceClient对象。然后，您可以调用同步或异步方法查询特定端点，传入您想要查询的IP地址。

ASP.NET Core的应用

在ASP.NET Core中使用这个API，需要在Startup.cs的ConfigureServices方法中添加配置，并在appsettings.json中配置您的账户ID和许可证密钥。

数据库使用

使用数据库API时，必须使用GeoIP2数据库的路径来创建一个新的DatabaseReader对象。我们建议重用DatabaseReader对象而不是为每次查找创建一个新对象。

错误处理

如果数据库损坏或无效，将抛出MaxMind.Db.InvalidDatabaseException异常。对于网络服务返回的错误，将根据错误类型抛出不同的异常。

数据问题报告

如果发现IP地址映射不正确，请向MaxMind提交更正。对于其他类型的错误，如拼写错误，请先检查GeoNames网站。

【实例截图】
【核心代码】
文件清单
└── GeoIP2-dotnet-c38eace5b851b8643a8f7b1c9b792d22052fe9a6
    ├── dev-bin
    │   └── release.ps1
    ├── Dockerfile
    ├── LICENSE
    ├── MaxMind.GeoIP2
    │   ├── CustomDictionary.xml
    │   ├── DatabaseReader.cs
    │   ├── Exceptions
    │   │   ├── AddressNotFoundException.cs
    │   │   ├── AuthenticationException.cs
    │   │   ├── GeoIP2Exception.cs
    │   │   ├── HttpException.cs
    │   │   ├── InvalidRequestException.cs
    │   │   ├── OutOfQueriesException.cs
    │   │   └── PermissionRequiredException.cs
    │   ├── GlobalSuppressions.cs
    │   ├── Http
    │   │   ├── Client.cs
    │   │   ├── ISyncClient.cs
    │   │   ├── Response.cs
    │   │   └── SyncClient.cs
    │   ├── IGeoIP2DatabaseReader.cs
    │   ├── IGeoIP2Provider.cs
    │   ├── IGeoIP2WebServicesClient.cs
    │   ├── MaxMind.GeoIP2.csproj
    │   ├── MaxMind.GeoIP2.nuspec
    │   ├── MaxMind.GeoIP2.ruleset
    │   ├── Model
    │   │   ├── City.cs
    │   │   ├── Continent.cs
    │   │   ├── Country.cs
    │   │   ├── Location.cs
    │   │   ├── MaxMind.cs
    │   │   ├── NamedEntity.cs
    │   │   ├── Postal.cs
    │   │   ├── RepresentedCountry.cs
    │   │   ├── Subdivision.cs
    │   │   ├── Traits.cs
    │   │   └── WebServiceError.cs
    │   ├── NetworkConverter.cs
    │   ├── NuGet.targets
    │   ├── Properties
    │   │   └── AssemblyInfo.cs
    │   ├── Responses
    │   │   ├── AbstractCityResponse.cs
    │   │   ├── AbstractCountryResponse.cs
    │   │   ├── AbstractResponse.cs
    │   │   ├── AnonymousIPResponse.cs
    │   │   ├── AsnResponse.cs
    │   │   ├── CityResponse.cs
    │   │   ├── ConnectionTypeResponse.cs
    │   │   ├── CountryResponse.cs
    │   │   ├── DomainResponse.cs
    │   │   ├── EnterpriseResponse.cs
    │   │   ├── InsightsResponse.cs
    │   │   └── IspResponse.cs
    │   ├── WebServiceClient.cs
    │   └── WebServiceClientOptions.cs
    ├── MaxMind.GeoIP2.Benchmark
    │   ├── GlobalSuppressions.cs
    │   ├── MaxMind.GeoIP2.Benchmark.csproj
    │   ├── Program.cs
    │   └── Properties
    │       └── AssemblyInfo.cs
    ├── MaxMind.GeoIP2.sln
    ├── MaxMind.GeoIP2.sln.DotSettings
    ├── MaxMind.GeoIP2.UnitTests
    │   ├── DatabaseReaderTests.cs
    │   ├── DeserializationTests.cs
    │   ├── GlobalSuppressions.cs
    │   ├── MaxMind.GeoIP2.UnitTests.csproj
    │   ├── Model
    │   │   └── LocationTests.cs
    │   ├── NamedEntityTests.cs
    │   ├── Properties
    │   │   └── AssemblyInfo.cs
    │   ├── ResponseHelper.cs
    │   ├── ResponseTests.cs
    │   ├── TestData
    │   │   └── MaxMind-DB
    │   ├── TestUtils.cs
    │   └── WebServiceClientTests.cs
    ├── MaxMind-logo.png
    ├── MaxMind.snk
    ├── README.dev.md
    ├── README.md
    └── releasenotes.md

15 directories, 73 files