Getting Started with OLA Maps Python package

July 11, 2024

This content originally appeared on DEV Community and was authored by Ayush

Recently OLA announced their new Maps platform and they’re giving it away for free for a year. If you’re planning to use it in your project, I’ve built a new Python package that makes it easy to integrate OLA Maps functionality into your Python projects. Let’s explore how to use this package.

Installation

First, install the package:

pip install olamaps

Authentication

Before you can use the OLA Maps API, you need to authenticate. The library supports two methods:

Using an API key:

import os
os.environ["OLAMAPS_API_KEY"] = "your_api_key"

# OR
client = Client(api_key="your_api_key_here")

Using client ID and client secret:

import os
os.environ["OLAMAPS_CLIENT_ID"] = "your_client_id"
os.environ["OLAMAPS_CLIENT_SECRET"] = "your_client_secret"

# OR
client = Client(client_id="your_client_id", client_secret="your_client_secret")

Basic Usage

Here’s how to use the main features of the library:

from olamaps import Client

# Initialize the client
client = Client()

# Geocode a text address
geocode_results = client.geocode("MG Road, Bangalore")

# Reverse geocode a latitude-longitude pair
reverse_geocode_results = client.reverse_geocode(
    lat=12.9519408,
    lng=77.6381845
)

# Get directions
directions_results = client.directions(
    origin="12.993103152916301,77.54332622119354",
    destination="12.972006793201695,77.5800850011884"
)

Conclusion

The olamaps library provides a simple way to integrate OLA Maps functionality into your Python projects. Whether you need to geocode addresses, reverse geocode coordinates, or get directions, this library has you covered.

Find this project on PyPI and on GitHub (Would love some )

Remember, this is an unofficial library and is not endorsed by OLA. Always make sure you comply with OLA’s terms of service when using their API.

Happy mapping!

This content originally appeared on DEV Community and was authored by Ayush

python