O MapQuest Geocoding existe há tempo suficiente para que muitas integrações construídas sobre ele sejam anteriores a boa parte da onda atual de APIs de mapas. A chave, gerada por meio de uma conta de desenvolvedor do MapQuest, é enviada como parâmetro de consulta, e as respostas retornam um array results com um array locations aninhado, cada um trazendo um objeto latLng e uma estrutura de endereço detalhada com campos como adminArea5 para a cidade e postalCode para o CEP ou código postal.
Integrações tão antigas às vezes carregam um tipo particular de dívida técnica: o código que chama o MapQuest pode ter sido escrito por alguém que já não está na equipe, com comentários que mencionam decisões que ninguém se lembra de ter tomado. Isso não é motivo para evitar a migração, mas é motivo para testar a fundo em vez de presumir que o código existente é bem compreendido por quem está fazendo a migração agora.
O host compatível com MapQuest do My Geocode reproduz a estrutura dos arrays results e locations junto com os campos latLng e de endereço, mudando apenas os textos de copyright, termos e privacidade. Os detalhes completos estão em /compatibility/mapquest/. Na maioria dos casos, atualizar o host e a chave é toda a mudança: o padrão de acesso aninhado results[0].locations[0].latLng deve continuar retornando dados no mesmo formato.
Uma ordem sensata de etapas para uma integração mais antiga como esta:
A autenticação no novo lado aceita um cabeçalho X-API-Key, um cabeçalho Authorization: Bearer, autenticação HTTP Basic ou um parâmetro de consulta, então, seja qual for a forma como a antiga chave do MapQuest era enviada, há uma opção correspondente aqui.
Os preços são fixos e não exigem a escolha de um nível de conta: 2.500 requisições por dia gratuitas sem chave, mais 2.500 gratuitas por chave por dia, contadas por rede, e depois crédito pré-pago a € 0,0001 por requisição ou uma chave Unlimited a € 50 por mês. Todos os endpoints, incluindo este host compatível, custam o mesmo valor, o que elimina uma variável que contratos mais antigos às vezes traziam na forma de saltos de faixa baseados em volume.
Para uma integração com o MapQuest que continuou funcionando discretamente por anos sem muita atenção, o objetivo de uma migração como esta é mantê-la igualmente discreta depois: mesmo formato de resposta, mesmo código, um host e uma chave diferentes nos bastidores.