fastapi-geolocation is a simple middleware package for FastAPI that provides geolocation features by integrating IP-based location lookup. This package is particularly useful for FastAPI applications that need to determine the geographical location of their users.
- Easy integration with FastAPI applications.
- Utilizes the GeoIP class from Django for location lookup.
- Provides an easy-to-use middleware that enriches requests with geolocation data.
To install fastapi-geolocation, run the following command:
pip install fastapi-geolocationHere is a simple example of how to use fastapi-geolocation in a FastAPI application:
import aioredis
from fastapi import FastAPI, Request
from fastapi_geolocation import GeoIPMiddleware
app = FastAPI()
redis_client = aioredis.from_url("redis://localhost", encoding="utf-8", decode_responses=True)
app.add_middleware(GeoIPMiddleware, redis_client=redis_client, license_key="mykey")
@app.get('/')
async def index(request: Request):
geo_data = request.state.geo
return {
'country': geo_data.country.name if geo_data else 'Unknown',
}To set up the middleware, you need to add it to your FastAPI application with the necessary parameters:
redis_client: An instance of aioredis client for caching purpose. license_key: Your MaxMind license key for the GeoIP database.
After adding the middleware to your FastAPI application, you can access the geolocation data in your route handlers using the request.state.geo property.
Contributions are welcome! If you would like to contribute to the project, please follow these steps:
Fork the repository. Create a new branch for your feature or fix. Write your code and add tests if applicable. Submit a pull request with a clear description of your changes.
fastapi-geolocation is open source software licensed as MIT.
This project was inspired by the GeoIP functionality in Django and has been adapted for use in FastAPI applications.