Geolocate
Georeferencing large amounts of data for free.
Special thanks to @brunodepauloalmeida and the whole team for the contributions.
How?
It's using the very same API that Waze uses to georeference addresses before it finds the best route to that destination. It requires no API keys, works really well and has fairly high throughput.
In order to make this package extensible, there's an abstract class GeolocateEngine that defines the interface for the engines. This allows for the addition of new engines without having to modify the code.
How do I use it?
First you have to install the geolocate package for Python 3.7+:
pip3 install geolocate
Then, for a single address:
>>> from geolocate import geolocate
>>> geolocate("1 Infinite Loop, Cupertino, CA 95014")
{'latitude': 37.3311841, 'longitude': -122.0287127}
Or, if you want to run things in parallel:
>>> from geolocate import geolocate_batch
>>> geolocate_batch(["1 Infinite Loop, Cupertino, CA 95014", "Eiffel Tower"])
100%|███████| 2/2 [00:01<00:00, 1.66it/s]
[{'latitude': 37.3311841, 'longitude': -122.0287127}, {'latitude': 48.8560934, 'longitude': 2.2930458}]
Advanced usage
Both geolocate and geolocate_batch accept the following keyword arguments:
- engine (
geolocate.engines.GeolocateEngine): Engine to use for geolocating the address. Defaults togeolocate.engines.WazeEngine - timeout (int): The timeout in seconds.
- tries (int): The number of attempts to geolocate the address.
- backoff_factor (float): The backoff factor. Delay will grow by
{backoff factor} * (2 ** ({number of total retries} - 1)). - on_not_found (str or callable): A callback function for when the address is not found. The signature of the callback function should be:
where
def callback(address: str): ...
addressis the address that was not found. The return value of the callback function is returned by the geolocate function. - on_error (str or callable): A callback function for when an error occurs. The signature of the callback function should be:
where
def callback(address: str, error: Exception): ...
addressis the address that caused the error anderroris the exception that occurred. The return value of the callback function is returned by the geolocate function.
In addition, the geolocate_batch function accepts the following keyword arguments:
- num_cpus (int): The number of CPUs to use. If None, the number of CPUs will be determined automatically.
![[pre-commit.ci] pre-commit autoupdate](https://avatars.githubusercontent.com/in/68672?v=4)
Vulnerable Library - requests-2.28.1-py3-none-any.whl
CVSS | Dependency | Type | Fixed in (requests version) | Remediation Available |
| ------------- | ------------- | ----- | ----- | ----- | ------------- | --- |
| 
Medium | 6.8 | certifi-2021.10.8-py2.py3-none-any.whl | Transitive | N/A* | ❌ |
10 Jun 8, 2021
153 Nov 16, 2022
1 Oct 25, 2021
0 May 9, 2022
2 Jul 22, 2022
2 Aug 8, 2022
88 Nov 27, 2022
222.5k Jan 2, 2023
7.9k Jan 2, 2023
77 Jan 8, 2023
3.5k Jan 3, 2023
33 Nov 21, 2022
964 Jan 8, 2023
1.6k Jan 5, 2023
16 Nov 9, 2022
1.5k Jan 9, 2023
10 Apr 17, 2022
159 Dec 12, 2022
3 Sep 8, 2021