pyphoton 0.9.1

Install

pip install pyphoton

Usage

Python Photon client allows you to make queries to Photon easily.

from pyphoton import Photon


client = Photon()
location = client.query('berlin', limit=1)

print (location.city)
print (location.latitude)
print (location.longitude)

Photon object accepts two parameters:

• host: the url where Photon instance is running (default https://photon.komoot.de)

• language: the preferred language (default is en)

You can pass to the query method the following parameters along the query string:

• limit: limit number of results

• language: force language in the query

• latitude and longitude: use them to search with priority to a geo position

• location_bias_scale: use to search with location bias

Location object (or objects if you don’t set limit=1) is generated from the json returned and contains all the information you need: name, state, street, city, osm attributes, extent_from.latitude, extent_from.longitude, extent_to.latitude, extent_to.longitude …

If there’s an with your query, a PhotonException will be raised

from pyphoton import Photon
from pyphoton.errors import PhotonException


client = Photon()
try:
    location = client.query('', limit=1)
except PhotonException as ex:
    print (ex)

WIP Features

• Reverse search

• BBox search

• Method to fetch latest data

Run tests

pip install -r requirements-dev.txt
make test