Substituto compatível (drop-in) do MapQuest Geocoding

Tanto o endpoint de geocodificação licenciado quanto o Open Data do MapQuest respondem em mapquest.mygeocode.com, com o envelope info, options e results e a nomenclatura adminArea1 a adminArea6 que os clientes do MapQuest interpretam.

Troque um nome de host

Host original	`www.mapquestapi.com` `open.mapquestapi.com`
Use no lugar	`mapquest.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://www.mapquestapi.com/geocoding/v1/address?key=YOUR_MAPQUEST_KEY&location=233+S+Wacker+Dr,+Chicago,+IL"

Depois

curl "https://mapquest.mygeocode.com/geocoding/v1/address?key=YOUR_MYGEOCODE_KEY&location=233+S+Wacker+Dr,+Chicago,+IL"

Por que as pessoas migram

O plano gratuito do MapQuest encolheu ao longo dos anos, e os seus planos para desenvolvedores são faixas mensais. Aqui você recebe 2.500 por dia de graça e, depois disso, preços por requisição ou fixos.

A mesma cota gratuita, com ou sem chave. As requisições para mapquest.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 mapquest.mygeocode.com	O que faz	Baseado em
`/geocoding/v1/address?location=...`	Geocodificação direta	Geocodificação direta
`/elevation/v1/profile?latLngCollection=lat,lng,lat,lng` (também `shapeFormat=cmp`/`cmp6`, `unit=m\|f`, POST JSON)	Perfil de altitude	Consulta de altitude
`/geocoding/v1/reverse?location=lat,lng`	Geocodificação reversa	Geocodificação reversa
`/geocoding/v1/batch?location=...&location=...`	Geocodificação em lote	Geocodificação direta

Exemplo de resposta

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

Resposta de mapquest.mygeocode.com

{
  "info": {
    "statuscode": 0,
    "copyright": { "text": "My Geocode", "imageUrl": "https://www.mygeocode.com/assets/img/logo.svg", "imageAltText": "My Geocode" },
    "messages": []
  },
  "options": { "maxResults": -1, "thumbMaps": false, "ignoreLatLngInput": false },
  "results": [
    {
      "providedLocation": { "location": "233 S Wacker Dr, Chicago, IL" },
      "locations": [
        {
          "street": "233 S Wacker Dr",
          "adminArea6": "Loop",
          "adminArea6Type": "Neighborhood",
          "adminArea5": "Chicago",
          "adminArea5Type": "City",
          "adminArea4": "Cook County",
          "adminArea4Type": "County",
          "adminArea3": "IL",
          "adminArea3Type": "State",
          "adminArea1": "US",
          "adminArea1Type": "Country",
          "postalCode": "60606",
          "geocodeQualityCode": "P1AAA",
          "geocodeQuality": "POINT",
          "dragPoint": false,
          "sideOfStreet": "R",
          "linkId": "0",
          "unknownInput": "",
          "type": "s",
          "latLng": { "lat": 41.878876, "lng": -87.635918 },
          "displayLatLng": { "lat": 41.878876, "lng": -87.635918 }
        }
      ]
    }
  ]
}

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 MapQuest: 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 perfil de altitude aceita latLngCollection como pares simples ou como um caminho comprimido cmp ou cmp6, em metros ou pés, por GET ou POST.
A geocodificação em lote funciona com parâmetros location= repetidos ou com uma lista locations enviada por POST, e responde com uma entrada por item enviado.
Um lote aceita até 100 locais e conta uma requisição por local, como o MapQuest.
Pontos sem dados informam uma altura de -32768, como o MapQuest.

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.