geodist - Distance Calculator

Calculate the geodesic distance between two addresses or from your current location.

Quick Start

geodist "Los Angeles" "San Francisco"
geodist --here "Micro Center, Tustin CA"
geodist --km "Paris, France" "London, UK"

Usage

geodist "location1" "location2"
geodist --here "destination"
geodist --km "loc1" "loc2"

Options

Option Description

--here

Use current IP-based location as origin

--km

Show distance in kilometers (default: miles)

-v

Verbose output with coordinates

Examples

Between Two Locations

geodist "Los Angeles, CA" "San Francisco, CA"
Output
347.4 miles

From Current Location

geodist --here "Micro Center, Tustin"
Output
12.3 miles

Verbose Output

geodist -v "LAX Airport" "SFO Airport"
Output
From: Los Angeles International Airport, 1 World Way, Los Angeles, CA 90045
      (33.942536, -118.408075)
To:   San Francisco International Airport, San Francisco, CA 94128
      (37.621313, -122.378955)

337.2 miles

Metric Units

geodist --km "Tokyo, Japan" "Seoul, South Korea"
Output
1159.4 km

How It Works

  1. Geocoding: Converts addresses to coordinates using OpenStreetMap’s Nominatim

  2. IP Location: When using --here, determines your location via ipinfo.io

  3. Distance: Calculates geodesic (great-circle) distance accounting for Earth’s curvature

Dependencies

Managed via PEP 723 inline metadata:

# /// script
# requires-python = ">=3.11"
# dependencies = ["geopy"]
# ///

Source

Located at bin/geodist in domus-python repository.