🌍 Geocoder – Fast & Reliable Geocoding API for Place Name Lookup

Geocoder is a lightweight and cost-effective 🧭 geocoding tool built for developers, data teams, and automation workflows. This actor lets you turn place names into structured location data using a clean and powerful Geocoding API — perfect for mapping, location enrichment, spatial analysis, and more.

---

🚀 Features

✅ Converts place names or addresses into latitude/longitude
✅ Supports bulk geocoding (batch of up to 100 places)
✅ Fast ⚡️ parallel processing
✅ Clean, normalized output with lat, lng, state, country, and formatted_address
✅ Works with both single and multi-line input
✅ Affordable & efficient (no headless browser!)

---

🔍 Input Parameters

This actor supports two types of geocoding queries:

1. place (Single query)

A string representing a single address, landmark, or place name to geocode.

1{
2  "place": "Eiffel Tower, Paris"
3}

2. places (Bulk query)

An array of place names or addresses. Submit up to 100 places in one run.

1{
2  "places": [
3    "45 Wall St, New York",
4    "Shibuya Crossing, Tokyo, Japan",
5    "1600 Amphitheatre Parkway, Mountain View, CA",
6    "10 Downing St, London, UK"
7  ]
8}

📌 Note: If both place and places are left empty, the actor will default to:
"45 Wall St, New York"

---

⚙️ How It Works

1. Input a single place or a list of places
2. The actor sends each query to an external geocoding API
3. It runs in parallel to ensure fast results
4. Normalized results are pushed to the Apify dataset

---

📦 Output Example

Here’s an example of the geocoded result:

1{
2  "query": "45 Wall St, New York",
3  "state": "New York, NY",
4  "country": "US",
5  "formatted_address": "45 Wall Street, New York, NY",
6  "lat": 40.706416,
7  "lng": -74.0098576
8}

🔎 Field Breakdown

Field	Description
query	The original query string you submitted
state	The detected state or region
country	The country in ISO 2-letter format
formatted_address	A standardized version of the address
lat	Latitude coordinate of the location
lng	Longitude coordinate of the location

---

🛠️ Getting Started

1. Go to the Geocoder actor on Apify
2. Enter your query:
   • Either a single place (place) or a list of places (places)
3. Run the actor
4. View the results in the Dataset tab

---

🗺️ Use Cases

• Enrich business data with location coordinates
• Map user input or delivery addresses
• Geo-tag photos, events, or assets
• Run bulk geocoding for analytics
• Power location-based features in apps

---

❤️ Why Geocoder?

• Simple to use, even for non-coders
• Fast thanks to async and parallel execution
• Flexible for both small and large batches
• Human-friendly output ready for mapping, Excel, or your database
• No browser overhead = cheaper runs

---

Give it a spin — and turn your place names into precision data. 🌐
Questions or ideas? Let us know 💬

---