Substituto compatível (drop-in) do Geocodio

O Geocodio se concentra nos Estados Unidos e no Canadá. geocodio.mygeocode.com responde aos seus endpoints geocode e reverse no mesmo formato e aceita endereços de qualquer lugar do mundo.

Troque um nome de host

Host original	`api.geocod.io`
Use no lugar	`geocodio.mygeocode.com`
Parâmetro da chave	`api_key` (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://api.geocod.io/v1.7/geocode?q=1109+N+Highland+St,+Arlington+VA&api_key=YOUR_GEOCODIO_KEY"

Depois

curl "https://geocodio.mygeocode.com/v1.7/geocode?q=1109+N+Highland+St,+Arlington+VA&api_key=YOUR_MYGEOCODE_KEY"

Por que as pessoas migram

A mesma interface, cobertura mundial e nenhuma faixa de preço por consulta para acompanhar.

A mesma cota gratuita, com ou sem chave. As requisições para geocodio.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 geocodio.mygeocode.com	O que faz	Baseado em
`/v1.7/geocode?q=...`	Geocodificação direta	Geocodificação direta
`/v1.7/reverse?q=lat,lng`	Geocodificação reversa	Geocodificação reversa
`/v1.7/geocode (POST, JSON array)`	Geocodificação direta em lote	Geocodificação direta

Exemplo de resposta

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

Resposta de geocodio.mygeocode.com

{
  "input": {
    "address_components": {
      "number": "1109",
      "predirectional": "N",
      "street": "Highland",
      "suffix": "St",
      "formatted_street": "N Highland St",
      "city": "Arlington",
      "state": "VA",
      "country": "US"
    },
    "formatted_address": "1109 N Highland St, Arlington, VA"
  },
  "results": [
    {
      "address_components": {
        "number": "1109",
        "predirectional": "N",
        "street": "Highland",
        "suffix": "St",
        "formatted_street": "N Highland St",
        "city": "Arlington",
        "county": "Arlington County",
        "state": "VA",
        "zip": "22201",
        "country": "US"
      },
      "formatted_address": "1109 N Highland St, Arlington, VA 22201",
      "location": { "lat": 38.886665, "lng": -77.094733 },
      "accuracy": 1,
      "accuracy_type": "rooftop",
      "source": "My Geocode"
    }
  ]
}

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 Geocodio: o parâmetro de consulta api_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.

Requisições em lote funcionam: envie uma lista JSON ou um objeto. A resposta é results com uma entrada por item enviado, cada uma trazendo a query de onde veio (a chave do objeto, quando você enviou um objeto) e a sua própria response.
Lotes reversos têm o mesmo formato, com strings lat,lon como entrada.
Um lote aceita até 10.000 entradas, como o Geocodio, e cada entrada conta como uma consulta, da mesma forma que o Geocodio conta. Um lote maior do que o que resta da cota do dia é recusado por inteiro com o erro do Geocodio, em vez de ser processado em parte.

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.