{
"info": {
"author": "Roman Yurchak",
"author_email": "roman.yurchak@symerio.com",
"bugtrack_url": null,
"classifiers": [
"Intended Audience :: Developers",
"Intended Audience :: Science/Research",
"License :: OSI Approved :: BSD License",
"Operating System :: POSIX",
"Operating System :: Unix",
"Programming Language :: Python",
"Programming Language :: Python :: 2",
"Programming Language :: Python :: 2.7",
"Programming Language :: Python :: 3",
"Programming Language :: Python :: 3.5",
"Programming Language :: Python :: 3.6",
"Programming Language :: Python :: 3.7",
"Topic :: Software Development"
],
"description": "pgeocode\n========\n\n|pypi| |rdfd| |travisci|\n\n.. |pypi| image:: https://img.shields.io/pypi/v/pgeocode.svg\n :target: https://pypi.org/project/pgeocode/\n\n.. |rdfd| image:: https://readthedocs.org/projects/pgeocode/badge/?version=latest\n :target: http://pgeocode.readthedocs.io/\n\n.. |travisci| image:: https://travis-ci.org/symerio/pgeocode.svg?branch=master\n :target: https://travis-ci.org/symerio/pgeocode\n\nPostal code geocoding and distance calculations\n\npgeocode is a Python library for high performance off-line querying of GPS coordinates, region name and municipality name\nfrom postal codes. Distances between postal codes as well as general\ndistance queries are also supported.\nThe used `GeoNames `_ database includes postal codes for 83 countries.\n\nCurrently, only queries within the same country are supported.\n\nFor additional documentation see `pgeocode.readthedocs.io `_.\n\n\nInstallation\n------------\n\npgeocode requires Python 2.7 or 3.5+ as well as ``numpy`` and ``pandas`` packages. It can be installed with,\n\n.. code::\n\n pip install pgeocode\n\nQuickstart\n----------\n\n**Postal code queries**\n\n.. code:: python\n\n >>> import pgeocode\n\n >>> nomi = pgeocode.Nominatim('fr')\n >>> nomi.query_postal_code(\"75013\")\n postal_code 75013\n country code FR\n place_name Paris 13\n state_name \u00cele-de-France\n state_code 11\n county_name Paris\n county_code 75\n community_name Paris\n community_code 751\n latitude 48.8322\n longitude 2.3561\n accuracy 5\n\n >>> nomi.query_postal_code([\"75013\", \"69006\"])\n postal_code place_name state_name latitude longitude\n 0 75013 Paris 13 \u00cele-de-France 48.8322 2.3561\n 1 69006 Lyon 06 Auvergne-Rh\u00f4ne-Alpes 45.7679 4.8506\n\n**Distance calculations**\n\n.. code:: python\n\n >>> dist = pgeocode.GeoDistance('fr')\n >>> dist.query_postal_code(\"75013\", \"69006\")\n 389.156\n >>> dist.query_postal_code([\"75013\", \"75014\", \"75015\"], [\"69006\", \"69005\", \"69004\"])\n array([ 389.15648697, 390.12577967, 390.49857655])\n\n\n\nGeocoding format\n----------------\n\nThe result of a geo-localistion query is a ``pandas.DataFrame`` with the following columns,\n\n* ``country code``: iso country code, 2 characters\n* ``postal code`` : postal code\n* ``place name`` : place name (e.g. town, city etc)\n* ``state_name`` : 1. order subdivision (state)\n* ``state_code`` : 1. order subdivision (state)\n* ``county_name`` : 2. order subdivision (county/province)\n* ``county_code`` : 2. order subdivision (county/province)\n* ``community_name`` : 3. order subdivision (community)\n* ``community_code`` : 3. order subdivision (community)\n* ``latitude`` : estimated latitude (wgs84)\n* ``longitude`` : estimated longitude (wgs84)\n* ``accuracy`` : accuracy of lat/lng from 1=estimated to 6=centroid\n\nLicense\n-------\n\nThe pgeocode package is distributed under the 3-clause BSD license.\n\n\nSupported countries\n-------------------\n\nThe list of countries available in the GeoNames database, with the corresponding country codes, are given below,\n\nAndorra (AD), Argentina (AR), American Samoa (AS), Austria (AT), Australia (AU), \u00c5land Islands (AX), Bangladesh (BD), Belgium (BE), Bulgaria (BG), Bermuda (BM), Brazil (BR), Belarus (BY), Canada (CA), Switzerland (CH), Colombia (CO), Costa Rica (CR), Czechia (CZ), Germany (DE), Denmark (DK), Dominican Republic (DO), Algeria (DZ), Spain (ES), Finland (FI), Faroe Islands (FO), France (FR), United Kingdom of Great Britain and Northern Ireland (GB), French Guiana (GF), Guernsey (GG), Greenland (GL), Guadeloupe (GP), Guatemala (GT), Guam (GU), Croatia (HR), Hungary (HU), Ireland (IE), Isle of Man (IM), India (IN), Iceland (IS), Italy (IT), Jersey (JE), Japan (JP), Liechtenstein (LI), Sri Lanka (LK), Lithuania (LT), Luxembourg (LU), Latvia (LV), Monaco (MC), Republic of Moldova (MD), Marshall Islands (MH), The former Yugoslav Republic of Macedonia (MK), Northern Mariana Islands (MP), Martinique (MQ), Malta (MT), Mexico (MX), Malaysia (MY), New Caledonia (NC), Netherlands (NL), Norway (NO), New Zealand (NZ), Philippines (PH), Pakistan (PK), Poland (PL), Saint Pierre and Miquelon (PM), Puerto Rico (PR), Portugal (PT), R\u00e9union (RE), Romania (RO), Russian Federation (RU), Sweden (SE), Slovenia (SI), Svalbard and Jan Mayen Islands (SJ), Slovakia (SK), San Marino (SM), Thailand (TH), Turkey (TR), Ukraine (UA), United States of America (US), Uruguay (UY), Holy See (VA), United States Virgin Islands (VI), Wallis and Futuna Islands (WF), Mayotte (YT), South Africa (ZA)\n\nSee `GeoNames database `_ for more information.\n\n\n",
"description_content_type": "",
"docs_url": null,
"download_url": "",
"downloads": {
"last_day": -1,
"last_month": -1,
"last_week": -1
},
"home_page": "",
"keywords": "",
"license": "BSD",
"maintainer": "",
"maintainer_email": "",
"name": "pgeocode",
"package_url": "https://pypi.org/project/pgeocode/",
"platform": "",
"project_url": "https://pypi.org/project/pgeocode/",
"project_urls": null,
"release_url": "https://pypi.org/project/pgeocode/0.1.2/",
"requires_dist": [
"requests",
"numpy",
"pandas"
],
"requires_python": "",
"summary": "Approximate geocoding",
"version": "0.1.2"
},
"last_serial": 5791292,
"releases": {
"0.1.0": [
{
"comment_text": "",
"digests": {
"md5": "7237afb50e8d7dadd1888ae8b459dc3a",
"sha256": "7268bb2ad923acd1c61ef3abb56edce93ea79d5bdb915d892352f107d6afbf4a"
},
"downloads": -1,
"filename": "pgeocode-0.1.0-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "7237afb50e8d7dadd1888ae8b459dc3a",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": null,
"size": 9077,
"upload_time": "2018-01-13T14:20:21",
"url": "https://files.pythonhosted.org/packages/04/5e/1ed7e78b75ddb0fb5836d1f97db187563be8ab3b2a7357722a1455a72d8c/pgeocode-0.1.0-py2.py3-none-any.whl"
},
{
"comment_text": "",
"digests": {
"md5": "887b45234903bac3f2ef898a3583d411",
"sha256": "63ea8cd014aec2f81f8926e8a53ccb6bbc84040b618ea8e2d42abd2c75ae3394"
},
"downloads": -1,
"filename": "pgeocode-0.1.0.tar.gz",
"has_sig": false,
"md5_digest": "887b45234903bac3f2ef898a3583d411",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 6391,
"upload_time": "2018-01-13T14:20:11",
"url": "https://files.pythonhosted.org/packages/a3/d6/ad883e28560c32e40300ebbb811149016d177c00a8a2611cd27c4ce464f6/pgeocode-0.1.0.tar.gz"
}
],
"0.1.1": [
{
"comment_text": "",
"digests": {
"md5": "a39d34fa9a5756425b012d792fa3ed65",
"sha256": "f4c42e952f4f11ddc3a0567687636fc5ddc0a1b80539615ef36a0a89fcc14551"
},
"downloads": -1,
"filename": "pgeocode-0.1.1-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "a39d34fa9a5756425b012d792fa3ed65",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": null,
"size": 9095,
"upload_time": "2018-11-08T21:50:23",
"url": "https://files.pythonhosted.org/packages/40/32/477ae060daf5a54a26caeb7c63901bb8c017c70fc8888c3073e29a11982e/pgeocode-0.1.1-py2.py3-none-any.whl"
},
{
"comment_text": "",
"digests": {
"md5": "8587bb31fcf3ccc526acfab79340a23e",
"sha256": "ac783c800bf40298397953faabcb77a1bc49543ceb59ece89b073bc5503588f4"
},
"downloads": -1,
"filename": "pgeocode-0.1.1.tar.gz",
"has_sig": false,
"md5_digest": "8587bb31fcf3ccc526acfab79340a23e",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 6386,
"upload_time": "2018-11-08T21:50:25",
"url": "https://files.pythonhosted.org/packages/9a/10/745608d3a433991019eb597e2ba510b7627ce3dbcb87f0f1de8fc70b6ad1/pgeocode-0.1.1.tar.gz"
}
],
"0.1.2": [
{
"comment_text": "",
"digests": {
"md5": "2452a8be0792c7cf93de300c1f7076b2",
"sha256": "00b3b25c0567d380fc57fd3268563185cb2f7944b5c1d794991ab99e83e98f97"
},
"downloads": -1,
"filename": "pgeocode-0.1.2-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "2452a8be0792c7cf93de300c1f7076b2",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": null,
"size": 7392,
"upload_time": "2019-09-06T09:45:23",
"url": "https://files.pythonhosted.org/packages/45/12/c02be61e117d19a43b3d2b804311eedf49c0158f446d5b0d52f259c4b0fb/pgeocode-0.1.2-py2.py3-none-any.whl"
},
{
"comment_text": "",
"digests": {
"md5": "85019532c21cc9b0a701b635370b4181",
"sha256": "e0abcebb0c85aafe1d126b5c2f5cc4a96acf14b4bbfb4252c0ee1ea03de38605"
},
"downloads": -1,
"filename": "pgeocode-0.1.2.tar.gz",
"has_sig": false,
"md5_digest": "85019532c21cc9b0a701b635370b4181",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 6616,
"upload_time": "2019-09-06T09:45:25",
"url": "https://files.pythonhosted.org/packages/f4/69/dbac4dacac1ffaf0f41f6930e30961b0ab1058546f4435979b09d5387d0e/pgeocode-0.1.2.tar.gz"
}
]
},
"urls": [
{
"comment_text": "",
"digests": {
"md5": "2452a8be0792c7cf93de300c1f7076b2",
"sha256": "00b3b25c0567d380fc57fd3268563185cb2f7944b5c1d794991ab99e83e98f97"
},
"downloads": -1,
"filename": "pgeocode-0.1.2-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "2452a8be0792c7cf93de300c1f7076b2",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": null,
"size": 7392,
"upload_time": "2019-09-06T09:45:23",
"url": "https://files.pythonhosted.org/packages/45/12/c02be61e117d19a43b3d2b804311eedf49c0158f446d5b0d52f259c4b0fb/pgeocode-0.1.2-py2.py3-none-any.whl"
},
{
"comment_text": "",
"digests": {
"md5": "85019532c21cc9b0a701b635370b4181",
"sha256": "e0abcebb0c85aafe1d126b5c2f5cc4a96acf14b4bbfb4252c0ee1ea03de38605"
},
"downloads": -1,
"filename": "pgeocode-0.1.2.tar.gz",
"has_sig": false,
"md5_digest": "85019532c21cc9b0a701b635370b4181",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 6616,
"upload_time": "2019-09-06T09:45:25",
"url": "https://files.pythonhosted.org/packages/f4/69/dbac4dacac1ffaf0f41f6930e30961b0ab1058546f4435979b09d5387d0e/pgeocode-0.1.2.tar.gz"
}
]
}