geopy/geopy
Geopy
geopy is a Python geocoding library and geolocation client used to convert human-readable addresses into geographic coordinates and resolve coordinates back into street addresses using various third-party web services.
The library provides a consistent provider-based interface that abstracts multiple external geocoding services, allowing for interchangeable backends. It includes built-in request rate limiting and asynchronous client interfaces to manage API call frequency and execute concurrent lookups without halting execution.
Beyond geocoding, the project includes geospatial utilities for calculating the shortest distance between two points using spherical or ellipsoidal earth models. It also provides tools for coordinate formatting, such as converting decimal degrees to degrees-minutes-seconds, and performing geographic unit conversions.
Features
- Geocoding Services - Converts human-readable addresses or landmarks into latitude and longitude coordinates using various web services.
- Geocoding Libraries - Provides a comprehensive set of tools for converting human-readable addresses to geographic coordinates and vice versa via third-party services.
- Reverse Geocoding - Translates geographic coordinates into human-readable administrative names or street addresses.
- Reverse Geocoding Services - Turns geographic latitude and longitude coordinates back into human-readable street addresses via external providers.
- Geocoding API Clients - Implements specialized Python interfaces for executing asynchronous and throttled requests to multiple external geocoding providers.
- Driver-Based Provider Architectures - Uses a driver-based provider architecture to abstract multiple external geocoding services through a consistent API.
- Geodesic Calculations - Calculates the shortest path distance between two points on the earth's curved surface.
- Coordinate Distance Calculation - Computes the precise distance and shortest path between coordinates using spherical and ellipsoidal models.
- Ellipsoidal Distance Calculations - Computes high-precision distances between coordinates using ellipsoidal earth models.
- Geocoding Converters - Translates human-readable addresses or landmarks into geographic coordinates using web services.
- Bulk Processing - Manages large sets of location lookups with integrated rate limiting and retry logic.
- Asynchronous Geocoding Lookups - Provides non-blocking operations to handle multiple concurrent geolocation lookups efficiently.
- Client-Side Rate Limit Throttling - Implements client-side delay logic to prevent service providers from throttling requests during bulk operations.
- Asynchronous Processing - Utilizes non-blocking Python operations to execute multiple geolocation requests concurrently.
- API Adapters - Maps generic geocoding requests into the specific HTTP parameters and response formats required by different web APIs.
- Asyncio Coroutine Execution - Implements non-blocking I/O operations using Python's asyncio coroutines for concurrent network requests.
- Request Rate Limiting - Includes built-in mechanisms to manage outgoing API call frequency and implement retries to prevent service provider throttling.
- Geolocation - Geocoding toolbox.
- Geospatial Tools - Geocoding toolbox.
- Specialized Data Utilities - Geocoding addresses and calculating distances.
- Python Geospatial Libraries - Provides a client for geocoding web services.
