Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/d4v1-sudo/geolocation-geonames.txt-api

X,Y → 🗺️ - Python API to get nearest locations (Country, State, City, Road...) and more of a coordinate or informations about all results that includes the searched string using a Geonames txt file as database.
https://github.com/d4v1-sudo/geolocation-geonames.txt-api

geolocation geolocation-api geonames-api gps gps-coordinates latitude-and-longitude latitude-longitude latitude-longitude-finder trilateration

Last synced: 2 months ago
JSON representation

X,Y → 🗺️ - Python API to get nearest locations (Country, State, City, Road...) and more of a coordinate or informations about all results that includes the searched string using a Geonames txt file as database.

Awesome Lists containing this project

README 

        
# X,Y → 🗺️ - Geolocation-geonames.txt-API



This repository contains a set of Python scripts designed to facilitate the retrieval of geographic location information based on various parameters such as latitude and longitude coordinates, city names, country names, and state names, by applying **Haversine's formula**.



## Scripts



### gps.py



This script provides a comprehensive functionality to locate the **nearest geographic locations based on given latitude and longitude coordinates** (in decimal format). It calculates distances to the **closest populated place, road/railway, hill/mountain, lake, park, and building**. Additionally, it can determine the nearest administrative location (e.g., city, state) based on the provided coordinates.



### get_all_states-codes.py



This utility script extracts state information from geonames data and generates a Python file named `all_states_code.py`. It is employed internally by `gps.py`, `city-gps-location.py` and `state-gps-location.py` to retrieve corresponding name of a state based on its code.



### city-gps-location.py



This script enables users to find the coordinates of a specific city based on its name. It leverages geonames data to perform the city search.



### state-gps-location.py



This script enables users to find the coordinates of a specific state based on its name.



### country-gps-location.py



Users can utilize this script to find the coordinates of a specific country (it makes more sense using allCountries.txt of Geonames).



### all.py



To search for anything in the database, use the following input format: `x,y` for coordinates (in decimal format) or `'Any string'` for a string. If you search for a coordinate, the script will retrieve the nearest coordinate's location and its information. If the search is for a string, the script will retrieve all locations and their information from the database that contain this searched string.



### convert.py



This code provides functions to convert between decimal and sexagesimal representations of geographic coordinates (latitude and longitude).



To use it correctly:

1. Run the script.

   ```python3 convert.py <"-1" for decimal to sexagesimal or "-2" for sexagesimal to decimal>```

2. Follow the prompts:

   - For decimal to sexagesimal conversion, input latitude and longitude in decimal format (In the Southern hemisphere, use negative values for latitude, and in the Western hemisphere, use negative values for longitude). Example: `-15.7373` than `36.7289`

   - For sexagesimal to decimal conversion, input latitude and longitude in the specified sexagesimal format (N/S for latitude, and E/W for longitude). Example: `39º 42' 17'' N` than `22º 49' 52'' E`

3. The script will output the converted coordinates.



## Usage



1. Ensure that you have [Python 3.x installed on your system](https://www.python.org).

2. Download the geonames text files from [Geonames](https://www.geonames.org/export/dump) and place them in the repository directory, and change the `.txt` name file for your own country `.txt` database in each `.py` code you will use.

3. Run the desired Python script according to your location search requirements.

   ```python3 ```



## Requirements



- Python 3.x

- Geonames text files (downloaded from the Geonames website)



## Contributors



- [d4v1-sudo]



## Notes



- Remember, to use geographic coordinates in these python codes, decimal format is required. I made ```convert.py``` precisely for type compatibility issues, as my codes do not accept the sexagesimal system (XXº XX' XX'' N/S/E/W). Then use ```convert.py``` for testing and conversions.



- Feel free to contribute to this project by adding new features, fixing bugs, improving documentation, or addressing issues. Your contributions are highly appreciated!



- If you have any questions or suggestions, please don't hesitate to reach out.