My Geocode

Geocode.Farm drop-in replacement

Geocode.Farm's forward and reverse endpoints, in both the v3 and v4 URL styles, answer at farm.mygeocode.com. The nested geocoding_results object with STATUS, ACCOUNT, RESULTS and STATISTICS sections is reproduced so existing parsers keep working.

Change one hostname

Original host
  • api.geocode.farm
  • www.geocode.farm
Use insteadfarm.mygeocode.com
Key parameterkey (optional: any address gets 2,500 requests a day with no key; put your My Geocode key here for credit, packages and a usage history)
Before
curl "https://www.geocode.farm/v3/json/forward/?addr=530+W+Main+St+Anoka+MN+55303&key=YOUR_FARM_KEY"
After
curl "https://farm.mygeocode.com/v3/json/forward/?addr=530+W+Main+St+Anoka+MN+55303&key=YOUR_MYGEOCODE_KEY"

Why people move

If you started on Geocode.Farm for its free tier, you get 2,500 free requests a day per account here, with house-level results in more countries. See the coverage page.

Same free allowance, key or not. Requests to farm.mygeocode.com count toward the same 2,500 free requests a day your address, or your key, gets on our own endpoints. Above that, prepaid credit at €0.0001 per request, or €50 a month for an Unlimited key. Signing up takes a name and an email address, and no card.

See pricing Get a free key

Endpoints

Path on farm.mygeocode.comWhat it doesBacked by
/forward/?addr=...Forward geocoding, v4 styleForward geocoding
/reverse/?lat=...&lon=...Reverse geocoding, v4 styleReverse geocoding
/v3/json/forward/?addr=...Forward geocoding, v3 styleForward geocoding
/v3/json/reverse/?lat=...&lon=...Reverse geocoding, v3 styleReverse geocoding

Example response

This is what the request above returns. Field names, nesting and types follow Geocode.Farm. Only the data behind them is ours.

Response from farm.mygeocode.com (v3 shape)
{
  "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": 2
    },
    "ACCOUNT": {
      "ip_address": "203.0.113.24",
      "distribution_license": "NONE, UNLICENSED",
      "usage_limit": "2500",
      "used_today": "71",
      "used_total": "n/a",
      "first_used": ""
    },
    "RESULTS": [
      {
        "result_number": 1,
        "formatted_address": "530 W Main St, Anoka, MN 55303, United States",
        "accuracy": "EXACT_MATCH",
        "ADDRESS": {
          "street_number": "530",
          "street_name": "W Main St",
          "locality": "Anoka",
          "admin_1": "Minnesota",
          "postal_code": "55303",
          "country": "United States"
        },
        "LOCATION_DETAILS": {
          "elevation": 859.58,
          "timezone_long": "Central Standard Time",
          "timezone_short": "America/Chicago"
        },
        "COORDINATES": {
          "latitude": "45.2037629",
          "longitude": "-93.3992144"
        },
        "BOUNDARIES": {
          "northeast_latitude": "45.2042612",
          "northeast_longitude": "-93.3987161",
          "southwest_latitude": "45.2032634",
          "southwest_longitude": "-93.3997129"
        }
      },
      {
        "result_number": 2,
        "formatted_address": "530 E Main St, Anoka, MN 55303, United States",
        "accuracy": "HIGH_ACCURACY",
        "ADDRESS": {
          "street_number": "530",
          "street_name": "E Main St",
          "locality": "Anoka",
          "admin_1": "Minnesota",
          "postal_code": "55303",
          "country": "United States"
        },
        "LOCATION_DETAILS": {
          "elevation": 872.7,
          "timezone_long": "Central Standard Time",
          "timezone_short": "America/Chicago"
        },
        "COORDINATES": {
          "latitude": "45.1978895",
          "longitude": "-93.3825819"
        },
        "BOUNDARIES": {
          "northeast_latitude": "45.1983918",
          "northeast_longitude": "-93.3820824",
          "southwest_latitude": "45.1973901",
          "southwest_longitude": "-93.3830822"
        }
      }
    ],
    "STATISTICS": {
      "https_ssl": "ENABLED, SECURE"
    }
  }
}

Details and differences

No key is needed for the first 2,500 requests a day. To use a My Geocode key, put it where your GeoCode Farm key went: the key query parameter. The X-API-Key header, Authorization: Bearer and HTTP Basic authentication (the key as the user name) work on every host too, so client libraries that authenticate their own way keep working unchanged.

Copyright lines, licence names, terms and privacy links in the response are ours rather than the original provider’s. Everything else keeps the original shape.

  • The LEGAL_COPYRIGHT block carries our notice, terms and privacy links.
  • The ACCOUNT block reports your real quota and usage for the day.
  • No batch endpoint, because the original has none. For bulk work use POST /v1/forward or /v1/reverse on api.mygeocode.com (up to 100 per call, one request each).
  • LOCATION_DETAILS is filled in the way v3 wrote it: elevation in feet, the Windows time zone name as timezone_long and the IANA id as timezone_short.
  • The v3 XML paths answer too: /v3/xml/forward/ and /v3/xml/reverse/.

If your client depends on a field or behaviour that is not listed here, tell us. Compatibility gaps get fixed quickly because they are usually small.

Other drop-in hosts

How the drop-ins work, the overview, and the JavaScript library drop-ins.