46 lines
1.4 KiB
Python
46 lines
1.4 KiB
Python
"""Geolocation helpers for the Seasonal Clock"""
|
||
|
||
from typing import Tuple
|
||
|
||
from geopy.geocoders import Nominatim
|
||
from tzwhere import tzwhere
|
||
|
||
from . import __version__
|
||
|
||
|
||
def get_geolocator() -> Nominatim:
|
||
"""Get the geolocator service"""
|
||
|
||
return Nominatim(user_agent=f'gpolonkai-seasonal-clock/{__version__}')
|
||
|
||
|
||
def get_lat_long(country: str, city: str) -> Tuple[float, float]:
|
||
"""Get the latitude and longitude based on a country and a city name
|
||
|
||
This implicitly communicates with OpenStreetMap’s API and thus needs a working Internet
|
||
connection."""
|
||
|
||
locator = get_geolocator()
|
||
geolocation = locator.geocode(f'{city}, {country}', addressdetails=True)
|
||
|
||
return geolocation.latitude, geolocation.longitude
|
||
|
||
|
||
def get_country_city(latitude: float, longitude: float) -> Tuple[str, str]:
|
||
"""Get the country and city names based on the coordinates
|
||
|
||
This implicitly communicates with OpenStreetMap’s API and thus needs a working Internet
|
||
connection."""
|
||
locator = get_geolocator()
|
||
geolocation = locator.reverse(f'{latitude}, {longitude}', addressdetails=True)
|
||
|
||
return geolocation.raw['address']['country'], geolocation.raw['address']['city']
|
||
|
||
|
||
def get_timezone(latitude: float, longitude: float) -> str:
|
||
"""Get the time zone based on the coordinates"""
|
||
|
||
tzlocator = tzwhere.tzwhere()
|
||
|
||
return tzlocator.tzNameAt(latitude, longitude)
|