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: json { "mode": "forward", "query": "Eiffel Tower, Paris, France" } Structured Search: json { "mode": "forward", "street": "1600 Amphitheatre Parkway", "city": "Mountain View", "state": "California", "country": "USA", "postalcode": "94043" } Batch Processing: json { "mode": "forward", "addresses": [ "Times Square, New York, USA", "Big Ben, London, UK", "Colosseum, Rome, Italy" ] } ### Reverse Geocoding (Coordinates → Address) Single Location: json { "mode": "reverse", "latitude": 48.8584, "longitude": 2.2945 } Batch Processing: json { "mode": "reverse", "coordinates": [ { "lat": 40.7580, "lon": -73.9855 }, { "lat": 51.5007, "lon": -0.1246 } ] } ### OSM Lookup json { "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!