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:

  • Static Maps
  • 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.



  • and pypi package description



  • Static maps api



  • 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.1.1
Filename, size File type Python version Upload date Hashes
Filename, size neshan-1.1.1-py3-none-any.whl (22.3 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size neshan-1.1.1.tar.gz (22.4 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page