O Geoapify reúne geocodificação com APIs de rotas, locais e estilos de mapa sob um único parâmetro apiKey, o que atende equipes que querem uma só conta gerenciando vários recursos de localização ao mesmo tempo. As respostas de geocodificação seguem uma estrutura semelhante a GeoJSON, com um array features, em que cada item traz properties para os campos de endereço e geometry para as coordenadas.
Como o Geoapify cobre mais do que geocodificação, uma migração para fora dele raramente é tudo ou nada. Vale a pena ser deliberado quanto ao escopo: você vai mover todos os recursos de localização de uma vez ou apenas as chamadas de geocodificação, deixando rotas ou estilos de mapa no Geoapify por enquanto? As duas opções são razoáveis, mas levam a quantidades diferentes de trabalho, e misturá-las no meio de um projeto costuma gerar confusão sobre qual chave está autenticando qual requisição.
O My Geocode é uma API de geocodificação, IP, fuso horário, altitude e consulta de código postal, então é um substituto direto especificamente da parte de geocodificação de uma integração com o Geoapify. O host de compatibilidade com o Geoapify reproduz o array features e seus campos aninhados properties e geometry, alterando apenas o texto de copyright, termos e privacidade da resposta. Os detalhes dos campos estão em /compatibility/geoapify/.
Para as chamadas de geocodificação, migrar significa:
Apontar a requisição para o novo host em vez do host do Geoapify
Enviar uma chave do My Geocode em vez da apiKey do Geoapify, em qualquer um dos quatro estilos suportados que o seu cliente já use (X-API-Key, Authorization: Bearer, autenticação HTTP Basic ou parâmetro de consulta)
Deixar intacto o código que lê features[0].properties e features[0].geometry.coordinates
Se as consultas de rotas ou de locais continuarem no Geoapify por enquanto, nada muda nelas; o host de compatibilidade de geocodificação funciona de forma independente e não exige que o resto da sua stack seja migrado ao mesmo tempo.
Os preços são o ponto em que uma conta com serviços agrupados e uma sem agrupamento divergem na estrutura, e não apenas nos números. O My Geocode cobra o mesmo valor por todos os endpoints, incluindo todos os hosts de compatibilidade: 2.500 requisições gratuitas por dia 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. Não há um nível de preço separado para geocodificação e para outras consultas, o que simplifica as contas se mais tarde você decidir migrar mais partes de uma stack baseada no Geoapify.
Os extras opcionais (altitude do terreno, detalhes de ameaças de IP e informações de rede) estão disponíveis no host de compatibilidade de geocodificação adicionando mg_extras=1 ou um cabeçalho X-MG-Extras, o que vale a pena saber se parte do motivo de usar um provedor com serviços agrupados era obter mais de um tipo de dado em uma única chamada.
Migrar uma parte de uma conta com vários recursos é uma forma normal e gradual de reduzir a dependência de um único fornecedor, e não exige uma decisão definitiva sobre o resto da stack logo no primeiro dia.
Automações no-code construídas sobre uma etapa de geocodificação exigem uma abordagem de migração diferente da usada em código próprio. Veja como lidar com essa troca.
Trocar de fornecedor de dados de localização não é apenas uma decisão técnica. Veja o que revisar do lado do processamento de dados e da privacidade nessa mudança.
Desligar a chave de API de um provedor antigo cedo demais ou tarde demais traz riscos nos dois casos. Veja como aposentar credenciais corretamente quando uma migração estiver concluída.