Histórico da Página

Detalhamento do Recurso

Características

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

A primeira execução do serviço irá depender 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 parâmetro ACURACIA

Detalhamento do

Parâmetro

Acurácias permitidasPermitidas

• ROOFTOP - – Indica que o resultado retornado reflete um geocodigo 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 para , por exemplo, quando o local for um barracão na à beira de estradas, por exemplouma 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 costuma ter geram custos adicionais visto que normalmente , pois é realizada pelo próprio cliente. Contudo, porém é necessário analisar o modo de execução, e, em casos de alteração de acurácia, o modo é FULL deverá ser FULL + SFA.

Detalhamento de Execução

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

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

Caso queira deseje executar uma importação FULL dos locais novamente, basta incluir o parâmetro parâmetro MODO no no arquivo .bat ou .sh da importação. Os Valores 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 Na carga FULL + GOOGLE, os registros são inseridos na tabela tabela pontogpsarea,  que serve para controle do controlar o que já foi lido (para não gerar custos ao cliente mais de uma veza fim de evitar custos adicionais para o cliente devido a leituras repetidas). Nas tabelas tabelas pontogps e  e localarea, são inseridas informações mais específicas, como a latitude e a longitude, e é onde grava 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.