{ "info": { "author": "\u0141ukasz Miko\u0142ajczak (Luqqk)", "author_email": "mikolajczak.luq@gmail.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 5 - Production/Stable", "License :: OSI Approved :: MIT License", "Programming Language :: Python :: 3 :: Only", "Topic :: Scientific/Engineering :: GIS" ], "description": ".. image:: https://travis-ci.org/Luqqk/catchments.svg?branch=master\n :target: https://travis-ci.org/Luqqk/catchments\n\n.. image:: https://coveralls.io/repos/github/Luqqk/catchments/badge.svg\n :target: https://coveralls.io/github/Luqqk/catchments\n\n\ud83c\udf0d catchments\n=============\n\nPython wrapper for multiple APIs, that provide catchments-areas.\nIt allows to acquire and manipulate catchments from those APIs.\n\n.. image:: img/catchments.png\n :height: 400px\n :width: 400px\n :align: center\n :target: https://github.com/Luqqk/catchments/blob/master/img/catchments.png\n\nInstallation\n------------\n\n.. code-block:: bash\n\n $ pip install catchments\n\nUsage\n-----\n\nCurrently there are implemented two classes: **SkobblerAPI** and **HereAPI**.\n\nYou can use them as follows:\n\n.. code-block:: python\n\n >>> from catchments import SkobblerAPI\n\n >>> # get catchment from Skobbler API\n >>> skobbler = SkobblerAPI('your_api_key')\n >>> # if you don't provide params values default ones will be used\n >>> params = {\"range\": 600, \"highways\": 1}\n >>> catchment = skobbler.get_catchment({\"lat\" 52.05, \"lon\": 16.82}, **params)\n >>> {\"realReach\": {...} ...}\n >>> geojson = skobbler.catchment_as_geojson(catchment)\n >>> {\"type\": \"Feature\", geometry: {\"type\": \"Polygon\", ...}, ...}\n >>> skobbler.save_as_geojson(geojson)\n >>> 'SKOBBLER_52.05_16.82.geojson'\n\nAs you can see **.get_catchment** method uses **params** as second argument. Params keys names should be exactly the same\nas mentioned in APIs documentations, otherwise they will be ignored and default values will be used.\n\nParams supported by SKOBBLER and HERE:\n\n`SKOBBLER `_ (startMercator, response_type - not supported)\n\n`HERE `_\n\nYou can use also inbuilt command line scripts which accept \\*.csv file input with points as coordinates resource.\nScripts generate \\*.geojson files for every point in given \\*.csv file.\n\nExample \\*.csv file structure (name column is optional):\n\n+------------+------------+------------+ \n| name | lat | lon | \n+============+============+============+ \n| point1 | 52.0557 | 16.8278 | \n+------------+------------+------------+ \n| point2 | 52.4639 | 16.9410 | \n+------------+------------+------------+ \n\nExample command line script usage:\n\n.. code-block:: bash\n\n $ catchments-skobbler.py -k your_api_key -p path/to/file/with/points/*.csv\n\nAll scripts and their options are mentioned below:\n\n.. code-block:: bash\n\n $ catchments-skobbler.py\n\n* -k --key [REQUIRED] [DEFAULT: **None**]\n\n* -p --points [REQUIRED] [DEFAULT: **None**]\n\n* -r --range - [OPTIONAL] [DEFAULT: **600**]\n\n* -u --units - [OPTIONAL] [DEFAULT: **sec**]\n\n* -t --transport - [OPTIONAL] [DEFAULT: **car**]\n\n* -l --toll - [OPTIONAL] [DEFAULT: **0**]\n\n* -w --highways - [OPTIONAL] [DEFAULT: **0**]\n\n* -n --nonReachable - [OPTIONAL] [DEFAULT: **0**]\n\n.. code-block:: bash\n\n $ catchments-here.py\n\n* -i --app_id [REQUIRED] [DEFAULT: **None**]\n\n* -c --app_code [REQUIRED] [DEFAULT: **None**]\n\n* -r --range - [OPTIONAL] [DEFAULT: **600**]\n\n* -e --range-type - [OPTIONAL] [DEFAULT: **time**]\n\n* -m --mode - [OPTIONAL] [DEFAULT: **fastest;car;traffic:disabled**]\n\nTests\n-----\n\n.. code-block:: bash\n\n $ python setup.py test\n\nTODO\n----\n\n* Add support for Mapzen API catchments\n* Add support for OpenRouteService catchments\n* Add support for concurrent HTTP requests\n\n\n.. :changelog:\n\nRelease History\n---------------\n\n1.1.1 (2017-05-04)\n++++++++++++++++++\n\n* Split catchments-cls.py into separate scripts (one for each API)\n* Documentation\n\n1.0.0 (2017-05-01)\n++++++++++++++++++\n\n* Bug fixes, code reorganization\n* Better documentation\n\n0.9.1b (2017-03-11)\n+++++++++++++++++++\n\n* Required params validation in catchments-cls.py\n\n0.9.0b (2017-03-11)\n+++++++++++++++++++\n\n* Initial release (beta)\n\n\n", "description_content_type": null, "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "http://github.com/Luqqk/catchments", "keywords": "gis api catchments", "license": "MIT", "maintainer": "", "maintainer_email": "", "name": "catchments", "package_url": "https://pypi.org/project/catchments/", "platform": "", "project_url": "https://pypi.org/project/catchments/", "project_urls": { "Homepage": "http://github.com/Luqqk/catchments" }, "release_url": "https://pypi.org/project/catchments/1.1.1/", "requires_dist": [ "requests" ], "requires_python": "", "summary": "Python wrapper for multiple APIs, that provide catchments-areas", "version": "1.1.1" }, "last_serial": 2850138, "releases": { "0.9.0": [ { "comment_text": "", "digests": { "md5": "afb73c3cc37b073d7d09014065c66c10", "sha256": "5d4b2cf9f627df215ad38fc6714b23778fd5bdd3b7b14bd1abc72b49804bb80d" }, "downloads": -1, "filename": "catchments-0.9.0-py3-none-any.whl", "has_sig": false, "md5_digest": "afb73c3cc37b073d7d09014065c66c10", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 7800, "upload_time": "2017-03-11T19:00:01", "url": "https://files.pythonhosted.org/packages/77/b4/ac2d52ff8f57d21f3a010ee3f71d13c7f6bb1e596b62913e0683a4c966a5/catchments-0.9.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "d263a836718319a1ee7828944fe0e5c4", "sha256": "bd97142b2810209c5e73ec3979bdff3cb1590581f80f80779359c4c65c2c7fe0" }, "downloads": -1, "filename": "catchments-0.9.0.tar.gz", "has_sig": false, "md5_digest": "d263a836718319a1ee7828944fe0e5c4", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 5484, "upload_time": "2017-03-11T19:00:02", "url": "https://files.pythonhosted.org/packages/f5/90/8b53d782cbd3fb307319d6f919bd0356fe6729ff4ddf278ca0d8cebe9d87/catchments-0.9.0.tar.gz" } ], "0.9.1": [ { "comment_text": "", "digests": { "md5": "143115ef2402e11a34dc908cd20ef232", "sha256": "e938d7fc4fd5ad776af1f9002a641028b79978bbdd0876d603530eeb4ed6af68" }, "downloads": -1, "filename": "catchments-0.9.1-py3-none-any.whl", "has_sig": false, "md5_digest": "143115ef2402e11a34dc908cd20ef232", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 7904, "upload_time": "2017-03-11T19:45:25", "url": "https://files.pythonhosted.org/packages/49/46/270f1f663af07c9f6a769997d3bb509882ad68aa7ebfdb2c7af682b80677/catchments-0.9.1-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "bac00f0058ff62fce9cb93ce16d1e65b", "sha256": "498627d422338e4470623c9ffc43d2d15e25ef2bf37653705e13b36a37b45b42" }, "downloads": -1, "filename": "catchments-0.9.1.tar.gz", "has_sig": false, "md5_digest": "bac00f0058ff62fce9cb93ce16d1e65b", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 5546, "upload_time": "2017-03-11T19:45:26", "url": "https://files.pythonhosted.org/packages/03/3f/fb0d45b9a9f14102d740f0ad3eb58cc4017828fd472044c726adac1a456d/catchments-0.9.1.tar.gz" } ], "1.0.0": [ { "comment_text": "", "digests": { "md5": "f6d1eee25bf4b631061e441447d87e19", "sha256": "2accc8cb8cbd0b90b91db969677876b672daa6e9d62257a393f1dfa1ff13a476" }, "downloads": -1, "filename": "catchments-1.0.0-py3-none-any.whl", "has_sig": false, "md5_digest": "f6d1eee25bf4b631061e441447d87e19", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 9933, "upload_time": "2017-04-30T22:34:13", "url": "https://files.pythonhosted.org/packages/35/03/4b2dc782a12cefbd90fc89174dae100dd6d397a8c5bc49836ade9f818c76/catchments-1.0.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "394fd673d970ce1fba4811891a38b31c", "sha256": "679f9f07d61c132f64730e7cdff3d4c09ef1e6fb71332a8a20fc768dd5c180ee" }, "downloads": -1, "filename": "catchments-1.0.0.tar.gz", "has_sig": false, "md5_digest": "394fd673d970ce1fba4811891a38b31c", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 5877, "upload_time": "2017-04-30T22:34:14", "url": "https://files.pythonhosted.org/packages/33/ff/6387a5b8ed94639fe6a0a25d29225510c9f6862ba1478f46a517717c8b04/catchments-1.0.0.tar.gz" } ], "1.1.0": [ { "comment_text": "", "digests": { "md5": "5ddf160e822918f2b32c80673d273d82", "sha256": "0f3688ada03359fe8666a9d42cb314abd44619e123495a85ba9f5ce0cafbdd9b" }, "downloads": -1, "filename": "catchments-1.1.0-py3-none-any.whl", "has_sig": false, "md5_digest": "5ddf160e822918f2b32c80673d273d82", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 11079, "upload_time": "2017-05-03T22:11:21", "url": "https://files.pythonhosted.org/packages/87/03/06bfeb0fae020e2f61a29e915e2c91db6d58124fc5be89b1e242f167b195/catchments-1.1.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "3d9579e67a178b7c708d5d5a7f3c2383", "sha256": "2867b2163fe838806200029422cc4d328ebcb9d99064ecbf3fe1ccf548749583" }, "downloads": -1, "filename": "catchments-1.1.0.tar.gz", "has_sig": false, "md5_digest": "3d9579e67a178b7c708d5d5a7f3c2383", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 6041, "upload_time": "2017-05-03T22:11:23", "url": "https://files.pythonhosted.org/packages/67/ce/6c4a4d3eb2acac820051e4dff5ded55c26357bf000aa6f917e28f83bcecf/catchments-1.1.0.tar.gz" } ], "1.1.1": [ { "comment_text": "", "digests": { "md5": "289d11e9ac0b43b8ecf68c1c564177cc", "sha256": "c40db1833a3e254aac1f12caf38751c2892ba07dedbfca137c5a534fb8756b07" }, "downloads": -1, "filename": "catchments-1.1.1-py3-none-any.whl", "has_sig": false, "md5_digest": "289d11e9ac0b43b8ecf68c1c564177cc", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 11148, "upload_time": "2017-05-03T22:19:27", "url": "https://files.pythonhosted.org/packages/cf/e1/6720fc5cf920076e672eb96ede403b74b48b7544d54b9aba439d478127c2/catchments-1.1.1-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "ca61a3f1ed9f4c25230b83d475da85de", "sha256": "2fa6c5cf69ad24a61bc86c618549f5a17c084ac919dfeb805e3d074f0e8d4e49" }, "downloads": -1, "filename": "catchments-1.1.1.tar.gz", "has_sig": false, "md5_digest": "ca61a3f1ed9f4c25230b83d475da85de", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 6085, "upload_time": "2017-05-03T22:19:29", "url": "https://files.pythonhosted.org/packages/d4/68/77665773abb9162c817153c9729e8043169884b2a8c8a280d7e83d13f4e2/catchments-1.1.1.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "289d11e9ac0b43b8ecf68c1c564177cc", "sha256": "c40db1833a3e254aac1f12caf38751c2892ba07dedbfca137c5a534fb8756b07" }, "downloads": -1, "filename": "catchments-1.1.1-py3-none-any.whl", "has_sig": false, "md5_digest": "289d11e9ac0b43b8ecf68c1c564177cc", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 11148, "upload_time": "2017-05-03T22:19:27", "url": "https://files.pythonhosted.org/packages/cf/e1/6720fc5cf920076e672eb96ede403b74b48b7544d54b9aba439d478127c2/catchments-1.1.1-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "ca61a3f1ed9f4c25230b83d475da85de", "sha256": "2fa6c5cf69ad24a61bc86c618549f5a17c084ac919dfeb805e3d074f0e8d4e49" }, "downloads": -1, "filename": "catchments-1.1.1.tar.gz", "has_sig": false, "md5_digest": "ca61a3f1ed9f4c25230b83d475da85de", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 6085, "upload_time": "2017-05-03T22:19:29", "url": "https://files.pythonhosted.org/packages/d4/68/77665773abb9162c817153c9729e8043169884b2a8c8a280d7e83d13f4e2/catchments-1.1.1.tar.gz" } ] }