Detalhamento do Recurso
Caracteristicas
As caracteristicas referente esta a integração específica:
A primeira execução do serviço irá 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 kettle.properties no parâmetro ACURACIA
Detalhamento do parâmetro
Acurácias permitidas
- ROOFTOP - Indica que o resultado retornado reflete um geocodigo 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 quando o local for um barracão na beira de estradas, por exemplo).
- 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 (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 não costuma ter custos adicionais visto que normalmente é realizada pelo próprio cliente, porém é necessário analisar o modo de execução e em casos de alteração de acurácia, o modo é FULL + SFA.
Detalhamento de Execução
Para os casos em que não é encontrado o endereço, a integração busca novamente apenas se o endereço for alterado;
Importante lembrar que são preenchidos os pontos GPS em todos os locais, independentemente de tipo.
Caso queira executar uma importação FULL dos locais novamente, basta incluir o parâmetro MODO no 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, serve para controle do que já foi lido (para não gerar custos ao cliente mais de uma vez). Nas tabelas pontogps e localarea, são inseridas informações mais específicas, como a latitude longitude, e é onde grava os pontos de fato, com a acurácia configurada no kettle.properties.
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.