Skip to content

v1.13.0 - Add Distance API support

Choose a tag to compare

@MiniCodeMonkey MiniCodeMonkey released this 06 Jan 11:07
· 11 commits to master since this release

What's New

This release adds comprehensive support for the Geocodio Distance API, enabling distance and duration calculations between locations.

New Features

Distance Calculations

  • distance() - Calculate distances from a single origin to multiple destinations
  • distanceMatrix() - Calculate full distance matrices (multiple origins × multiple destinations)

Async Distance Jobs

  • createDistanceMatrixJob() - Create background jobs for large distance calculations
  • distanceMatrixJobStatus() - Check job processing status
  • distanceMatrixJobs() - List all distance jobs (paginated)
  • getDistanceMatrixJobResults() - Retrieve completed job results
  • downloadDistanceMatrixJob() - Download results to a file
  • deleteDistanceMatrixJob() - Delete a job

Distance with Geocoding

  • Add distance calculations to geocode() and reverse() requests via new distance options

Configuration Options

  • Modes: DistanceMode.Straightline (default), DistanceMode.Driving, DistanceMode.Haversine
  • Units: DistanceUnits.Miles (default), DistanceUnits.Kilometers
  • Filtering: maxResults, maxDistance, minDistance, maxDuration, minDuration
  • Sorting: DistanceOrderBy.Distance, DistanceOrderBy.Duration with DistanceSortOrder.Asc/Desc

New Exports

  • Coordinate class for type-safe coordinate handling
  • DistanceMode, DistanceUnits, DistanceOrderBy, DistanceSortOrder enums

See the README for full documentation and examples.