v1.2.0

What's Changed

• Expose stable address keys on geocoding results by @imliam in #29

Full Changelog: v1.1.0...v1.2.0

v1.1.0

What's Changed

• Keep unmatched addresses in batch geocoding responses by @imliam in #28

Full Changelog: v1.0.0...v1.1.0

v1.0.0

Migrated to Geocodio API v2 (breaking).

• Default API version is now v2 (/v2).
• Removed the top-level input object from /geocode and /reverse responses; GeocodingResponse.input removed (use results[].address_components).
• Renamed AddressComponents fields: zip→postal_code, state→state_province; added unit_type/unit_number.
• Structured address input now accepts state_province (legacy state still works).

v0.7.0

• Updated default API version to v1.11
• Use Any type for district_number to accept whatever the API returns

v0.6.0

Changed

• Updated default API version from v1.9 to v1.10

Full Changelog: v0.5.1...v0.6.0

v0.5.1

Fixed

• Fixed parsing of state legislative district data (stateleg field). The API response key changed from stateleg to state_legislative_districts and the structure changed from a flat list to a dict with house/senate keys containing legislator info. The library now handles both formats.

Upgrade

pip install --upgrade geocodio-library-python

Full Changelog: v0.5.0...v0.5.1

v0.5.0 - Distance API Support

What's New

This release adds full support for the Geocodio Distance API, enabling distance calculations between geographic coordinates.

New Features

• Distance API methods:

  • distance() - Calculate distances from a single origin to multiple destinations
  • distance_matrix() - Calculate distances from multiple origins to multiple destinations
  • Support for straightline (haversine) and driving distance modes
  • Support for miles and km units
  • Optional sorting by distance or duration

• New Coordinate class for representing geographic coordinates with optional IDs

• Distance parameters added to geocode() and reverse() methods for inline distance calculations

• New type definitions: DistanceResponse, DistanceMatrixResponse, DistanceOrigin, DistanceDestination

• New constants: DISTANCE_MODE_STRAIGHTLINE, DISTANCE_MODE_DRIVING, DISTANCE_UNITS_MILES, DISTANCE_UNITS_KM

Example Usage

from geocodio import Geocodio, Coordinate

client = Geocodio(api_key="YOUR_API_KEY")

# Calculate distances from White House to landmarks
response = client.distance(
    origin=Coordinate(38.8977, -77.0365, "white_house"),
    destinations=[
        Coordinate(38.8895, -77.0353, "monument"),
        Coordinate(38.9072, -77.0369, "capitol")
    ],
    mode="straightline",
    units="miles"
)

for dest in response.destinations:
    print(f"{dest.id}: {dest.distance_miles} miles")

Full Changelog: v0.4.0...v0.5.0

v0.4.0

What's Changed

• fix(parser): support nested field structures with backward compatibility by @sylvesterdamgaard in #18

New Contributors

• @sylvesterdamgaard made their first contribution in #18

Full Changelog: v0.3.0...v0.4.0

v0.3.0

What's Changed

Bug Fixes

• Fixed census field appends parsing to dynamically handle all census field types (#13)

Tests

• Added test coverage for census field appends

Full Changelog: v0.2.0...v0.3.0

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