How to Use Reverse Geocoder - Complete User Guide

Overview

This guide walks you through every feature of the Reverse Geocoder tool, from entering coordinates to exporting results and managing your conversion history.

Before You Start

Make sure you've completed the API Key Setup before attempting your first conversion.

Entering Coordinates

Supported Input Formats

The Reverse Geocoder accepts coordinates in three formats:

Comma-Separated (most common):

40.7128, -74.0060
34.0522, -118.2437
41.8781, -87.6298

Tab-Separated (from Excel):

40.7128    -74.0060
34.0522 -118.2437
41.8781 -87.6298

Space-Separated:

40.7128 -74.0060
34.0522 -118.2437
41.8781 -87.6298

Mixed Formats Work Too

You can mix and match formats in the same batch - our parser handles all three automatically.

Valid Coordinate Ranges

  • Latitude: -90 to 90 (negative = South, positive = North)
  • Longitude: -180 to 180 (negative = West, positive = East)

Coordinates outside these ranges will be rejected with an error message.

Batch Size Limits

TierMax Coordinates per Batch
Trial10
Paid100

Rate Limiting

The tool adds a 100ms delay between API calls to respect Google Maps API rate limits. Large batches (50+) may take 5-10 seconds to complete.

Uploading Files (Paid Tier Only)

Instead of pasting coordinates, you can upload CSV or Excel files containing coordinate columns.

1

Prepare Your File

Your file must have columns labeled lat (or latitude) and lng (or longitude). Other columns are ignored. Supported formats: .csv, .xlsx, .xls
2

Click "Upload CSV/Excel"

Click the Upload CSV/Excel button below the text area and select your file.
3

Review Parsed Coordinates

The tool extracts coordinates from your file and displays them in the text area. Review for accuracy before converting.
4

Convert as Usual

Click Convert to Addresses to process the uploaded coordinates.

Excel Column Names

The parser looks for columns named "lat", "latitude", "lng", or "longitude" (case-insensitive). Make sure your file uses these standard names.

Interpreting Results

After conversion, results appear in a table with the following columns:

ColumnDescriptionExample
**Input Coordinates**Your original lat/lng pair40.7128, -74.0060
**Street Number**Building/house number285
**Street Name**Street name onlyFulton Street
**City**City or localityNew York
**County**County nameNew York County
**State**Full state nameNew York
**State Code**2-letter abbreviationNY
**Postal Code**ZIP or postal code10007
**Country**Full country nameUnited States
**Country Code**2-letter country codeUS
**Place ID**Google Maps Place IDChIJOwg_06VPwokRYv534QaPC8g

Address Component Notes

  • Empty fields mean Google Maps didn't return that component for the location (common for rural areas or oceans)
  • County is only available in some regions (primarily US)
  • Place ID is a unique identifier you can use with other Google Maps APIs

Copy Individual Results

Click the copy icon (📋) next to any row to copy that address to your clipboard. Perfect for pasting into emails or reports.

Exporting Results

CSV Export (Paid Tier Only)

Click the Download CSV button above the results table to export all results to a CSV file. The exported file includes:

  • All 11 address component columns
  • Original input coordinates
  • Timestamp of conversion
  • Compatible with Excel, Google Sheets, and database imports

File name format: reversegeocoderesultsYYYY-MM-DDHHMMSS.csv

Use Cases for CSV Export

  • Import addresses into your fleet management system
  • Merge with existing delivery data in Excel
  • Load into a database for route optimization
  • Archive for compliance documentation

Copy All Results

Click the Copy All button to copy the entire results table to your clipboard as tab-separated text. Paste directly into Excel or Google Sheets.


Conversion History (Paid Tier Only)

All paid users have access to conversion history, which saves every batch you process.

Viewing Past Batches

Scroll to the Conversion History section below the results table. Each saved batch shows:

  • Date & Time of conversion
  • Number of coordinates processed
  • Download CSV button to re-download results

History is paginated - use Previous and Next buttons to navigate through older batches.

Re-Downloading Results

Click the Download CSV button next to any historical batch to download the original results. This is useful for:

  • Recovering results from batches processed weeks/months ago
  • Sharing results with colleagues who need the same data
  • Avoiding re-processing the same coordinates (saves API costs)

History Retention

Conversion history is stored indefinitely as long as your subscription is active. If you cancel, history is retained for 90 days.

Best Practices

For Accurate Results

  1. Use precise coordinates - More decimal places = more accurate results (6+ decimal places recommended)
  2. Verify coordinate order - Always latitude first, longitude second (lat, lng not lng, lat)
  3. Check for typos - A misplaced decimal or negative sign can place you on the wrong continent
  4. Test with known locations - Verify a few familiar addresses to ensure your format is correct

For Efficient Batches

  1. Group by region - Process coordinates from the same area together for faster results
  2. Remove duplicates - Identical coordinates waste API calls and cost you money
  3. Use CSV import for large batches - Faster and less error-prone than manual pasting
  4. Export immediately - Don't rely on browser storage - download CSV right after conversion

For Cost Management (BYOK Users)

  1. Monitor your Google Cloud Console - Set up billing alerts to avoid surprise charges
  2. Reuse your API key across CWT tools - One key works for both Reverse Geocoder and Driving Distance Calculator
  3. Process batches during off-peak hours - Google Maps API pricing doesn't vary by time, but your workflow might benefit from quieter times
  4. Cache results - If you need to reference the same addresses repeatedly, save your CSV exports instead of re-processing

Address Accuracy Varies by Region

Google Maps has excellent coverage in urban areas of North America, Europe, and Asia, but address accuracy may be lower in rural or remote regions. Always verify critical addresses manually.

Troubleshooting

"Invalid coordinates" error

  • Check that latitude is between -90 and 90
  • Check that longitude is between -180 and 180
  • Verify you're using decimal degrees (not degrees/minutes/seconds)

"No results found" for a coordinate

  • The location may be in the middle of an ocean or uninhabited area
  • Google Maps may not have address data for that region
  • Try a slightly different coordinate nearby to see if data exists

CSV export has blank columns

  • Some address components aren't available for all locations (especially county)
  • Rural addresses may only have city/state/country
  • This is expected behavior - use what's available

File upload not working

  • Ensure your file is .csv, .xlsx, or .xls format
  • Verify you have columns named "lat"/"latitude" and "lng"/"longitude"
  • Check that coordinates are in decimal format (not DMS)
  • File size limit is 5MB

Next Steps

Need more help? Contact support@customwebtools.com

Was this article helpful?