OpenStreetMap Address Geocoder & Reverse Geocoder

Transform addresses into geographic coordinates and vice versa with this powerful geocoding actor powered by OpenStreetMap data.

Features

✨ Forward Geocoding - Convert any address into precise latitude/longitude coordinates 🌍 Reverse Geocoding - Turn coordinates back into human-readable addresses 📦 Batch Processing - Process multiple addresses or coordinates in a single run 🔍 Flexible Search - Use free-form text or structured address components 🎯 OSM Lookups - Get detailed information about specific OpenStreetMap places

Use Cases

• Address Validation - Verify and standardize address formats
• Location Intelligence - Enrich your data with geographic coordinates
• Map Applications - Convert user addresses for map plotting
• Logistics - Calculate routes and distances from address data
• Real Estate - Geocode property listings for mapping
• Research - Analyze geographic distribution of addresses

Input Options

Forward Geocoding (Address → Coordinates)

Free-form Search:

{
  "mode": "forward",
  "query": "Eiffel Tower, Paris, France"
}

Structured Search:

{
  "mode": "forward",
  "street": "1600 Amphitheatre Parkway",
  "city": "Mountain View",
  "state": "California",
  "country": "USA",
  "postalcode": "94043"
}

Batch Processing:

{
  "mode": "forward",
  "addresses": [
    "Times Square, New York, USA",
    "Big Ben, London, UK",
    "Colosseum, Rome, Italy"
  ]
}

Reverse Geocoding (Coordinates → Address)

Single Location:

{
  "mode": "reverse",
  "latitude": 48.8584,
  "longitude": 2.2945
}

Batch Processing:

{
  "mode": "reverse",
  "coordinates": [
    { "lat": 40.7580, "lon": -73.9855 },
    { "lat": 51.5007, "lon": -0.1246 }
  ]
}

OSM Lookup

{
  "mode": "lookup",
  "osmIds": "5013364",
  "osmType": "W"
}

Output Data

Each result includes:

• Coordinates - Precise latitude and longitude
• Display Name - Full formatted address
• Address Components - Country, city, street, postal code, etc.
• Place Information - OSM type, place ID, category
• Bounding Box - Geographic boundaries of the location
• Importance Score - Relevance ranking

Configuration

Parameter	Description	Example
mode	Operation type: forward, reverse, or lookup	"forward"
query	Free-form address search	"Central Park, NYC"
street	Street address (structured)	"5th Avenue"
city	City name (structured)	"New York"
state	State/province (structured)	"New York"
country	Country name or code (structured)	"USA"
postalcode	ZIP/postal code (structured)	"10001"
countrycodes	Filter by country codes	"us,gb,fr"
limit	Maximum results (1-40)	10
latitude	Latitude for reverse geocoding	40.7128
longitude	Longitude for reverse geocoding	-74.0060
zoom	Detail level (0-18)	18
addresses	Array of addresses for batch processing	["addr1", "addr2"]
coordinates	Array of coordinates for batch processing	[{"lat": 40, "lon": -74}]

Tips for Best Results

1. Be Specific - Include as much detail as possible (city, country, etc.)
2. Use Structured Search - For more accurate results, use individual address fields
3. Country Codes - Filter results by country to improve accuracy
4. Batch Processing - Process up to hundreds of addresses efficiently
5. Rate Limiting - Built-in delays ensure reliable operation

Data Source

This actor uses OpenStreetMap's Nominatim service, which provides geocoding based on OpenStreetMap data contributed by millions of mappers worldwide. Results are continuously updated as the map is improved.

Getting Started

1. Select your geocoding mode (forward, reverse, or lookup)
2. Enter your address or coordinates
3. Configure optional parameters
4. Run the actor and download your results

Perfect for developers, data analysts, researchers, and anyone working with location data!