Back to Docs

Geocoding API

Convert addresses to coordinates and perform reverse geocoding.

Forward Geocoding

Convert a human-readable address into geographic coordinates (latitude and longitude).

POST /api/v1/geocode
{
  "address": "1600 Pennsylvania Avenue NW, Washington, DC"
}

// Response
{
  "lat": 38.8977,
  "lng": -77.0365,
  "formatted": "1600 Pennsylvania Avenue NW, Washington, DC 20500"
}

Reverse Geocoding

Convert geographic coordinates into a human-readable address.

POST /api/v1/geocode/reverse
{
  "lat": 38.8977,
  "lng": -77.0365
}

// Response
{
  "address": "1600 Pennsylvania Avenue NW",
  "city": "Washington",
  "state": "DC",
  "country": "United States",
  "postal_code": "20500"
}

Batch Geocoding

Geocode multiple addresses in a single request for efficiency.

POST /api/v1/geocode/batch
{
  "addresses": [
    "New York, NY",
    "Los Angeles, CA",
    "Chicago, IL"
  ]
}