Geocode.Farm 兼容替换
Geocode.Farm 的正向和逆向端点，无论是 v3 还是 v4 的 URL 风格，都在 farm.mygeocode.com 上响应。包含 STATUS、ACCOUNT、RESULTS 和 STATISTICS 部分的嵌套 geocoding_results 对象被完整重现，因此现有解析器可以继续工作。
只需更换一个主机名
| 原始主机 |
|
|---|---|
| 改用 | farm.mygeocode.com |
| 密钥参数 | key（可选：任何地址不使用密钥每天也有 2,500 次请求；如需使用额度、套餐和使用记录，请在此填入您的 My Geocode 密钥） |
之前
curl "https://www.geocode.farm/v3/json/forward/?addr=530+W+Main+St+Anoka+MN+55303&key=YOUR_FARM_KEY"之后
curl "https://farm.mygeocode.com/v3/json/forward/?addr=530+W+Main+St+Anoka+MN+55303&key=YOUR_MYGEOCODE_KEY"端点
响应示例
这是上述请求返回的内容。字段名、嵌套和类型与 Geocode.Farm 一致。只有背后的数据来自我们。
来自 farm.mygeocode.com 的响应（v3 结构）
{
"geocoding_results": {
"LEGAL_COPYRIGHT": {
"copyright_notice": "Copyright My Geocode. All rights reserved.",
"copyright_logo": "https://www.mygeocode.com/assets/img/logo.svg",
"terms_of_service": "https://www.mygeocode.com/terms/",
"privacy_policy": "https://www.mygeocode.com/privacy/"
},
"STATUS": {
"access": "KEY_VALID, ACCESS_GRANTED",
"status": "SUCCESS",
"address_provided": "530 W Main St Anoka MN 55303",
"result_count": 1
},
"ACCOUNT": {
"ip_address": "203.0.113.24",
"distribution_license": "NONE, UNLICENSED",
"usage_limit": "2500",
"used_today": "17",
"used_total": "9120",
"first_used": "2026-03-02"
},
"RESULTS": [
{
"result_number": 1,
"formatted_address": "530 W Main St, Anoka, MN 55303, USA",
"accuracy": "EXACT_MATCH",
"ADDRESS": {
"street_number": "530",
"street_name": "W Main St",
"locality": "Anoka",
"admin_2": "Anoka County",
"admin_1": "MN",
"postal_code": "55303",
"country": "United States"
},
"LOCATION_DETAILS": {
"elevation": "268.4",
"timezone_long": "America/Chicago",
"timezone_short": "CDT"
},
"COORDINATES": { "latitude": "45.203146", "longitude": "-93.396711" },
"BOUNDARIES": {
"northeast_latitude": "45.203296",
"northeast_longitude": "-93.396461",
"southwest_latitude": "45.202996",
"southwest_longitude": "-93.396961"
}
}
],
"STATISTICS": { "https_ssl": "ENABLED, SECURE" }
}
}细节与差异
每天前 2,500 次请求无需密钥。如需使用 My Geocode 密钥，请将其放在原来 GeoCode Farm 密钥的位置：key 查询参数。X-API-Key 请求头、Authorization: Bearer 和 HTTP Basic 认证（以密钥作为用户名）也适用于每个主机，因此以自有方式进行认证的客户端库无需任何修改即可继续工作。
响应中的版权声明、许可名称、条款和隐私链接是我们的，而不是原服务商的。其他所有内容都保持原有结构。
LEGAL_COPYRIGHT信息块包含我们的声明、条款和隐私链接。ACCOUNT信息块报告您当天真实的配额和用量。- 没有批量端点，因为原服务也没有。批量处理请使用
api.mygeocode.com上的POST /v1/forward或/v1/reverse（每次调用最多 100 条，每条计为一个请求）。
如果您的客户端依赖于此处未列出的字段或行为，请告诉我们。兼容性缺口通常很小，因此会很快修复。