This project is a sub-component of phzipweb i.e. a public REST API that supplies data for states, provinces, cities and zip codes. Current version only supports US and Philippine data. Future release will also include full-text search.
As an individual component it can already be used by applications to populate drop down of states, provinces, counties, cities, phone area codes, and zip codes without relying on the database.
This component contains JSON files with hierarchical representation of featured country, provinces and cities. As such, the only dependency it has is gson that is used to deserialize JSON data file to serve clients.
Supports JDK 1.8 or higher.
<dependencies> ... <!-- To use core API --> <dependency> <groupId>io.dhilar.phzip</groupId> <artifactId>phzip-core</artifactId> <version>0.2.0</version> </dependency> <!-- To use search API --> <dependency> <groupId>io.dhilar.phzip</groupId> <artifactId>phzip-search</artifactId> <version>0.2.0</version> </dependency> <!-- To use console app --> <dependency> <groupId>io.dhilar.phzip</groupId> <artifactId>phzip-console</artifactId> <version>0.2.0</version> </dependency> ... </dependencies>
Download jars at Central Maven repository. Choose fat jar if you don't want to download individual dependencies.
Sample use case of loading data from PhZip to populate drop-down of provinces, states, counties, cities, zip codes, etc. in order to eliminate the tasks of creating your own lookup tables data and internal APIs of these known fix values.
Retrieval of customer information and loading of province data using province Id.
- Project Information
- PhZip Core Javadoc
- PhZip Search Javadoc
- PhZip Core Release Notes
- PhZip Search Release Notes