Substituto compatível (drop-in) do OpenStreetMap Nominatim

A instância pública do Nominatim pede no máximo uma requisição por segundo e nenhum uso intenso. osm.mygeocode.com fala a mesma interface de busca e reversa, nos formatos JSON, JSONv2 e GeoJSON, com uma cota com a qual você realmente pode planejar.

Troque um nome de host

Host original	`nominatim.openstreetmap.org`
Use no lugar	`osm.mygeocode.com`
Parâmetro da chave	Nenhuma no original, e nenhuma necessária aqui também: qualquer endereço recebe 2.500 requisições por dia sem chave. Para crédito, pacotes e histórico de uso, adicione `key=...` à consulta ou envie o cabeçalho `X-API-Key`.

Antes

curl "https://nominatim.openstreetmap.org/search?q=Brandenburg+Gate+Berlin&format=json&addressdetails=1"

Depois

curl "https://osm.mygeocode.com/search?q=Brandenburg+Gate+Berlin&format=json&addressdetails=1"

Por que as pessoas migram

O servidor público do Nominatim é um recurso compartilhado com uma política de uso rígida. Manter o seu próprio é um trabalho de tempo integral. Esta é a mesma interface, sem nenhum dos dois problemas.

A mesma cota gratuita, com ou sem chave. As requisições para osm.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 osm.mygeocode.com	O que faz	Baseado em
`/search?q=...&format=json`	Busca em texto livre	Geocodificação direta
`/search?street=...&city=...&country=...&format=json`	Busca estruturada	Geocodificação direta
`/reverse?lat=...&lon=...&format=json`	Reversa	Geocodificação reversa

Exemplo de resposta

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

Resposta de osm.mygeocode.com

[
  {
    "place_id": 2384719,
    "licence": "Data by My Geocode, https://www.mygeocode.com/terms/",
    "osm_type": "way",
    "osm_id": 518071791,
    "lat": "52.5162746",
    "lon": "13.3777041",
    "class": "tourism",
    "type": "attraction",
    "place_rank": 30,
    "importance": 0.8317,
    "addresstype": "tourism",
    "name": "Brandenburger Tor",
    "display_name": "Brandenburger Tor, Pariser Platz, Mitte, Berlin, 10117, Deutschland",
    "address": {
      "tourism": "Brandenburger Tor",
      "road": "Pariser Platz",
      "suburb": "Mitte",
      "borough": "Mitte",
      "city": "Berlin",
      "state": "Berlin",
      "postcode": "10117",
      "country": "Deutschland",
      "country_code": "de"
    },
    "boundingbox": ["52.5161073", "52.5164414", "13.3775375", "13.3778623"]
  }
]

Detalhes e diferenças

O Nominatim não tem chave, e aqui também não é necessária para as primeiras 2.500 requisições por dia. Para crédito, pacotes e histórico de uso, adicione key=... à consulta ou envie o cabeçalho X-API-Key.

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.

/search responde em jsonv2 por padrão e /reverse responde em XML, seguindo os próprios padrões do Nominatim.
Os formatos xml, json, jsonv2, geojson e geocodejson são todos atendidos.
A linha de licença e o atributo de atribuição do XML são nossos.
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.