Skip to main content

Python client library for Neshan maps

Project description

Python Client for Neshan Services

Build Status PyPI version


This library is a duplication of which is changed to work with Neshan APIs. Please open an issue if you have any questions.

The Python Client for Neshan Services is a Python Client library for the following Neshan APIs:

  • Directions API
  • Distance Matrix API
  • Reverse Geocoding API
  • Map Matching API
  • Search API


  • Python 3.5 or later.
  • A Neshan API key.


$ pip install -U neshan

Note that you will need requests 2.4.0 or higher if you want to specify connect/read timeouts.


This example uses the Geocoding API and the Directions API with an API key:

import neshan
from datetime import datetime

nmaps = neshan.Client(key='Add Your Key here')

# Look up an address with reverse geocoding
reverse_geocode_result = nmaps.reverse_geocode((40.714224, -73.961452))

# Request directions via public transit
now =
directions_result = nmaps.direction((36.268706, 59.610011),
                                    (36.287607, 59.599527),


Retry on Failure

Automatically retry when intermittent failures occur. That is, when any of the retriable 5xx errors are returned from the API.

Building the Project

# Installing nox
$ pip install nox

# Running tests
$ nox

# Generating documentation
$ nox -e docs

# Copy docs to gh-pages
$ nox -e docs && mv docs/_build/html generated_docs && git clean -Xdi && git checkout gh-pages

Documentation & resources

API docs



All notable changes to this project will be documented in this file.



  • Initial version

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for neshan, version 1.0.4
Filename, size File type Python version Upload date Hashes
Filename, size neshan-1.0.4-py3-none-any.whl (21.5 kB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size neshan-1.0.4.tar.gz (21.7 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page