常见问题
我们最常收到的问题的简短解答。如果您的问题不在这里,请提问。
快速入门
试用需要 API 密钥或账户吗?
不需要。任何地址无需密钥、无需账户每天即可发送 2,500 个请求,适用于所有端点和所有兼容替换主机。当您需要自己的密钥、使用记录、预付额度或 Unlimited 套餐时再注册(只需您的姓名、电子邮件地址和密码)。来自同一网络的无密钥请求和带密钥请求共享同一份每日配额,因此注册账户并不会让 2,500 个免费请求翻倍。
注册需要什么?
您的姓名、电子邮件地址和密码。仅此而已:无需公司信息,无需银行卡。您可以立即创建更多密钥,并在您决定时随时充值或购买套餐。
额度如何运作?
您预先为余额充值,金额从 €5 起任意,可用银行卡或加密货币支付。某个密钥当天超出 2,500 个免费请求后,每个请求从中扣除 €0.0001。额度由您所有的按量付费密钥共享,永不过期,也不会自动扣款。额度用完后,超出免费配额的请求会被拒绝并返回 402,直到您充值为止。
你们如何收款?
通过 Polar 使用银行卡支付,或通过 NOWPayments 使用加密货币支付:Bitcoin、Ethereum、USDT、USDC、Litecoin 等多种币种。金额在结账时确定,并在付款确认后入账。所有价格均以欧元计价。
Unlimited 套餐包含什么?
一个在所有端点和所有兼容替换主机上都不按请求收费的密钥,每月 €50,每滚动 24 小时最多可从三个 IP 地址使用。每个套餐都有自己的密钥;如果您有多个应用,可以订购多个套餐。请参阅价格。
有推荐计划吗?
有。您的控制台中有一个推荐链接;通过该链接注册的用户每支付一张账单,其金额的 10% 会进入与您的额度分开存放的推荐余额。您可以随时将其转入额度,或在达到 €20 后以加密货币提现。提现由人工处理,交易 ID 会显示在您的控制台中。
有优惠券代码吗?
有时会有:充值或套餐的百分比折扣或固定金额折扣,或赠送额度。在创建账单时,或在支付任何未付账单之前输入代码即可。
访问与限制
免费配额如何计算?
按密钥、按 UTC 日计算,涵盖所有端点和兼容替换主机。批量 IP 查询和多点海拔调用按每一项计数。被拒绝的请求和服务器错误从不计数。
IP 限制是什么意思?
最先使用某个密钥的地址各自占用一个名额,从其首次请求起保留 24 小时。按量付费密钥有两个名额,Unlimited 密钥有三个。名额的 24 小时结束后会自动释放,因此如果两台服务器在 02:00 使用了该密钥,第三台在 04:00 使用,那么两个名额会在次日 02:00 重新空出,第三个在 04:00 空出。所有名额都被占用时,来自新地址的请求会被拒绝,返回 HTTP 403 和代码 key_ip_limit;响应会说明下一个名额何时释放。如需更多机器,请创建更多密钥或添加更多套餐。
我可以从浏览器或移动应用调用 API 吗?
已启用 CORS,但客户端代码中的密钥对所有人可见,并会在几个访客之后达到 IP 限制。请从您自己的服务器调用 API,并将密钥放在服务器上。JavaScript 地图兼容替换也是如此:瓦片和库加载无需密钥,地理编码调用应经过您的服务器。
除了每日配额之外还有速率限制吗?
目前没有固定的速率限制。看起来像失控循环或攻击的流量可能会被减速,如果您的某个密钥发生这种情况,我们会通知您。批量端点的存在就是为了让您不需要每秒发送数百个请求。
如果我的密钥泄露了怎么办?
在控制台中撤销它并创建一个新密钥。由于 IP 限制,泄露的密钥每天本来就无法从超过两三台机器使用;而且由于额度是预付的,任何人都无法产生超出您所充值余额的费用。
数据与准确性
precision 字段是什么意思?
它告诉您返回的坐标点代表什么:house 表示建筑物或地块,street 表示沿街道插值得到的位置,postcode 表示邮政编码区域的中心,admin 表示城市、区县、地区或国家的中心。如果您查询的是门牌地址却得到 postcode,说明我们没有找到该门牌。
哪些国家有门牌级数据?
覆盖范围页面列出了 249 个国家和地区各自可用的最佳级别,并可按区域和级别筛选。每次数据发布时都会更新。
你们使用哪些数据来源?
官方地址和邮政数据、用于 IP 查询的互联网注册和路由数据、标准时区数据库和全球地形模型,以及我们自己的修正。每个来源在纳入之前都会与其他来源交叉核对,我们不从其他地理编码服务抓取任何数据。
我可以存储或缓存结果吗?
可以。结果归您所有,可以保存在您的数据库中、缓存,并显示在任何地图上,包括其他服务商的地图。条款中唯一的限制是不得将原始数据作为您自己的地理编码服务转售。
数据多久更新一次?
地址数据每月更新,IP 数据每周更新,时区规则在 IANA 发布新版本时更新,海拔数据在出现更好的公开模型时更新。
支持英语以外的语言吗?
传入带 ISO 639-1 代码的 lang,在我们有相应数据的情况下,地名会以该语言返回,否则回退为当地名称。地址格式遵循地址所在国家的惯例。
兼容性
兼容替换主机是原 API 的完全复制品吗?
路径、参数和响应结构与各服务商的公开文档一致,因此现有客户端代码无需修改即可解析响应。数据来自我们,因此数值会有所不同,另有少数服务商特有的功能未包含在内。每个兼容性页面都列出了差异。
Google Maps JavaScript 兼容替换会显示 Google 的地图瓦片吗?
不会。gapi.mygeocode.com 上的加载器提供 google.maps 命名空间,背后是我们自己的地图瓦片、地理编码器、自动补全和海拔服务。不包含 Street View、Directions 和 Places Details。地图加载不计入您的配额。请参阅 JavaScript 兼容替换。
My Geocode 与 Google、Microsoft、HERE 或 Mapbox 有关联吗?
没有。这些名称归其所有者所有,在此仅用于说明我们能够以哪些格式作答。
支持
有正常运行时间保证吗?
自助方案不附带合同形式的 SLA。我们在多个区域运行 API,并在 status.mygeocode.com 显示实时状态。如果您需要书面 SLA,请联系我们。
如何获得支持?
发送电子邮件至 support@mygeocode.com。付费账户会在一个工作日内得到回复。免费密钥用户的问题也会在时间允许时得到解答。