Skip to main content

A tide storage tool and API.

Project description

A tool to acquire, store, and serve tide data. Designed to have pluggable backends for multiple tide services. So far NOAA is the only source.


Use pip to install from PyPI:

pip install django-tides

Add django_tides to your file:


Additional Requirements

beautifulsoup4 to parse the XML served by NOAA

django-tastypie to generate the API

GeoDjango is used to store point data for tide stations. I use PostGIS as my database backend.

Acquiring Data

django-tides comes with a management function:

./ update_tides

This will pull all tide data for all available backends. Use this with care as it will use a lot of bandwidth.


django-tides exposes two endpoints for now:


Provides the water level at a specific station over time. Example:



Provides a list of stations within proximity of a given point. Example:



Think this needs something else? To contribute to django-tides create a fork on Bitbucket. Clone your fork, make some changes, and submit a pull request.

Bugs are great contributions too! Feel free to add an issue on Bitbucket.

Project details

Release history Release notifications | RSS feed

This version


Download files

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

Files for django-tides, version 0.1
Filename, size File type Python version Upload date Hashes
Filename, size django-tides-0.1.tar.gz (7.0 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 Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page