Substituto compatível (drop-in) do Geoapify

Os endpoints de geocodificação do Geoapify retornam FeatureCollections GeoJSON com um objeto properties plano. geoapify.mygeocode.com retorna o mesmo, incluindo os blocos rank e datasource, além do endpoint de informações de IP.

Troque um nome de host

Host original	`api.geoapify.com`
Use no lugar	`geoapify.mygeocode.com`
Parâmetro da chave	`apiKey` (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.geoapify.com/v1/geocode/search?text=Dam+1+Amsterdam&apiKey=YOUR_GEOAPIFY_KEY"

Depois

curl "https://geoapify.mygeocode.com/v1/geocode/search?text=Dam+1+Amsterdam&apiKey=YOUR_MYGEOCODE_KEY"

Por que as pessoas migram

O plano gratuito do Geoapify é de 3.000 créditos por dia, com atribuição obrigatória. Aqui são 2.500 requisições por dia por chave, sem exigência de atribuição, e o uso pago não tem faixa mensal da qual você precise sair.

A mesma cota gratuita, com ou sem chave. As requisições para geoapify.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 geoapify.mygeocode.com	O que faz	Baseado em
`/v1/geocode/search?text=...`	Geocodificação direta	Geocodificação direta
`/v1/geocode/reverse?lat=...&lon=...`	Geocodificação reversa	Geocodificação reversa
`/v1/geocode/autocomplete?text=...`	Preenchimento automático	Preenchimento automático de endereços
`/v1/ipinfo?ip=...`	Geolocalização de IP	Consulta de IPv4

Exemplo de resposta

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

Resposta de geoapify.mygeocode.com

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "properties": {
        "datasource": { "sourcename": "mygeocode", "attribution": "My Geocode", "license": "https://www.mygeocode.com/terms/" },
        "country": "Netherlands",
        "country_code": "nl",
        "state": "North Holland",
        "city": "Amsterdam",
        "postcode": "1012 JS",
        "street": "Dam",
        "housenumber": "1",
        "lon": 4.893604,
        "lat": 52.373119,
        "formatted": "Dam 1, 1012 JS Amsterdam, Netherlands",
        "address_line1": "Dam 1",
        "address_line2": "1012 JS Amsterdam, Netherlands",
        "result_type": "building",
        "rank": { "importance": 0.41, "confidence": 1, "confidence_city_level": 1, "confidence_street_level": 1, "match_type": "full_match" },
        "place_id": "mg.nl.addr.c21d40e8"
      },
      "geometry": { "type": "Point", "coordinates": [4.893604, 52.373119] },
      "bbox": [4.893004, 52.372719, 4.894204, 52.373519]
    }
  ],
  "query": {
    "text": "Dam 1 Amsterdam",
    "parsed": { "housenumber": "1", "street": "dam", "city": "amsterdam", "expected_type": "building" }
  }
}

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

As respostas trazem os campos que o Geoapify retorna e nada mais, então uma resposta pode ser usada em código que já interpreta o Geoapify. Nossos dados adicionais (altitude do terreno, ameaças e detalhes da rede) estão disponíveis sob solicitação: adicione mg_extras=1 à consulta ou envie X-MG-Extras: 1.

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 endpoint de IP retorna o próprio formato de objeto do Geoapify.
A geocodificação em lote funciona como a do Geoapify: POST /v1/batch/geocode/search ou /reverse com um array JSON de até 1.000 itens responde 202 com um id e uma url do job, e um GET nessa url retorna uma linha por item com a sua query. Cada endereço conta como uma requisição; a busca do resultado não conta nada.

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.