GeoIP2 JavaScript 客户 API

如果您是一个老的GeoIP用户, 请参阅我们的“GeoIP2新特性”。

购买方式

请前往 网络服务购买页面.

注册

所有的用JS的网址都需要注册。 新用户可以在此 申请账号. 注册用户 在此注册域名.

JavaScript

以下的JS代码需要包含在页面中

教程

教程请前往: GeoIP2 JS教程.

API

登记JS API之后会有如下四个function

Function 说明
geoip2.country(onSuccess, onError, options) 国家
geoip2.city(onSuccess, onError, options) 城市
geoip2.insights(onSuccess, onError, options) 完全信息

参数

所有的function都接收如下三个参数

  • 呼叫成功后会接收到网络服务API回复

  • 如果有问题,则会呼叫错误。
  • 选择性呼叫还没有开发。

成功回复

一个成功的呼叫会回复一个成功的回复。回复包括key/value配对,其中国家,城市等为key,他们相应的数值则是value。

JS API会自动填充所有不存在数值,为您使用带来方便。

如果您呼叫城市而这个IP

如果呼叫中没有属地 key您会获得如下:

代码样例

错误

错误也会以JS 物件形式返回。 其中包含错误代码以及描述。

代码 HTTP 状态 描述
IP_ADDRESS_INVALID 400 Bad Request

IP地址有误

IP_ADDRESS_REQUIRED 400 Bad Request

没有提供IP地址

IP_ADDRESS_RESERVED 400 Bad Request

IP地址不合法

IP_ADDRESS_NOT_FOUND 404 Not Found 数据库没有该IP地址
DOMAIN_REGISTRATION_REQUIRED 401 Unauthorized 域名未注册
QUERY_FORBIDDEN 401 Unauthorized

您没有这种查询余额

OUT_OF_QUERIES 402 Payment Required

查询余额为0

HTTP_TIMEOUT (none) 请求超时
HTTP_ERROR (none)

请求有误

版本

我们目前是2.0版本,如果我们有了新的版本比如42.6他的链接就是: /js/apis/geoip2/v42.6/geoip2.js.我们保存所有版本的链接。

我们只对最新版本提供技术支持。

JS API和Rest API是分开记录版本的。

更新说明

更新说明.

浏览器支持

MaxMind尽力支持所有浏览器。我们只对浏览器提供商第一阶段支持的浏览器支持,比如说微软有主流支持和延时支持,我们只保证支持他们的主流支持浏览器。如下是我们测试API的浏览器。

浏览器 平台 版本
Chrome Windows XP, 7, 8 Latest stable release only
Linux
OS X 10.6
Firefox Windows XP, 7, 8 4-21
Linux
OS X 10.6
Internet Explorer Windows XP 8
Windows 7 8, 9
Windows 8 10
Safari Windows 7 5
OS X 10.6 5
OS X 10.8 6
Opera Windows XP, 7 10-12
Linux 12
(native browser) iOS 4.3, 5, 5.1, 6
(native browser) Android 4