A lightweight, user-friendly web application for looking up Polish postal ZIP codes and cities. It supports both single and batch lookups, interactive map visualization, dark/light themes, and bilingual (English/Polish) interfaces.
Use Hosted version: https://jomardyan.github.io/Polish-ZIP-City-Lookup/
- Single Lookup: Convert a ZIP code to its corresponding city (and vice versa).
- Batch Processing: Import CSV or Excel files—or paste multiple entries—to process ZIP ⇄ city conversions in bulk.
- Interactive Map: Visualize lookup results on a Leaflet-powered map, with auto-zoom and markers.
- Theme Toggle: Switch between light and dark modes for comfortable viewing.
- Internationalization: English and Polish language support via Vue I18n.
- A modern web browser (Chrome, Firefox, Edge, Safari).
- (Optional) A simple HTTP server to serve static files (e.g., Live Server extension or
http-servervia npm).
-
Clone the repository:
git clone https://github.com/your-username/zip-city-lookup.git cd zip-city-lookup -
Configure GeoNames API:
-
Obtain a free account from GeoNames.
-
In
index.html(or your main script), replace:const GEONAMES_USERNAME = 'your_username';
with your actual GeoNames username.
-
-
Serve or open:
-
Open
index.htmldirectly in your browser, or -
Run a local server:
npx http-server .
-
- Select the Lookup tab.
- Enter a valid Polish ZIP (e.g.,
00-001or00001) to find its city, or enter a city name (e.g.,Warszawa) to find matching ZIP codes. - Press Enter or click the Lookup button.
- Results appear in a table and on the map.
-
Switch to the Batch tab.
-
Either:
- Import a CSV/Excel file (one ZIP or city per row), or
- Paste multiple entries (one per line).
-
Choose mode: ZIP → City or City → ZIP.
-
Click Process Batch. Results populate the table and map.
-
Export results as CSV/Excel or copy to clipboard.
- Map Initial View: Change the default center and zoom in the
mounted()hook of the Vue instance. - Theme Col
66C9
ors: Edit CSS variables or classes in the
<style>block. - Language Packs: Extend
messagesin the Vue I18n setup for additional languages.
© iCredit Hayk Jomardyan 2025. All rights reserved.
Made with ❤️ for easy postal code and city lookups in Poland.