here-geocoding


Namehere-geocoding JSON
Version 0.3.0 PyPI version JSON
download
home_pagehttps://github.com/Mariosmsk/here_geocoding
SummaryThe "here-geocoding" package is a Python library designed to streamline the process of converting addresses stored in an Excel (xlsx) file into latitude and longitude coordinates. It provides a convenient solution for geocoding large sets of addresses using the HERE geocoding service.
upload_time2023-06-14 14:46:46
maintainer
docs_urlNone
authorMarios S. Kyriakou
requires_python>=3.6
licenseMIT license
keywords here_geocoding
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI
coveralls test coverage No coveralls. 
            ==============
here-geocoding
==============


.. image:: https://img.shields.io/pypi/v/here-geocoding.svg
        :target: https://pypi.python.org/pypi/here-geocoding

.. image:: https://readthedocs.org/projects/here-geocoding/badge/?version=latest
        :target: https://here-geocoding.readthedocs.io/en/latest/?version=latest
        :alt: Documentation Status

.. image:: https://pepy.tech/badge/here-geocoding
        :target: https://pepy.tech/badge/here-geocoding
        :alt: Downloads

.. image:: https://pepy.tech/badge/here-geocoding/month
        :target: https://pepy.tech/badge/here-geocoding
        :alt: Downloads


The "here-geocoding" package is a Python library designed to streamline the process of converting addresses stored in an Excel (xlsx) file into latitude and longitude coordinates. It provides a convenient solution for geocoding large sets of addresses using the HERE geocoding service.

The package is based on the: https://github.com/heremaps/here-location-services-python

* Free software: MIT license
* Documentation: https://here-geocoding.readthedocs.io.

How to install
---------------

**Environments -> base (root) -> open terminal -> pip install here-geocoding**

* pip install here-geocoding

Example
-------

Find the api key: https://platform.here.com/admin/apps/

.. code-block:: python
    
    from here_geocoding import geocoding

    api_key = 'YOUR API KEY'  # OK

    d = geocoding(api_key=api_key)

    # Example 1
    lng, lat = d.address_to_lnglat(address='1 Panepistimiou Ave., Aglantzia, 2109, Nicosia, Cyprus')
    print(lng, lat)

    # Example 2
    lng, lat = d.address_to_lnglat(address='Perikleous 94, Nicosia',
                                   bbox=[33.34597224, 35.13605854, 33.36261015, 35.14613025])
    print(lng, lat)

    # Example 3
    data_geojson = d.address_to_lnglat(address='1 Panepistimiou Ave., Aglantzia, 2109, Nicosia, Cyprus', geojson=True)
    print(data_geojson)
    
    # Example 4
    # using as example the csv file from: https://github.com/geocommons/geocoder/blob/master/test/data/address-sample.csv
    d.geocode_excel(file_path='address-sample.xlsx', start_row=-1, end_row=20, address_column='address', bbox=None,
                    to_crs=None, export_file_name='test', export_file_type='csv')

    # Example 5
    d.geocode_excel(file_path='address-sample.xlsx', start_row=-1, end_row=20, address_column='address', bbox=None,
                    to_crs=None, export_file_name='test', export_file_type='geojson')

Features
--------

* TODO

Credits
-------

This package was created with Cookiecutter_ and the `audreyr/cookiecutter-pypackage`_ project template.

.. _Cookiecutter: https://github.com/audreyr/cookiecutter
.. _`audreyr/cookiecutter-pypackage`: https://github.com/audreyr/cookiecutter-pypackage


=======
History
=======

0.1.0 (2023-06-09)
------------------

* First release on PyPI.

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/Mariosmsk/here_geocoding",
    "name": "here-geocoding",
    "maintainer": "",
    "docs_url": null,
    "requires_python": ">=3.6",
    "maintainer_email": "",
    "keywords": "here_geocoding",
    "author": "Marios S. Kyriakou",
    "author_email": "mariosmsk@gmail.com",
    "download_url": "https://files.pythonhosted.org/packages/4a/d1/f7bace84a939679ad9a0bc51164cc9151d650afb266331d42f993fff6a63/here_geocoding-0.3.0.tar.gz",
    "platform": null,
    "description": "==============\r\nhere-geocoding\r\n==============\r\n\r\n\r\n.. image:: https://img.shields.io/pypi/v/here-geocoding.svg\r\n        :target: https://pypi.python.org/pypi/here-geocoding\r\n\r\n.. image:: https://readthedocs.org/projects/here-geocoding/badge/?version=latest\r\n        :target: https://here-geocoding.readthedocs.io/en/latest/?version=latest\r\n        :alt: Documentation Status\r\n\r\n.. image:: https://pepy.tech/badge/here-geocoding\r\n        :target: https://pepy.tech/badge/here-geocoding\r\n        :alt: Downloads\r\n\r\n.. image:: https://pepy.tech/badge/here-geocoding/month\r\n        :target: https://pepy.tech/badge/here-geocoding\r\n        :alt: Downloads\r\n\r\n\r\nThe \"here-geocoding\" package is a Python library designed to streamline the process of converting addresses stored in an Excel (xlsx) file into latitude and longitude coordinates. It provides a convenient solution for geocoding large sets of addresses using the HERE geocoding service.\r\n\r\nThe package is based on the: https://github.com/heremaps/here-location-services-python\r\n\r\n* Free software: MIT license\r\n* Documentation: https://here-geocoding.readthedocs.io.\r\n\r\nHow to install\r\n---------------\r\n\r\n**Environments -> base (root) -> open terminal -> pip install here-geocoding**\r\n\r\n* pip install here-geocoding\r\n\r\nExample\r\n-------\r\n\r\nFind the api key: https://platform.here.com/admin/apps/\r\n\r\n.. code-block:: python\r\n    \r\n    from here_geocoding import geocoding\r\n\r\n    api_key = 'YOUR API KEY'  # OK\r\n\r\n    d = geocoding(api_key=api_key)\r\n\r\n    # Example 1\r\n    lng, lat = d.address_to_lnglat(address='1 Panepistimiou Ave., Aglantzia, 2109, Nicosia, Cyprus')\r\n    print(lng, lat)\r\n\r\n    # Example 2\r\n    lng, lat = d.address_to_lnglat(address='Perikleous 94, Nicosia',\r\n                                   bbox=[33.34597224, 35.13605854, 33.36261015, 35.14613025])\r\n    print(lng, lat)\r\n\r\n    # Example 3\r\n    data_geojson = d.address_to_lnglat(address='1 Panepistimiou Ave., Aglantzia, 2109, Nicosia, Cyprus', geojson=True)\r\n    print(data_geojson)\r\n    \r\n    # Example 4\r\n    # using as example the csv file from: https://github.com/geocommons/geocoder/blob/master/test/data/address-sample.csv\r\n    d.geocode_excel(file_path='address-sample.xlsx', start_row=-1, end_row=20, address_column='address', bbox=None,\r\n                    to_crs=None, export_file_name='test', export_file_type='csv')\r\n\r\n    # Example 5\r\n    d.geocode_excel(file_path='address-sample.xlsx', start_row=-1, end_row=20, address_column='address', bbox=None,\r\n                    to_crs=None, export_file_name='test', export_file_type='geojson')\r\n\r\nFeatures\r\n--------\r\n\r\n* TODO\r\n\r\nCredits\r\n-------\r\n\r\nThis package was created with Cookiecutter_ and the `audreyr/cookiecutter-pypackage`_ project template.\r\n\r\n.. _Cookiecutter: https://github.com/audreyr/cookiecutter\r\n.. _`audreyr/cookiecutter-pypackage`: https://github.com/audreyr/cookiecutter-pypackage\r\n\r\n\r\n=======\r\nHistory\r\n=======\r\n\r\n0.1.0 (2023-06-09)\r\n------------------\r\n\r\n* First release on PyPI.\r\n",
    "bugtrack_url": null,
    "license": "MIT license",
    "summary": "The \"here-geocoding\" package is a Python library designed to streamline the process of converting addresses stored in an Excel (xlsx) file into latitude and longitude coordinates. It provides a convenient solution for geocoding large sets of addresses using the HERE geocoding service.",
    "version": "0.3.0",
    "project_urls": {
        "Homepage": "https://github.com/Mariosmsk/here_geocoding"
    },
    "split_keywords": [
        "here_geocoding"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "4ad1f7bace84a939679ad9a0bc51164cc9151d650afb266331d42f993fff6a63",
                "md5": "160cecaa5607be743fe2cc1967d23c07",
                "sha256": "32ab2303d79c93f1f23393cea1fda6dcaec35fdf366c322c7c1dd5f93b73ad2a"
            },
            "downloads": -1,
            "filename": "here_geocoding-0.3.0.tar.gz",
            "has_sig": false,
            "md5_digest": "160cecaa5607be743fe2cc1967d23c07",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.6",
            "size": 25564,
            "upload_time": "2023-06-14T14:46:46",
            "upload_time_iso_8601": "2023-06-14T14:46:46.681017Z",
            "url": "https://files.pythonhosted.org/packages/4a/d1/f7bace84a939679ad9a0bc51164cc9151d650afb266331d42f993fff6a63/here_geocoding-0.3.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2023-06-14 14:46:46",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "Mariosmsk",
    "github_project": "here_geocoding",
    "travis_ci": true,
    "coveralls": false,
    "github_actions": false,
    "requirements": [],
    "lcname": "here-geocoding"
}
Marios S. Kyriakou
Elapsed time: 0.10207s