Pular para o conteúdo principal

DistanciaEntreEnderecos

atenção

Gerado por Inteligência Artificial.

Visão Geral​

Este método calcula a distância entre dois endereços, a partir dos seus respectivos IDs de rua e números. Ele utiliza serviços auxiliares para fazer requisições a APIs externas, interpretar as respostas e extrair informações relevantes sobre a distância e o tempo estimado entre os pontos informados.

BOX3_ERP_API\BOX3_ERP_API.Core\BLL\CEPBLL.cs
public async Task<DistanciaEntreEnderecosRetorno> DistanciaEntreEnderecos(int ruaOrigemId, int ruaDestinoId, string numeroOrigem = "", string numeroDestino = "")

Dependências Diretas​

MétodoLocalizaçãoLinha
GetRequestBOX3_ERP_API\BOX3_ERP_API.Core\Util\WebRequestUtil.cs65
DeserializeObjectBOX3_ERP_API\BOX3_ERP_API.Core\BLL\CEPBLL.cs506
FirstBOX3_ERP_API\BOX3_ERP_API.Core\BLL\CEPBLL.cs512
FirstBOX3_ERP_API\BOX3_ERP_API.Core\BLL\CEPBLL.cs513
FirstBOX3_ERP_API\BOX3_ERP_API.Core\BLL\CEPBLL.cs515
FirstBOX3_ERP_API\BOX3_ERP_API.Core\BLL\CEPBLL.cs516

Referências​

Método / EndpointLocalizaçãoLinha
AdicionarBOX3_ERP_API\BOX3_ERP_API.Core\Repositories\Implementations\TransladoRepository.cs117
AtualizarBOX3_ERP_API\BOX3_ERP_API.Core\Repositories\Implementations\TransladoRepository.cs246
CriarTransladoAbastecimentoBOX3_ERP_API\BOX3_ERP_API.Core\BLL\SolicitacaoAbastecimentoBLL.cs447
DetalhesTransladoMobilePorIdBOX3_ERP_API\BOX3_ERP_API\Controllers\MobileTranslados\TransladosMobileController.cs324
CriarTransladoBOX3_ERP_API\BOX3_ERP_API\Controllers\TransladoController.cs515
AdicionaDeliveryBOX3_ERP_API\BOX3_ERP_API\Controllers\VendaController.cs6352
AdicionaDeliveryBOX3_ERP_API\BOX3_ERP_API\Controllers\VendaController.cs6377

Detalhamento das Referências​

GetRequest​

Método que realiza a requisição HTTP para um serviço externo, responsável por recuperar os dados de distância e tempo entre os endereços informados.

DeserializeObject​

Método utilizado para desserializar o JSON retornado pela API externa, convertendo em um objeto de domínio utilizado no sistema.

First​

Método de extensão utilizado diversas vezes para obter o primeiro elemento de coleções retornadas nas respostas de API (normalmente linhas ou elementos da matriz de distância).

Adicionar / Atualizar​

Métodos do repositório de translados que, ao inserir ou atualizar translados, dependem da lógica de distância entre endereços para persistir informações corretas.

CriarTransladoAbastecimento​

Método que, ao criar um translado para abastecimento, utiliza o cálculo de distância entre endereços para gerar rotas e estimativas.

DetalhesTransladoMobilePorId​

Endpoint de API móvel que consulta detalhes de translados e utiliza o resultado de distância entre endereços para compor os dados apresentados ao usuário.

CriarTranslado​

Endpoint responsável pela criação de translados via API, que faz uso da lógica de cálculo de distância.

AdicionaDelivery​

Endpoints utilizados no contexto de vendas com delivery, que podem depender da distância para calcular taxas ou estimativas de entrega.

Impacto de Alterações​

Qualquer alteração neste método afeta diretamente as operações de cálculo de distância entre endereços, impactando funcionalidades de translado, delivery e abastecimento. Mudanças podem ocasionar falhas em cadastros, atualizações e na experiência do usuário ao exibir rotas, estimativas de tempo e custos baseados em distância.

Propagação de Mudanças​

  1. Todos os serviços de translado (criação, atualização, detalhamento) dependem do cálculo de distância entre endereços.
  2. Módulos de delivery, abastecimento e sepultamento podem apresentar inconsistências em rotas, estimativas ou valores se houver regressões nesta função.

Requisitos para Alteração Segura​

  • Garantir a integridade do retorno e compatibilidade com todos os consumidores do método.
  • Manter a integração e validar as respostas das APIs externas de cálculo de distância.
  • Realizar testes integrados em todos os pontos de uso, especialmente em cadastros, atualizações e consultas de translado e delivery.