Detalhamento do Recurso

Características

As características referentes a esta integração específica são:

A primeira execução do serviço dependerá do volume de locais do cliente;
As demais execuções enviam apenas os locais que tiverem alterações no endereço;
A integração solicita 50 locais por requisição para a API do Google;
O ponto sede só é gravado se a acurácia dele estiver parametrizada no arquivo kettle.properties no parâmetro ACURACIA

Detalhamento do Parâmetro

Acurácias Permitidas

• ROOFTOP – Indica que o resultado retornado reflete um geocódigo preciso. É o mais preciso de todos.
• RANGE_INTERPOLATED – Indica que o resultado retornado reflete uma aproximação (normalmente em uma estrada), interpolada entre dois pontos precisos (como interseções). Resultados interpolados geralmente são retornados quando códigos geográficos de rooftop não estão disponíveis para um endereço. É o segundo mais preciso (um pouco menos preciso que o rooftop, mas serve de referência, por exemplo, quando o local for um barracão à beira de uma estrada).
• GEOMETRIC_CENTER – Indica que o resultado retornado representa o centro geométrico de um objeto, como uma polilinha (por exemplo, uma rua) ou um polígono (uma região).
• APPROXIMATE – Indica que o resultado retornado será aproximado.

Obs.: Quando há mais de uma acurácia, a separação é feita por ponto e vírgula. Exemplo: ROOFTOP;RANGE_INTERPOLATED.

Esta configuração e alteração de parâmetros normalmente não geram custos adicionais, pois é realizada pelo próprio cliente. Contudo, é necessário analisar o modo de execução, e, em casos de alteração de acurácia, o modo deverá ser FULL + SFA.

Detalhamento de Execução

Para os casos em que o endereço não é encontrado, a integração realiza uma nova busca apenas se o endereço for alterado.

É importante lembrar que os pontos GPS são preenchidos em todos os locais, independentemente do tipo.

Caso deseje executar uma importação FULL dos locais novamente, basta incluir o parâmetro MODO no arquivo .bat ou .sh da importação. Os valores possíveis são: FULL | DELTA.

Parâmetros de MODO:

• FULL + GOOGLE = Executa a carga completa em registros que não foram importados para localarea.
  • É recomendado para a primeira carga, pois insere os registros na tabela pontogpsarea. Essa carga insere o retorno da API de todas as acurácias. É importanete lembrar que este modo normalmente gera custos adicionais, além de apagar as informações que foram inseridas na tabela pontogpsarea, inserindo novamente os dados, sendo assim é sugerido utilizá-lo apenas na primeira carga.
• FULL + SFA = Executa a carga completa a partir dos registros gravados no sfa, ideal quando alterada a acuracia.
  • Este modo olha para as informações que já foram inseridas na tabela pontogpsarea, alterando a acurácia dependendo do que foi configurado no kettle.properties. Indicado para casos onde, por exemplo, já foi feita a primeira carga (modo FULL + GOOGLE) com a acurácia ROOFTOP, mas como nem todos os registros foram encontrados com essa acurácia, o cliente solicitou para que seja recalculado com uma acurácia um pouco menor para esses casos onde não foi encontrado como ROOFTOP. Neste modo não gera custos adicionais.
• DELTA + GOOGLE = Executa apenas para registros novos ou alterados.
  • Ideal para utilizar no agendamento (após feita a primeira carga FULL).
• DELTA + SFA = Executa apenas para registros novos ou alterados a partir dos registros gravados na Aplicação TOTVS CRS SFA.

Obs.: Na carga FULL + GOOGLE, os registros são inseridos na tabela pontogpsarea, que serve para controlar o que já foi lido (a fim de evitar custos adicionais para o cliente devido a leituras repetidas). Nas tabelas pontogps e localarea, são inseridas informações mais específicas, como a latitude e a longitude, e é onde os pontos são de fato gravados, com a acurácia configurada no arquivo kettle.properties.

Mais informações

Para consultar documentações de apoio acesse o link: Google Maps Platform > Documentação > Web Services > Geocoding API

Para visualizar vídeo aula: Link interno de mídia

Para mais informações deste processo dentro da Aplicação SFA acesse a Página Planejamento de Rotas com Ponto GPS.