API 一览
https://api.mygeocode.com/v1/ 下共有八个端点。每个端点都通过 GET 请求接受查询参数并返回 JSON。它们共享同一个配额、同一套错误代码和同一个价格。
正向地理编码 API
GET /v1/forward 端点发送一个地址、地名或大致描述，即可获得坐标、规范化后的地址及其各个组成部分。
详情和示例逆地理编码 API
GET /v1/reverse 端点发送纬度和经度，即可获得最近的地址，并分别列出城市、地区、邮政编码和国家。
详情和示例地址自动补全 API
GET /v1/autocomplete 端点在用户输入时推荐地址。每条建议都附带坐标，因此您很少需要第二次调用。
详情和示例IPv4 查询 API
GET /v1/ipv4 端点任意 IPv4 地址的国家、地区、城市、坐标、时区和网络所有者；如果不提供地址，则返回调用方的信息。
详情和示例IPv6 查询 API
GET /v1/ipv6 端点为 IPv6 地址提供同样的详细信息，另外还包括该地址所属的已宣告前缀。
详情和示例时区查询 API
GET /v1/timezone 端点任意坐标的 IANA 时区名称、UTC 偏移量、夏令时状态和当地时间，可以是当前时间，也可以是您选择的时间戳。
详情和示例海拔查询 API
GET /v1/elevation 端点一个点的海拔高度（以米为单位），或在一次调用中查询最多 100 个点。
详情和示例邮政编码查询 API
GET /v1/postcode 端点将邮政编码转换为地名、地区和坐标。适用于大多数国家的 ZIP 码、邮政编码及其对应形式。
详情和示例它们的共同点
相同的外层结构
每个响应都有一个顶层 status，值为 ok 或 error。错误会带有机器可读的 code 和一句可以记录到日志中的说明。坐标始终以十进制度数表示，位于 lat 和 lon 中。
处处相同的规则
任何地址无需密钥每天都有 2,500 次免费请求。每个密钥每天有各自的 2,500 次免费请求（与来自同一网络的无密钥请求共享），之后使用预付额度或 Unlimited 套餐。按量付费密钥在每个滚动的 24 小时内可服务两个 IP 地址，Unlimited 密钥可服务三个。请参阅身份验证。
相同的价格
一次逆地理编码与一次 IP 查询的费用相同：每个密钥每天前 2,500 次免费，之后每次从预付额度中扣除 €0.0001，或每月 €50 使用 Unlimited 密钥。请参阅价格。
怎样算一次请求
几乎所有情况都是一次调用算一次请求。例外是批量调用，批量中的每个条目单独计数。
| 端点 | 计为 |
|---|---|
| 正向地理编码、逆地理编码、邮政编码查询 | 每次调用计 1 次请求，无论返回多少个结果 |
| 地址自动补全 | 每次调用计 1 次请求。请在客户端对按键输入做防抖处理；SDK 会为您完成这一步 |
| IPv4 和 IPv6 查询 | 每次调用计 1 次请求，批量调用时每个地址计 1 次 |
| 时区查询 | 每次调用计 1 次请求 |
| 海拔查询 | 每个点计 1 次请求。包含 20 个点的调用计为 20 次 |
| 兼容替换主机（Google、Bing、HERE 等） | 规则与其背后对应的端点相同 |
| JavaScript 兼容替换：地图加载和瓦片 | 0。只有地理编码、自动补全和海拔调用才计数 |
暂未提供
路线规划、距离矩阵和等时线不属于本服务，今年也没有计划提供。按类别搜索兴趣点正在考虑之中。如果您需要其中某项功能才能迁移过来，请告诉我们；这有助于我们决定下一步构建什么。