My Geocode

Substituto compatível (drop-in) do Geocode.Farm

Os endpoints direto e reverso do Geocode.Farm, nos estilos de URL v3 e v4, respondem em farm.mygeocode.com. O objeto aninhado geocoding_results, com as seções STATUS, ACCOUNT, RESULTS e STATISTICS, é reproduzido para que os parsers existentes continuem funcionando.

Troque um nome de host

Host original
  • api.geocode.farm
  • www.geocode.farm
Use no lugarfarm.mygeocode.com
Parâmetro da chavekey (opcional: qualquer endereço recebe 2.500 requisições por dia sem chave; coloque aqui sua chave do My Geocode para crédito, pacotes e histórico de uso)
Antes
curl "https://www.geocode.farm/v3/json/forward/?addr=530+W+Main+St+Anoka+MN+55303&key=YOUR_FARM_KEY"
Depois
curl "https://farm.mygeocode.com/v3/json/forward/?addr=530+W+Main+St+Anoka+MN+55303&key=YOUR_MYGEOCODE_KEY"

Por que as pessoas migram

Se você começou no Geocode.Farm pelo plano gratuito, aqui você recebe 2.500 requisições gratuitas por dia por chave, com resultados em nível de número de casa em mais países. Veja a página de cobertura.

A mesma cota gratuita, com ou sem chave. As requisições para farm.mygeocode.com contam para as mesmas 2.500 requisições gratuitas por dia que o seu endereço, ou a sua chave, recebe nos nossos próprios endpoints. Acima disso, crédito pré-pago a € 0,0001 por requisição, ou € 50 por mês por uma chave Unlimited. Para se cadastrar, basta um endereço de e-mail.

Ver preços Obtenha uma chave grátis

Endpoints

Caminho em farm.mygeocode.comO que fazBaseado em
/forward/?addr=...Geocodificação direta, estilo v4Geocodificação direta
/reverse/?lat=...&lon=...Geocodificação reversa, estilo v4Geocodificação reversa
/v3/json/forward/?addr=...Geocodificação direta, estilo v3Geocodificação direta
/v3/json/reverse/?lat=...&lon=...Geocodificação reversa, estilo v3Geocodificação reversa

Exemplo de resposta

Isto é o que a requisição acima retorna. Nomes de campo, aninhamento e tipos seguem o Geocode.Farm. Só os dados por trás deles são nossos.

Resposta de farm.mygeocode.com (formato 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" }
  }
}

Detalhes e diferenças

Nenhuma chave é necessária para as primeiras 2.500 requisições por dia. Para usar uma chave do My Geocode, coloque-a onde ficava a sua chave do GeoCode Farm: o parâmetro de consulta key. O cabeçalho X-API-Key, Authorization: Bearer e a autenticação HTTP Basic (a chave como nome de usuário) também funcionam em todos os hosts, então bibliotecas cliente que se autenticam do próprio jeito continuam funcionando sem mudanças.

Linhas de copyright, nomes de licença e links de termos e privacidade na resposta são nossos, e não do provedor original. Todo o resto mantém o formato original.

  • O bloco LEGAL_COPYRIGHT traz o nosso aviso e os nossos links de termos e privacidade.
  • O bloco ACCOUNT informa a sua cota e o seu uso reais do dia.
  • Não há endpoint de lote, porque o original não tem. Para trabalho em massa, use POST /v1/forward ou /v1/reverse em api.mygeocode.com (até 100 por chamada, uma requisição cada).

Se o seu cliente depende de um campo ou comportamento que não está listado aqui, avise-nos. Lacunas de compatibilidade são corrigidas rapidamente porque costumam ser pequenas.

Outros hosts compatíveis

Como funcionam os hosts compatíveis, a visão geral e os substitutos para bibliotecas JavaScript.