Metadata-Version: 2.2
Name: coordinates2country
Version: 1.0.8
Summary: Fast reverse geocoding without internet connection
Home-page: https://github.com/yourusername/coordinates2country-python
Author: Abram Astle
Author-email: castle676767@gmail.com
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: Pillow
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# coordinates2country-py

A Python port of the excellent [coordinates2country](https://github.com/coordinates2country/coordinates2country) Java library.

What country is at a particular latitude/longitude? This Python library tells you quickly, without using the Internet and without requiring any permission.

- Fast reverse geocoding
- Never needs an Internet connection, not even the first time
- Less than 100kB

## Installation

```bash
pip install coordinates2country-py
```

## Usage

```python
from coordinates2country.coordinates2country import Coordinates2Country

c2c = Coordinates2Country()

# Get country name in English
print(c2c.country(50.1, 10.2))  # Output: Germany

# Get ISO country code
print(c2c.country_code(50.1, 10.2))  # Output: DE

# Get Wikidata QID
print(c2c.country_qid(50.1, 10.2))  # Output: 183
```
## Credits

This is a Python port of the coordinates2country Java library. All credit for the original implementation and data goes to the original authors.
