{ "info": { "author": "OpenCage Data Ltd", "author_email": "info@opencagedata.com", "bugtrack_url": null, "classifiers": [ "Environment :: Web Environment", "Intended Audience :: Developers", "License :: OSI Approved :: BSD License", "Operating System :: OS Independent", "Programming Language :: Python", "Programming Language :: Python :: 2", "Programming Language :: Python :: 2.6", "Programming Language :: Python :: 2.7", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.2", "Programming Language :: Python :: 3.4", "Topic :: Utilities" ], "description": "\n[![Build Status](https://travis-ci.org/OpenCageData/python-opencage-geocoder.svg?branch=master)](https://travis-ci.org/OpenCageData/python-opencage-geocoder)\n[![Kritika Analysis Status](https://kritika.io/users/freyfogle/repos/1769415496124133/heads/master/status.svg)](https://kritika.io/users/freyfogle/repos/1769415496124133/heads/master/)\n[![PyPI version](https://badge.fury.io/py/opencage.svg)](https://badge.fury.io/py/opencage)\n\n# OpenCage Data Geocoding Module for Python\n\nA Python module that uses [OpenCage Data's](https://opencagedata.com/) geocoder.\n\n## Usage\n\nInstall the module:\n\n```bash\npip install opencage\n```\n\nLoad the module:\n\n```python\nfrom opencage.geocoder import OpenCageGeocode\n```\n\nCreate an instance of the geocoder module, passing a valid OpenCage Data Geocoder API key\nas a parameter to the geocoder modules's constructor:\n\n```python\nkey = 'your-api-key-here'\ngeocoder = OpenCageGeocode(key)\n```\n\nPass a string containing the query or address to be geocoded to the modules's `geocode` method:\n\n```python\nquery = \"82 Clerkenwell Road, London\"\nresult = geocoder.geocode(query)\n```\n\nYou can add [additional parameters](https://opencagedata.com/api#forward):\n\n```python\nresult = geocoder.geocode('London', no_annotations=1, language='es')\n```\n\nYou can use the proximity parameter to provide the geocoder with a hint:\n\n```python\nresult = geocoder.geocode('London', proximity='42.828576, -81.406643')\nprint(result[0]['formatted'])\n# u'London, ON N6A 3M8, Canada'\n```\n\n\n### Reverse geocoding\n\nTurn a lat/long into an address with the ``reverse_geocode`` method:\n\n results = geocoder.reverse_geocode(51.51024, -0.10303)\n\n\n### Exceptions\n\nIf anything goes wrong, then an exception will be raised:\n * ``InvalidInputError`` for non-unicode query strings\n * ``UnknownError`` if there's some problem with the API (bad results, 500 status code, etc)\n * ``RateLimitExceededError`` if you go past your rate limit\n\n\n", "description_content_type": "text/markdown", "docs_url": null, "download_url": "https://github.com/OpenCageData/python-opencage-geocoder/tarball/1.1.6", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/OpenCageData/python-opencage-geocoder/", "keywords": "geocoding,geocoder", "license": "BSD", "maintainer": "", "maintainer_email": "", "name": "opencage", "package_url": "https://pypi.org/project/opencage/", "platform": "", "project_url": "https://pypi.org/project/opencage/", "project_urls": { "Download": "https://github.com/OpenCageData/python-opencage-geocoder/tarball/1.1.6", "Homepage": "https://github.com/OpenCageData/python-opencage-geocoder/" }, "release_url": "https://pypi.org/project/opencage/1.2/", "requires_dist": [ "Requests (>=2.2.0)", "six (>=1.4.0)" ], "requires_python": "", "summary": "Simple wrapper module for the OpenCage Geocoder API", "version": "1.2" }, "last_serial": 5379076, "releases": { "1.0.1": [], "1.1.0": [ { "comment_text": "", "digests": { "md5": "5bf8bc5b2c3150b62aa117c6db7a13f9", "sha256": "d91ecbaba89a01d23b7ec0ddb17d0a5ec4d2391e4dde313b28b9d9a89df2baa8" }, "downloads": -1, "filename": "opencage-1.1.0.tar.gz", "has_sig": false, "md5_digest": "5bf8bc5b2c3150b62aa117c6db7a13f9", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 3365, "upload_time": "2015-05-12T15:46:46", "url": "https://files.pythonhosted.org/packages/34/9e/4dce06b0b7f2e9b526495cfaa2c5206bb1a48858fa01676ba03106dd9eab/opencage-1.1.0.tar.gz" } ], "1.1.1": [ { "comment_text": "", "digests": { "md5": "ac2646536de502311c8787a6eb436035", "sha256": "f52418922d3f4d2b8f42b9ad432b737823872409464579cb5b378a58f33a8cc8" }, "downloads": -1, "filename": "opencage-1.1.1.tar.gz", "has_sig": false, "md5_digest": "ac2646536de502311c8787a6eb436035", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 3374, "upload_time": "2015-05-13T15:08:18", "url": "https://files.pythonhosted.org/packages/77/e1/5cf1c6655f19ec39667e03aeab098f979fe277284c6490b426c44ab4c53c/opencage-1.1.1.tar.gz" } ], "1.1.2": [], "1.1.3": [ { "comment_text": "", "digests": { "md5": "7d3ee62335b37dba291f938eea34228d", "sha256": "09f2bcbd838fe63ca57868a4af4ee6285171a3729d99d0bcd317657fc3cb6adb" }, "downloads": -1, "filename": "opencage-1.1.3.tar.gz", "has_sig": false, "md5_digest": "7d3ee62335b37dba291f938eea34228d", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 3538, "upload_time": "2015-06-29T16:51:39", "url": "https://files.pythonhosted.org/packages/ae/6d/3a095dee2c0f32bca0ff935025e4c467c967031b83a7422bcda99f157268/opencage-1.1.3.tar.gz" } ], "1.1.4": [ { "comment_text": "", "digests": { "md5": "298354a5c5e7dd2ea351245159078c70", "sha256": "efd960040a96f0600daeff96bcfb50b2794b3dfc5eb85e9180d47ccd487add0e" }, "downloads": -1, "filename": "opencage-1.1.4.tar.gz", "has_sig": false, "md5_digest": "298354a5c5e7dd2ea351245159078c70", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 3546, "upload_time": "2015-08-19T23:57:37", "url": "https://files.pythonhosted.org/packages/b0/1c/c879031e14df0ff712018ccc3aaf1e32710c1fbca6ef107f1817f595c349/opencage-1.1.4.tar.gz" } ], "1.1.6": [ { "comment_text": "", "digests": { "md5": "d18b3f8b3757d37d434d973d71dc755a", "sha256": "c2c2a84228fedd1dddfca8c819e412f28bb45adb5e5dc6c3d743abf512e26637" }, "downloads": -1, "filename": "opencage-1.1.6-py3-none-any.whl", "has_sig": false, "md5_digest": "d18b3f8b3757d37d434d973d71dc755a", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 5377, "upload_time": "2018-09-30T20:29:31", "url": "https://files.pythonhosted.org/packages/b3/1d/b62f20327fc0cc6e61d64748cbf92fefd1beab875090decb54ae190c6048/opencage-1.1.6-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "67966ff047bd691fe9a9a8f1e18b497c", "sha256": "fdb5a9f346ed354e4075d234a359c558c04fdce6df3de803babbce3ae1bb19e3" }, "downloads": -1, "filename": "opencage-1.1.6.tar.gz", "has_sig": false, "md5_digest": "67966ff047bd691fe9a9a8f1e18b497c", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4505, "upload_time": "2018-09-30T20:29:33", "url": "https://files.pythonhosted.org/packages/34/89/1b5818efcd5882bd4a299466937720541539a61b655f3530f1951b56ec34/opencage-1.1.6.tar.gz" } ], "1.2": [ { "comment_text": "", "digests": { "md5": "ad99e31921c459ee3d24539204afc0ff", "sha256": "20d97175f09b5b0e62ab9e0ba5c920c68235242d4c2c0b435d8cdbb2e2592dd2" }, "downloads": -1, "filename": "opencage-1.2-py3-none-any.whl", "has_sig": false, "md5_digest": "ad99e31921c459ee3d24539204afc0ff", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 5574, "upload_time": "2019-06-09T22:59:04", "url": "https://files.pythonhosted.org/packages/6d/f2/ed48d7e2fbd06f0ac8dbd511fecc233b68b523daccaae9fb1e6e56b240d4/opencage-1.2-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "f8a919256db9a43348ac87199c305830", "sha256": "a0511e0130de94575eda714ff459931d8e1799eeffd032eadb88dda9b84b4d0f" }, "downloads": -1, "filename": "opencage-1.2.tar.gz", "has_sig": false, "md5_digest": "f8a919256db9a43348ac87199c305830", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4658, "upload_time": "2019-06-09T22:59:06", "url": "https://files.pythonhosted.org/packages/4e/c8/e4d7a0c0b9653bb73467a7d622f606d78ecb0efc3e325b93620647413fad/opencage-1.2.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "ad99e31921c459ee3d24539204afc0ff", "sha256": "20d97175f09b5b0e62ab9e0ba5c920c68235242d4c2c0b435d8cdbb2e2592dd2" }, "downloads": -1, "filename": "opencage-1.2-py3-none-any.whl", "has_sig": false, "md5_digest": "ad99e31921c459ee3d24539204afc0ff", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 5574, "upload_time": "2019-06-09T22:59:04", "url": "https://files.pythonhosted.org/packages/6d/f2/ed48d7e2fbd06f0ac8dbd511fecc233b68b523daccaae9fb1e6e56b240d4/opencage-1.2-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "f8a919256db9a43348ac87199c305830", "sha256": "a0511e0130de94575eda714ff459931d8e1799eeffd032eadb88dda9b84b4d0f" }, "downloads": -1, "filename": "opencage-1.2.tar.gz", "has_sig": false, "md5_digest": "f8a919256db9a43348ac87199c305830", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4658, "upload_time": "2019-06-09T22:59:06", "url": "https://files.pythonhosted.org/packages/4e/c8/e4d7a0c0b9653bb73467a7d622f606d78ecb0efc3e325b93620647413fad/opencage-1.2.tar.gz" } ] }