Substituto compatível (drop-in) do HERE Geocoding and Search

A HERE divide sua API de busca entre vários hosts. Todos eles se reúnem em here.mygeocode.com, que responde com o mesmo array items, o mesmo objeto address e o mesmo objeto position que os clientes da HERE leem.

Troque um nome de host

Host original	`geocode.search.hereapi.com` `revgeocode.search.hereapi.com` `autosuggest.search.hereapi.com` `autocomplete.search.hereapi.com`
Use no lugar	`here.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://geocode.search.hereapi.com/v1/geocode?q=Invalidenstra%C3%9Fe+116+Berlin&apiKey=YOUR_HERE_KEY"

Depois

curl "https://here.mygeocode.com/v1/geocode?q=Invalidenstra%C3%9Fe+116+Berlin&apiKey=YOUR_MYGEOCODE_KEY"

Por que as pessoas migram

A HERE cobra por transação, com compromissos mensais. Uma única troca de nome de host leva você a 2.500 chamadas gratuitas por dia por endereço, com ou sem chave, e a preços fixos ou por requisição depois disso.

A mesma cota gratuita, com ou sem chave. As requisições para here.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 here.mygeocode.com	O que faz	Baseado em
`/v1/geocode?q=...`	Geocodificação	Geocodificação direta
`/v1/geocode?qq=street=...;city=...`	Geocodificação com consulta qualificada	Geocodificação direta
`/v1/revgeocode?at=lat,lng`	Geocodificação reversa	Geocodificação reversa
`/v1/autosuggest?q=...&at=lat,lng`	Autosuggest	Preenchimento automático de endereços
`/v1/autocomplete?q=...`	Preenchimento automático	Preenchimento automático de endereços

Exemplo de resposta

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

Resposta de here.mygeocode.com

{
  "items": [
    {
      "title": "Invalidenstraße 116, 10115 Berlin, Deutschland",
      "id": "mg.de.addr.9a3f1c77",
      "resultType": "houseNumber",
      "houseNumberType": "PA",
      "address": {
        "label": "Invalidenstraße 116, 10115 Berlin, Deutschland",
        "countryCode": "DEU",
        "countryName": "Deutschland",
        "stateCode": "BE",
        "state": "Berlin",
        "countyCode": "B",
        "county": "Berlin",
        "city": "Berlin",
        "district": "Mitte",
        "street": "Invalidenstraße",
        "postalCode": "10115",
        "houseNumber": "116"
      },
      "position": { "lat": 52.53041, "lng": 13.38527 },
      "access": [ { "lat": 52.53039, "lng": 13.38533 } ],
      "mapView": { "west": 13.38393, "south": 52.52951, "east": 13.38661, "north": 52.53131 },
      "scoring": {
        "queryScore": 1.0,
        "fieldScore": { "city": 1.0, "streets": [1.0], "houseNumber": 1.0, "postalCode": 1.0 }
      }
    }
  ]
}

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 da HERE: o parâmetro de consulta apiKey (apikey também é aceito) ou um token Bearer. 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.

Os erros usam os campos title, status, code, cause e action da HERE, com um correlation id.
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.