# Photon Geocoder
## Overview
Photon Geocoder is a Python library designed to provide efficient and easy-to-use geocoding capabilities using OpenStreetMap data. It offers a robust solution for translating addresses into geographic coordinates and vice versa.
## Features
- Leverage OpenStreetMap data for accurate geocoding.
- Support for various geocoding queries, including address, city, and postal code lookups.
- Ability to filter results by specific OpenStreetMap tags.
- Asynchronous API for efficient network operations.
## Installation
To install Photon Geocoder, run the following command:
```
pip install photon-geocoder
```
## Usage
Here's a quick example of how to use Photon Geocoder:
```python
from photon_geocoder import PhotonGeocoder
# Create a geocoder instance
geocoder = PhotonGeocoder()
# Geocode an address
addresses = await geocoder.query("Brandenburg Gate, Berlin")
print(addresses)
```
## API Reference
The main class in Photon Geocoder is `PhotonGeocoder`. It provides the following methods:
- `query(address, layers=None, osm_tags=None, limit=10)`: Performs a geocoding query.
## Contributing
Contributions to Photon Geocoder are welcome! Please read our contribution guidelines for more information on how to contribute.
## License
Photon Geocoder is licensed under the [MIT License](LICENSE).
Raw data
{
"_id": null,
"home_page": "https://github.com/binoalien/photon-geocoder",
"name": "photon-geocoder",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "",
"keywords": "geocoding,OSM,OpenStreetMap,address,mapping",
"author": "binoalien",
"author_email": "",
"download_url": "https://files.pythonhosted.org/packages/b2/72/b7fe349ea6fa035509397ec2ea34f0189ed749ae5ee8f8c50c0120e4b97e/photon_geocoder-1.0.0.tar.gz",
"platform": null,
"description": "# Photon Geocoder\n\n## Overview\nPhoton Geocoder is a Python library designed to provide efficient and easy-to-use geocoding capabilities using OpenStreetMap data. It offers a robust solution for translating addresses into geographic coordinates and vice versa.\n\n## Features\n- Leverage OpenStreetMap data for accurate geocoding.\n- Support for various geocoding queries, including address, city, and postal code lookups.\n- Ability to filter results by specific OpenStreetMap tags.\n- Asynchronous API for efficient network operations.\n\n## Installation\nTo install Photon Geocoder, run the following command:\n\n```\npip install photon-geocoder\n```\n\n## Usage\nHere's a quick example of how to use Photon Geocoder:\n\n```python\nfrom photon_geocoder import PhotonGeocoder\n\n# Create a geocoder instance\ngeocoder = PhotonGeocoder()\n\n# Geocode an address\naddresses = await geocoder.query(\"Brandenburg Gate, Berlin\")\nprint(addresses)\n```\n\n## API Reference\nThe main class in Photon Geocoder is `PhotonGeocoder`. It provides the following methods:\n- `query(address, layers=None, osm_tags=None, limit=10)`: Performs a geocoding query.\n\n## Contributing\nContributions to Photon Geocoder are welcome! Please read our contribution guidelines for more information on how to contribute.\n\n## License\nPhoton Geocoder is licensed under the [MIT License](LICENSE).\n",
"bugtrack_url": null,
"license": "",
"summary": "A Python wrapper for the Photon geocoder",
"version": "1.0.0",
"project_urls": {
"Homepage": "https://github.com/binoalien/photon-geocoder"
},
"split_keywords": [
"geocoding",
"osm",
"openstreetmap",
"address",
"mapping"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "9b5cb8adc24d32387702e469858327595dbd0893d724a35b399ba453ae2e41f0",
"md5": "8759ea0d550917b49b9a3c1bc584780a",
"sha256": "6e14879de7ff54f0132f6843cae4fb747e96b13258efae21612b9d0b49423437"
},
"downloads": -1,
"filename": "photon_geocoder-1.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "8759ea0d550917b49b9a3c1bc584780a",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 11788,
"upload_time": "2024-01-23T02:45:02",
"upload_time_iso_8601": "2024-01-23T02:45:02.612516Z",
"url": "https://files.pythonhosted.org/packages/9b/5c/b8adc24d32387702e469858327595dbd0893d724a35b399ba453ae2e41f0/photon_geocoder-1.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "b272b7fe349ea6fa035509397ec2ea34f0189ed749ae5ee8f8c50c0120e4b97e",
"md5": "06ba1f86a07ac9ec9729f4c85b85c25b",
"sha256": "b58902bb510eb9f0b49161c1ac12ee1a90877522cdcd411f87aadba1714fe857"
},
"downloads": -1,
"filename": "photon_geocoder-1.0.0.tar.gz",
"has_sig": false,
"md5_digest": "06ba1f86a07ac9ec9729f4c85b85c25b",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 10931,
"upload_time": "2024-01-23T02:45:04",
"upload_time_iso_8601": "2024-01-23T02:45:04.667683Z",
"url": "https://files.pythonhosted.org/packages/b2/72/b7fe349ea6fa035509397ec2ea34f0189ed749ae5ee8f8c50c0120e4b97e/photon_geocoder-1.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-01-23 02:45:04",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "binoalien",
"github_project": "photon-geocoder",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [
{
"name": "aiohttp",
"specs": []
},
{
"name": "pydantic",
"specs": []
},
{
"name": "levenshtein",
"specs": []
}
],
"lcname": "photon-geocoder"
}
JSON
