Substituto compatível (drop-in) do LocationIQ

Os endpoints de busca, reverso, preenchimento automático e fuso horário do LocationIQ respondem em locationiq.mygeocode.com. O array JSON no estilo do Nominatim, com display_name, address e boundingbox, é retornado com o formato inalterado.

Troque um nome de host

Host original	`us1.locationiq.com` `eu1.locationiq.com`
Use no lugar	`locationiq.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://us1.locationiq.com/v1/search?key=YOUR_LOCATIONIQ_KEY&q=Sydney+Opera+House&format=json"

Depois

curl "https://locationiq.mygeocode.com/v1/search?key=YOUR_MYGEOCODE_KEY&q=Sydney+Opera+House&format=json"

Por que as pessoas migram

A mesma interface, 2.500 requisições gratuitas por dia por chave e uma chave Unlimited de valor fixo para aplicações com muito tráfego.

A mesma cota gratuita, com ou sem chave. As requisições para locationiq.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 locationiq.mygeocode.com	O que faz	Baseado em
`/v1/search?q=...&format=json`	Geocodificação direta	Geocodificação direta
`/v1/reverse?lat=...&lon=...&format=json`	Geocodificação reversa	Geocodificação reversa
`/v1/autocomplete?q=...`	Preenchimento automático	Preenchimento automático de endereços
`/v1/timezone?lat=...&lon=...`	Fuso horário	Consulta de fuso horário

Exemplo de resposta

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

Resposta de locationiq.mygeocode.com

[
  {
    "place_id": "mg.au.poi.3b7e91c0",
    "licence": "Data by My Geocode, https://www.mygeocode.com/terms/",
    "osm_type": "way",
    "osm_id": 4245932,
    "boundingbox": ["-33.8576", "-33.8560", "151.2141", "151.2166"],
    "lat": "-33.8567844",
    "lon": "151.2152967",
    "display_name": "Sydney Opera House, Bennelong Point, Sydney, New South Wales, 2000, Australia",
    "class": "tourism",
    "type": "attraction",
    "importance": 0.8543,
    "icon": "https://www.mygeocode.com/assets/img/icons/tourism.png",
    "address": {
      "name": "Sydney Opera House",
      "road": "Bennelong Point",
      "suburb": "Sydney",
      "city": "Sydney",
      "state": "New South Wales",
      "postcode": "2000",
      "country": "Australia",
      "country_code": "au"
    }
  }
]

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 LocationIQ: 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.

O endpoint de fuso horário está no ar e retorna o nome, o deslocamento, o indicador de horário de verão e os dois nomes.
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.