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.

Source Distribution

neshan-1.1.1.tar.gz (22.4 kB view hashes)

Uploaded source

Built Distribution

neshan-1.1.1-py3-none-any.whl (22.3 kB view hashes)

Uploaded py3

Supported by

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