Substituto compatível (drop-in) do OpenCage

O OpenCage usa um único endpoint para geocodificação direta e reversa e retorna um bloco de anotações detalhado. opencage.mygeocode.com faz o mesmo, incluindo as anotações de fuso horário, moeda, código de discagem e no estilo what3words que os usuários do OpenCage leem.

Troque um nome de host

Host original	`api.opencagedata.com`
Use no lugar	`opencage.mygeocode.com`
Parâmetro da chave	`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.opencagedata.com/geocode/v1/json?q=Colosseum+Rome&key=YOUR_OPENCAGE_KEY"

Depois

curl "https://opencage.mygeocode.com/geocode/v1/json?q=Colosseum+Rome&key=YOUR_MYGEOCODE_KEY"

Por que as pessoas migram

A mesma requisição, o mesmo formato de resposta, 2.500 requisições gratuitas por dia por chave, sem exigência de atribuição nem cláusula de uso não comercial.

A mesma cota gratuita, com ou sem chave. As requisições para opencage.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 opencage.mygeocode.com	O que faz	Baseado em
`/geocode/v1/json?q=...`	Geocodificação direta	Geocodificação direta
`/geocode/v1/json?q=lat,lng`	Geocodificação reversa	Geocodificação reversa
`/geocode/v1/geojson?q=...`	Saída em GeoJSON	Geocodificação direta

Exemplo de resposta

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

Resposta de opencage.mygeocode.com

{
  "documentation": "https://www.mygeocode.com/compatibility/opencage/",
  "licenses": [ { "name": "My Geocode Terms", "url": "https://www.mygeocode.com/terms/" } ],
  "rate": { "limit": 2500, "remaining": 2483, "reset": 1756339200 },
  "results": [
    {
      "annotations": {
        "DMS": { "lat": "41° 53' 24.72'' N", "lng": "12° 29' 31.92'' E" },
        "callingcode": 39,
        "currency": { "iso_code": "EUR", "name": "Euro", "symbol": "€" },
        "flag": "🇮🇹",
        "timezone": { "name": "Europe/Rome", "now_in_dst": 1, "offset_sec": 7200, "offset_string": "+0200", "short_name": "CEST" }
      },
      "bounds": {
        "northeast": { "lat": 41.8905, "lng": 12.4932 },
        "southwest": { "lat": 41.8897, "lng": 12.4914 }
      },
      "components": {
        "ISO_3166-1_alpha-2": "IT",
        "ISO_3166-1_alpha-3": "ITA",
        "_category": "travel/tourism",
        "_type": "attraction",
        "attraction": "Colosseo",
        "city": "Roma",
        "continent": "Europe",
        "country": "Italia",
        "country_code": "it",
        "postcode": "00184",
        "road": "Piazza del Colosseo",
        "state": "Lazio"
      },
      "confidence": 9,
      "formatted": "Colosseo, Piazza del Colosseo, 00184 Roma RM, Italia",
      "geometry": { "lat": 41.8902, "lng": 12.4922 }
    }
  ],
  "status": { "code": 200, "message": "OK" },
  "total_results": 1
}

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 OpenCage: 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 rate informa a sua cota gratuita real, quanto resta e quando ela é reiniciada.
Os endpoints json e geojson são ambos atendidos.
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.