 |
地理定位服务-geoPlugin
专用API
【更新时间: 2024.08.09】
geoPlugin 是一个为网站管理员提供全面工具和地理定位服务的平台，它的核心功能包括精确的IP地理定位API。帮助网站管理员更好地理解和分析他们的用户群体，还能根据用户的地理位置提供个性化的内容和服务。
|
- API详情
- 定价
- 使用指南
- 常见 FAQ
- 关于我们
- 相关推荐
什么是geoPlugin的地理定位服务?
"geoPlugin 地理定位服务 IP 位置 - 地理定位" 是一种基于 IP 地址的地理定位服务，它能够检测来自网络访问者的请求，并根据访问者的 IP 地址在世界范围内定位他们，精确到城市级别。这种服务通过反向 IP 地理编码技术实现，为用户提供了一种简单有效的方式来获取访问者的地理位置信息。
什么是geoPlugin的地理定位服务？
geoPlugin的地理定位服务有哪些核心功能？
- IP地理定位：根据访问者的IP地址，在全球范围内精确定位到城市级别，甚至更详细的地理位置信息。
- 多编程语言支持：提供多种编程语言的API接口，如Javascript、PHP、JSON、XML、ASP、CSV等，方便开发者在不同平台上集成和使用。
- 实时更新：利用MaxMind的GeoLite数据库，确保提供的地理位置信息是最新的。
- 无需API密钥：简化了开发者的使用流程，无需注册或申请API密钥即可直接调用服务。
- 附加功能：除了基本的IP地理定位外，还提供货币转换、周边地点查询、欧盟Cookie法及GDPR合规性检查等附加功能。
geoPlugin的地理定位服务的核心优势是什么？
- 免费且稳定：自2006年以来，为全球成千上万的客户提供稳定、可靠、快速且免费的IP地理定位服务。
- 简单易用：只需一次API调用即可获取多种信息，且无需安装任何软件或配置复杂的参数。
- 跨平台支持：支持多种编程语言，方便开发者在不同平台上集成和使用。
- 数据准确：利用MaxMind的GeoLite数据库，提供准确且最新的地理位置信息。
- 附加价值：除了基本的IP地理定位外，还提供一系列附加功能，帮助开发者更好地利用地理位置数据。
在哪些场景会用到geoPlugin的地理定位服务？
- 电商网站：根据访问者的地理位置，自动调整产品价格、显示当地货币、推荐当地仓库发货等，提升用户体验和转化率。
- 内容本地化：根据访问者的地理位置，自动重定向到相应语言的网站版本或提供本地化的内容，如新闻、天气预报等。
- 广告投放：根据访问者的地理位置，精准投放地域性广告，提高广告效果。
- 网络安全：检测访问者的地理位置，帮助识别潜在的欺诈行为或恶意访问。
- 旅游服务：根据用户的当前位置或目标位置，提供相关的旅游信息、景点推荐、天气预报等服务。
geoPlugin 在每分钟 120 次查找的限制内是免费的。
需要每天超过 200 万次查找的高级访问订阅者才能联系我们。费率为以下其中一种：
- 21欧元 每月
- 每 6 个月 105 欧元（1 个月免费，按月价计算）
- 每年 180 欧元（根据每月价格，3.5 个月免费）
对于SSL访问，需要一个API密钥来抵消SSL开销价格和每年24欧元的成本。
如何将 geoPlugin 插入到你的页面
直接从您的页面使用 geoPlugin，需要对 geoPlugin 进行 javascript 调用1)。
这可以通过以下 3 种方式之一完成。
仅限地理本地化的 JavaScript
<script language="JavaScript" src="http://www.geoplugin.net/javascript.gp" type="text/javascript"></script><script language="JavaScript" src="http://www.geoplugin.net/javascript.gp" type="text/javascript"></script>geoPlugin Web 服务接口
有时您需要脚本具有更大的灵活性，并希望在服务器后端脚本而不是网页前端输出上本地化访问者。geoPlugin 允许您通过使用其中一个 geoPlugin Web 服务来执行此操作3)，而无需安装复杂而庞大的数据库。
PHP 服务
PHP服务是最受欢迎的服务，它将返回包含访问者所有信息的PHP序列化数组。此处有详细描述，下面给出了快速指南。 使用以下命令 在脚本中调用此服务
http://www.geoplugin.net/php.gp?ip=xx.xx.xx.xx
当然，请将 xx 替换为访问者的 IP 号码。
http://www.geoplugin.net/json.gp?ip=xx.xx.xx.xxhttp://www.geoplugin.net/xml.gp?ip=xx.xx.xx.xxgeoPlugin 货币转换器
那些关注 geoPlugin 网络服务输出的人会注意到 geoplugin_currencyConverter 变量的输出是一个数字。
此值代表一美元对访问者的汇率。如果您以美元交易，那么这个值非常方便。您只需调用 geoplugin_currencySymbol 值（显示访问者的当地货币），然后将产品价格乘以 geoplugin_currencyConverter 值。
瞧！您的产品价格现在以访问者的当地货币显示给他/她，并且汇率是当天的正确汇率。
但是，如果您的基本货币不是美元，您该怎么办？例如，一个法国网站想要以欧元出售商品。
为此，您需要告诉 geoPlugin 网络服务（Javascript、PHP、JSON和XML都以相同的方式工作）您的基本货币不是美元。 您可以通过在 IP 地址后 添加&base_currency=XXX
来执行此操作。例如
http://www.geoplugin.net/php.gp?ip=38.207.143.79&base_currency=EUR现在 geoplugin_currencyConverter 将为您的访问者输出一欧元的汇率。
base_currency 值必须是标准ISO 4217 3 个字母的代码。
添加域（需要免费注册）
一旦注册并登录，添加域名即可释放 geoPlugin 对这些域名的全部潜力。
除非您特别想要在特定的子域名上使用 geoPlugin，否则请注册主顶级域名（例如yourdomain.com） ，这样所有子域名都将对 geoPlugin 可用。
通过这样做，如果您需要特定子域名的特定功能（例如统计），您可以随时在以后添加特定的子域名。
简而言之，注册主顶级域名就是该主网站下所有域名的统称。
注意： www.yourdomain.com是子域名。即使您的服务器配置为平等对待www.yourdomain.com和yourdomain.com，geoPlugin 也不知道这一点。如果您注册了www.yourdomain.com，那么您将无法在 geoPlugin 上使用yourdomain.com，除非您将其注册为新域名。这是让您的网站与 geoplugin 一起工作最常见的错误！
要注册域名，请登录会员区，然后在域名管理下单击“添加域名”。添加后，您将收到一封电子邮件，了解如何轻松激活此域名。按照注册新域名时收到的电子邮件中的说明进行激活。在域名激活之前，不会提供任何统计数据或 geoPlugin javascript 变量。
注意：如果您未在 geoPlugin 注册域名后的 7 天内激活该域名，该域名将从我们的记录中删除。如果发生这种情况，只需再次注册该域名，但这次请在 7 天内激活它！
geoPlugin 在每分钟 120 次查找的限制内是免费的。
需要每天超过 200 万次查找的高级访问订阅者才能联系我们。费率为以下其中一种：
- 21欧元 每月
- 每 6 个月 105 欧元（1 个月免费，按月价计算）
- 每年 180 欧元（根据每月价格，3.5 个月免费）
对于SSL访问，需要一个API密钥来抵消SSL开销价格和每年24欧元的成本。
如何将 geoPlugin 插入到你的页面
直接从您的页面使用 geoPlugin，需要对 geoPlugin 进行 javascript 调用1)。
这可以通过以下 3 种方式之一完成。
仅限地理本地化的 JavaScript
<script language="JavaScript" src="http://www.geoplugin.net/javascript.gp" type="text/javascript"></script><script language="JavaScript" src="http://www.geoplugin.net/javascript.gp" type="text/javascript"></script>geoPlugin Web 服务接口
有时您需要脚本具有更大的灵活性，并希望在服务器后端脚本而不是网页前端输出上本地化访问者。geoPlugin 允许您通过使用其中一个 geoPlugin Web 服务来执行此操作3)，而无需安装复杂而庞大的数据库。
PHP 服务
PHP服务是最受欢迎的服务，它将返回包含访问者所有信息的PHP序列化数组。此处有详细描述，下面给出了快速指南。 使用以下命令 在脚本中调用此服务
http://www.geoplugin.net/php.gp?ip=xx.xx.xx.xx
当然，请将 xx 替换为访问者的 IP 号码。
http://www.geoplugin.net/json.gp?ip=xx.xx.xx.xxhttp://www.geoplugin.net/xml.gp?ip=xx.xx.xx.xxgeoPlugin 货币转换器
那些关注 geoPlugin 网络服务输出的人会注意到 geoplugin_currencyConverter 变量的输出是一个数字。
此值代表一美元对访问者的汇率。如果您以美元交易，那么这个值非常方便。您只需调用 geoplugin_currencySymbol 值（显示访问者的当地货币），然后将产品价格乘以 geoplugin_currencyConverter 值。
瞧！您的产品价格现在以访问者的当地货币显示给他/她，并且汇率是当天的正确汇率。
但是，如果您的基本货币不是美元，您该怎么办？例如，一个法国网站想要以欧元出售商品。
为此，您需要告诉 geoPlugin 网络服务（Javascript、PHP、JSON和XML都以相同的方式工作）您的基本货币不是美元。 您可以通过在 IP 地址后 添加&base_currency=XXX
来执行此操作。例如
http://www.geoplugin.net/php.gp?ip=38.207.143.79&base_currency=EUR现在 geoplugin_currencyConverter 将为您的访问者输出一欧元的汇率。
base_currency 值必须是标准ISO 4217 3 个字母的代码。
添加域（需要免费注册）
一旦注册并登录，添加域名即可释放 geoPlugin 对这些域名的全部潜力。
除非您特别想要在特定的子域名上使用 geoPlugin，否则请注册主顶级域名（例如yourdomain.com） ，这样所有子域名都将对 geoPlugin 可用。
通过这样做，如果您需要特定子域名的特定功能（例如统计），您可以随时在以后添加特定的子域名。
简而言之，注册主顶级域名就是该主网站下所有域名的统称。
注意： www.yourdomain.com是子域名。即使您的服务器配置为平等对待www.yourdomain.com和yourdomain.com，geoPlugin 也不知道这一点。如果您注册了www.yourdomain.com，那么您将无法在 geoPlugin 上使用yourdomain.com，除非您将其注册为新域名。这是让您的网站与 geoplugin 一起工作最常见的错误！
要注册域名，请登录会员区，然后在域名管理下单击“添加域名”。添加后，您将收到一封电子邮件，了解如何轻松激活此域名。按照注册新域名时收到的电子邮件中的说明进行激活。在域名激活之前，不会提供任何统计数据或 geoPlugin javascript 变量。
注意：如果您未在 geoPlugin 注册域名后的 7 天内激活该域名，该域名将从我们的记录中删除。如果发生这种情况，只需再次注册该域名，但这次请在 7 天内激活它！
