API de Correspondência de Mapa

A API Map Matching recebe coordenadas GPS brutas e alinha-as com a rede rodoviária real. Os casos de uso comuns incluem o rastreamento de frotas e a reprodução de atividades, a limpeza de ficheiros GPX de aplicações de ciclismo ou corrida, a verificação de que os veículos de entrega seguiram as rotas planeadas, e a reconstrução de viagens históricas para painéis de análise.

Os recetores GPS têm um erro de posição de 5 a 15 metros sob céu aberto, e muito mais em canyons urbanos ou sob a copa das árvores. As coordenadas brutas aparecem frequentemente fora da estrada, em faixas erradas, ou em ziguezague através de uma interseção. O map matching aplica um Modelo de Markov Oculto à rede rodoviária para encontrar o caminho estatisticamente mais provável, produzindo geometrias limpas e alinhadas às estradas adequadas para visualização e análise.

A API aceita um array ordenado de coordenadas GPS como pares de latitude e longitude, opcionalmente com marcas de tempo e valores de direção. As marcas de tempo melhoram a qualidade da correspondência em estradas com faixas de rodagem paralelas. O mínimo são 2 pares de coordenadas. Não existe um limite superior fixo no comprimento do percurso.

Cada segmento correspondido devolve um valor de confiança entre 0 e 1. Uma pontuação acima de 0,9 indica uma correspondência fiável. Pontuações abaixo de 0,7 significam tipicamente que o sinal GPS foi perdido, o percurso passou por uma área não mapeada, ou o veículo estava fora da estrada. Utilize segmentos de baixa confiança para sinalizar problemas de qualidade de dados ou desencadear revisão manual no seu pipeline.

Sim. A API devolve resultados correspondidos em milissegundos para comprimentos de percurso típicos, tornando-a adequada para atualizações de rastreamento de veículos em direto. Para telemetria de alta frequência (mais de 1 ponto por segundo), agrupe as coordenadas em janelas de 30 a 60 segundos antes de enviar, para manter o volume de pedidos gerível.

Não. O routing calcula uma rota entre dois pontos. O map matching reconstrói o caminho que foi efetivamente percorrido a partir de dados GPS registados. Utilize a API Directions quando pretender planear uma rota futura. Utilize a API Map Matching quando pretender compreender ou visualizar uma rota que já foi percorrida.