The Python library makes it easy to consume the Baato API into existing python projects.
Baato Python can be installed from PyPI with tools like pip:
$ pip install baatoThe Baato Python client library makes it easy to integrate the Baato API into existing python projects. This package acts as a wrapper for the following Baato services:
After initializing Baato with your access token, the search() method can be used to make requests to the Search API.
from baato import BaatoClient
client = BaatoClient(access_token="YOUR_ACCESS_KEY")
"""Optional Initilization Parameters
- endpoint="https://api.baato.io/api" # default
- version="v1" # default
"""
response = client.search(q="kathmandu")
print(response["data"])
print(response["status"])
"""Optional Search Parameters
- lat and lon =>(float) latitude and longitude coordinates. Useful in mobile applications for providing geographical context to the search.
- type =>(str) The type or category of results that the request should return. For example: hospital, cafe etc.
- radius =>(int) Radius, in kilometers from the specified lat/lon pair within which to look for results. Only integer values supported. By default the value is set to 10.
- limit =>(int) The number of results that the request should return. By default the value is set to 5.
"""After initializing Baato with your access token, the reverse() method can be used to make requests to the Reverse Search API.
from baato import BaatoClient
client = BaatoClient(access_token="YOUR_ACCESS_KEY")
""" Optional Initilization Parameters
- endpoint="https://api.baato.io/api" # default
- version="v1" # default
"""
response = client.reverse(lat=27.70446921370009,lon=85.32051086425783)
print(response["data"])
print(response["status"])
"""Optional Reverse Parameters
- radius =>(int) A proxy variable for the inaccuracy, denoting how close around the coordinates should the algorithm look for potential address nodes.
- limit =>(int) The number of results to be returned; defaults to 1.
"""After initializing Baato with your access token, the places() method can be used to make requests to the Places API.
from baato import BaatoClient
client = BaatoClient(access_token="YOUR_ACCESS_KEY")
""" Optional Initilization Parameters
- endpoint="https://api.baato.io/api" # default
- version="v1" # default
"""
response = client.places(place_id=100006)
print(response["data"])
print(response["status"])After initializing Baato with your access token, the near_by() method can be used to make requests to the NearbyPlaces API.
from baato import BaatoClient
client = BaatoClient(access_token="YOUR_ACCESS_KEY")
""" Optional Initilization Parameters
- endpoint="https://api.baato.io/api" # default
- version="v1" # default
"""
response = client.near_by(lat=27.717245, lon=85.323959, type="school")
print(response["data"])
print(response["status"])
"""Here is the list for merged feature types:
- eat => Returns results for cafe, restaurant, bakery
- grocery => Returns results for department_store, supermarket
- tourism => Returns results for attraction, artwork, museum,park
- transport => Returns results for bus_stop, bus_station
- parking => Returns results for parking, bicycle_parking, underground,multi-storey, parking_space, car_parking
- shopping => Returns results for jewelry, sports, gift ,mall,department_store,hardware,kitchen, furniture
- children => Returns results for swimming_pool, playground, recreation_ground, park, water_park, disneyland
- night_life => Returns results for pub, bar, nightclub
- entertainment => Returns results for cinema, theatre, casino, nightclub
- clinic => Returns results for clinic, dentist, veterinary, herbalist, ayurvedic
- workshop => Returns results for metal, bicycle, aluminium, car_repair, tyres, car_parts
"""
"""Optional Near By Parameters
- radius =>(int) Radius, in kilometers from the specified lat/lon pair within which to look for results. Only integer values supported. By default the value is set to 10.
- limit =>(int) The number of results that the request should return. By default the value is set to 5.
"""After initializing Baato with your access token, the direction() method can be used to make requests to the Directions API.
from baato import BaatoClient
client = BaatoClient(access_token="YOUR_ACCESS_KEY")
""" Optional Initilization Parameters
- endpoint="https://api.baato.io/api" # default
- version="v1" # default
"""
response = client.direction(points=["27.71772,85.32784", "27.73449,85.33714"], mode="car")
print(response["data"])
print(response["status"])
"""Here is the availabe mode:
- car
- bike
- foot
"""
"""Optional Near By Parameters
- alternatives =>(boolen) enable alternatives by setting alternatives=true.
- instructions =>(boolen) enable instructions by setting instructions=true.After initializing Baato with your access token, the map_style() method can be used to make requests to the Map Styles API.
from baato import BaatoClient
client = BaatoClient(access_token="YOUR_ACCESS_KEY")
""" Optional Initilization Parameters
- endpoint="https://api.baato.io/api" # default
- version="v1" # default
"""
response = client.map_style(style_name="monochrome")
print(response["data"])
print(response["status"])
"""Here is the availabe style_name:
- monochrome
- breeze
- dark
- black_white
- roads
- retro
"""
Fork the repository
Once you have forked this repository to your own GitHub account, install your own fork in your development environment:
$ git clone git@github.com:<your_fork>/python-client.git
$ cd python-client$ pip install -r requirements.txtTest all supported versions You can also use the excellent tox testing tool to run the tests against all supported versions of Python. Install tox, and then simply run:
$ pip install toxIn the tox.ini file update your YOUR_BAATO_ACCESS_TOKEN then.
$ tox