v0.2.0

Breaking Changes 🚨

This release simplifies the API by renaming the main client class from GeocodioClient to Geocodio, making it more consistent with other Geocodio SDKs and easier to use.

Migration Guide

Update your imports:

# Old
from geocodio import GeocodioClient
client = GeocodioClient(api_key="...")

# New  
from geocodio import Geocodio
client = Geocodio(api_key="...")

What's Changed

• BREAKING: Renamed main client class from GeocodioClient to Geocodio for simplicity and consistency with other SDKs
  • All functionality remains the same
  • Only the class name has changed
  • Update imports and instantiation as shown above

Installation

pip install geocodio-library-python==0.2.0

Full Changelog

v0.1.0...v0.2.0

v0.1.0 - Initial Release

Initial Release 🎉

The first official release of the Python client library for the Geocodio API.

Features

• Forward geocoding for single addresses and batch operations (up to 10,000 addresses)
• Reverse geocoding for single coordinates and batch operations
• List API support for managing large batch jobs
• Field appending capabilities (census data, timezone, congressional districts, etc.)
• Comprehensive error handling with structured exception hierarchy
• Full test coverage with unit and end-to-end tests
• Support for Geocodio Enterprise API via hostname parameter
• Modern async-capable HTTP client using httpx
• Type hints and dataclass models for better IDE support
• GitHub Actions CI/CD pipeline for automated testing and publishing

Installation

pip install geocodio-library-python

Quick Start

from geocodio import GeocodioClient

client = GeocodioClient("YOUR_API_KEY")
response = client.geocode("1600 Pennsylvania Ave, Washington, DC")
print(response.results[0].formatted_address)

Full documentation available at https://www.geocod.io/docs/?python