Address Coordinates API

This API has been developed with the specific intent of serving as a microservice within another project featured in my portfolio.

Technologies

Key technologies employed in the construction of this API include:

Flask
PyJWT
Pymongo (MongoDB)
Dotenv

Documentation

Regarding the available endpoints, you can view them in the Swagger documentation at this link

Requirements

To run this project, make sure you have the below software installed on your device

Python >= 3.10

Installation

On-premises installation

Clone the repository on your device
Go to the repository of the cloned project on your device
Create a virtual environment on your device and activate it (command for linux OS)

python -m venv venv

. venv/bin/activate

Install the libraries saved in the requirements.txt file, if you are using the PIP package manager you can use the following command

pip install -r requirements.txt

The last step is to define the settings, for this create a file named .env and define the parameters below

SECRET_KEY = ''
MONGO_URI = ''
GOOGLE_MAPS_SECRET_KEY = ''

The purpose of each parameter is described below

SECRET_KEY: This parameter defines a key for the project used for the purpose of creating and validating tokens for project users
MONGO_URI: Information for connecting mongoDB dataset, you can use your local mongoDB through compass or you can use online service
GOOGLE_MAPS_SECRET_KEY: Secret key to connect to Google's geocoding service, to create the key access this link

The final step is to run the application, to do this run the command below:

flask --app address run

Obtaining an API Key Token

To get an API key token, run the ApiKey.py file and enter the name you want to use as identification, it will print the JWT token at the prompt that you can use