Setor....................: Departamento de Implantação
Data.....................: 11/07/2025
Número da OT....: 000019/25
Documentação...: Paulo Rogerio Barrios
A partir dessa versão foi incluído mais uma "Forma de Taxa Entrega", sendo através da "DISTÂNCIA" conforme a figura 1, essa forma de entrega será responsável calcular a distância entre o estabelecimento até o endereço de entrega do cliente no qual solicitou um novo pedido no INPERA Delivery.
( Figura 1 - Forma de Taxa de Entrega INPERA Delivery )
Para utilizar essa nova funcionalidade é necessário seguir 4 requisitos:
1- Alterar a "Forma de Taxa Entrega" para "DISTÂNCIA".
2- Cadastrar um endereço com um CEP valido no cadastro de "Empresa".
3- Cadastrar a "Distancia de Entrega" informando a distancia inicial e final.
4- Habilitar a integração com API Google Maps, responsável por realizar o cálculo da distância.
Para cadastrar novas "Distancia de Entrega" basta acessar "Administração" ->> "Cadastro de Distâncias" conforme a figura 2, poderá visualizar a listagem do "Distâncias", nessa tela remover um ou mais registros, editar um registro já existente ou criar um novo registro conforme a figura 3.
( Figura 2 - Listagem de Distâncias )
Para cadastrar uma distância é necessário preencher todos os campos da figura 3.
( Figura 3 - Cadastro de Distâncias ).
No cadastro de "Empresa" informe o CEP do seu logradouro para que seja validado o mesmo via API, dessa forma o Google Maps poderá capturar o endereço de forma eficaz.
( Figura 4 - Cadastro de Empresa ).
Para gerar efetuar a integração com o Google Maps é necessário obter a KEY do mesmo, cada cliente deverá ter a sua própria KEY.
De acordo com a pesquisa efetuada no dia 30/03/2023 a plataforma Google Cloud disponibiliza um crédito mensal de US$ 200 sem custos financeiros para as APIs Google Maps, que equivale a 28.500 carregamentos de mapas por mês sem custos. Nos primeiros 90 dias o recebimento do crédito adicional é de US$ 300 para qualquer produto do Cloud que equivale a 42.750 carregamentos de mapas por mês.
Para mais informações pode acessar a URL da plataforma Google Maps onde tem todas as informações de forma atualizada de acordo com a política do Google Cloud:
https://mapsplatform.google.com/pricing/
É necessário ter uma conta no Google, caso não tenha uma conta acesse o link abaixo para criar:
https://www.google.com/intl/pt pt/gmail/about/
Para ativar recursos para uso do Google Maps API, acesse esse endereço:
https://cloud.google.com/maps-platform/
Logo após clique em "Primeiros Passos" conforme a figura 5. Caso não esteja conectado na sua conta do Google, você será direcionado a tela para fazer o login.
( Figura 5 - Plataforma Google Maps ).
Na Etapa 1, o Google solicitará que crie um breve cadastro para ter acesso aos recursos do mapa conforme a figura 6. Aceite os termos e clique em Continuar.
( Figura 6 - Habilitando Recursos do Google Maps ).
Na etapa 2, o Google irá solicitar as informações de pagamento conforme a figura 7 e figura 8. Então será necessário inserir o cartão como dados de pagamento para que o mesmo seja validado e seja possível dar continuidade no processo de criação.
( Figura 7 - Segunda Etapa do Processo de Ativação dos Recursos Google Maps ).
( Figura 8 - Inserindo Forma de Pagamento para Ativação dos Recursos ).
Quando clicar "INICIAR MINHA TESTE GRATUITO" pode ser que demore alguns minutos até que seja concluindo. Após iniciar seu teste grátis, aparecerá uma tela para responder algumas perguntas rápidas conforme a figura 9. Assim que respondê-las, clique em Enviar:
( Figura 9 - Questionário para Concluir Ativação de Recursos ).
Pronto! A chave foi criada com sucesso conforme a figura 10. Copie ela com o ícone no canto direito, ou usando Ctrl+C, guarde-a e clique em Criar uma demonstração:
( Figura 10 - Chave Key do Google Maps ).
Ao concluir sua inscrição, vá até "APIs" e verifique se elas estão ativadas. Caso sim, elas aparecerão como
"APIs ativadas", se nenhuma API estiver listada, é preciso ativar quatro APIs, necessárias para o funcionamento dos mapas:
1- Directions API
2- Geocoding API
3- Maps JavaScript API
4- Places API
Para ativa-las, basta clicar sobre cada uma delas e depois em "Ativar".
Com a chave KEY criada, acesse INPERA, menu "Administração" ->> "Integrações" e habilite a opção "Google Maps" conforme a figura 11.
( Figura 11 - Listagem de Integrações ).
Será exibido a tela para cadastro da integração conforme a figura 12, para dar continuidade preencha o campo "Maps API Key" com a chave KEY gerada, clique em salvar para concluir a integração com Google Maps no INPERA Delivery.
( Figura 12 - Cadastro de Integração Google Maps ).
Após ativar a integração com o "Google Maps" a forma de entrega via distância estará funcionando no INPERA Delivery conforme a figura 13, aonde retorna uma mensagem informando o raio de entrega do estabelecimento.
( Figura 13 - Entrega via Distância ).
Quando o cliente cadastrar um novo endereço conforme a figura 14, o mesmo já estará contabilizando a taxa de entrega de acordo com KM da distância cadastrada no INPERA.
( Figura 14 - Cadastro de Endereço INPERA Delivery ).
