Skip to content

Latest commit

 

History

History
89 lines (54 loc) · 4.11 KB

README.md

File metadata and controls

89 lines (54 loc) · 4.11 KB

Companies by Google Maps

Programa utilizando a API Place e Geo do Google Maps para realizar extração de informações de empresas.

Requisitos

  • Ter Python instalado em seu computador

    Faça o download da versão mais atual do Python para seu sistema operacional no site oficial da linguagem python.org.

  • Ter o Git instalado em seu computador

    Faça o download da versão mais atual do GIT para seu sistema operacional no site oficial do Git.

  • Ter uma conta na Google e ativar as APIs Place e Geolocation.

    • Para ativar as APIs é necessário criar um projeto no Google Cloud, no menu lateral terá uma opção chamada "APIs e Serviços" depois basta pesquisas as APIs necessarias e depois ativa-las.
    • Assim que criar um projeto com as APIs será entregue uma API_KEY. Necessária para funcionamento do programa.

Instalação do programa.

  • Primeiro é necessário realizar um clone do repositório ou baixar diretamente do GitHub como pacote ZIP.

  • Para realizar o clone do repositório abra uma pasta em seu computador no qual deseja salvar os arquivos e acesse ela pelo CMD ou IDE de sua preferência utilizando o comando "CD" em seguida o caminho para sua pasta.

  • Exemplo:

    cd caminho/para/a/pasta

  • Após entrar na pasta rode o comando

    "git clone https://github.com/Donicad/Companies_by_Google_Maps"

  • E espere finalizar a clonagem do repositório.

  • Caso tenha baixado o repositório em ZIP pelo próprio GitHub, basta extrair o conteúdo na pasta onde deseja salvar os arquivos.

Após ter os arquivos salvos em sua máquina, acesse a pasta principal do repositório utilizando: "cd Companies_by_Google_Maps"

Feito isso basta instalar as Libs necessárias para o funcionamento do código. Para isso utilize o seguinte comando, uma vez dentro da pasta onde se encontra o código fonte.

    # Caso seu sistema operacional seja Linux, deverá utilizar "pip3" 

    pip install -r requirements.txt

Agora espere todas as dependências serem instaladas.

Após a instalação das dependências execute o código com o seguinte comando:

    # Caso seu sistema operacional seja Linux, deverá utilizar "python3"
    python contacts_maps.py

Com isso o programa será iniciado.

Funcionamento do Programa.

  • Quando for iniciado o script, um menu será exibido com opções de 1 a 4.

Explicações das opções.

OPÇÃO 01 - "Buscar Empresas”: essa é a principal opção, onde ao escolher ela primeiramente será verificada se existe uma API_KEY salva nas configurações, se caso houver, o programa vai pedir o nome de uma cidade, em seguida o raio de busca seguindo o centro da cidade que foi passada. Esse raio tem o limite de 50.000 metros.

OPÇÃO 02 - "Calcular Créditos Restantes”: aqui é possível realizar um cálculo para saber com quantos créditos gratuitos para uso a conta ainda possui, pois a google disponibiliza R$ 200,00 de créditos para usar nas requisições. - Para cada requisição feita usando o Place, é cobrado 0.032 centavos e para a Geo apenas 0.005 centavos.

  • No painel de Metricas. É possível verificar quantas solicitações para as APIs foram feitas.

Com essas informações ao iniciar a calculadora será pedido o número de solicitações da API place e depois da Geo. Por fim será calculado o valor gasto até o momento e o valor restante dos R$ 200,00.

OPÇÃO 03 - "Configurações”: Essa opção é para salvar a API KEY obtida no google cloud. Dentro dessa opção temos:

  • 1 - Salvar API_KEY
  • 2 - Exibir API_KEY
  • 3 - Editar API_KEY
  • 4 - Deletar API_KEY

Com sua KEY disponibilizada ao criar o projeto na google cloud será possível salvá-la em um arquivo .txt que será lida ao iniciar a OPÇÃO 01.

Esse programa tem o intuito apenas de facilitar a procura de empresas no Google Maps, use apenas os créditos gratuitos, caso o valor gratuito se esgote e você continuar ao usar a API um valor será cobrado da sua conta Google. Tenha cuidado.